Welcome to Botmarley
Botmarley is a self-hosted, sovereign cryptocurrency trading bot built in Rust. It runs entirely on your own hardware, giving you full control over your trading strategies, API keys, and market data. No cloud services, no third-party access to your funds, no monthly subscriptions.
You install it, you run it, you own it.
Botmarley supports Kraken and Binance exchanges. It automatically detects which exchange to use based on your account type and trading pair.
What Botmarley Does
At its core, Botmarley automates cryptocurrency trading based on rules you define. You write a strategy that says things like "buy BTC when RSI drops below 30" or "sell 50% of my position when price rises 5% from entry," and Botmarley executes those rules 24/7 without you needing to watch charts.
Here is how the pieces fit together:
graph LR
Browser["Browser<br/>(Web Interface)"]
Bot["Botmarley<br/>(Trading Bot)"]
PG["PostgreSQL<br/>(Your Data)"]
Exchange["Exchange API<br/>(Kraken / Binance)"]
Browser <-->|"http://localhost:3000"| Bot
Bot <-->|"State & Logs"| PG
Bot <-->|"Market Data & Orders"| Exchange
- Browser -- You interact with Botmarley through a web interface at
http://localhost:3000. Pages update in real time as your bot trades. - Botmarley -- A blazing-fast trading engine built in Rust with Tokio and Axum. Handles strategy execution, order placement, data fetching, and serves a reactive web interface powered by HTMX.
- PostgreSQL -- Stores your accounts, trading sessions, backtest results, PnL history, activity logs, and configuration.
- Exchange API -- Botmarley connects to Kraken and Binance to fetch market data and place orders on your behalf.
Key Features
| Feature | Description |
|---|---|
| Dashboard | At-a-glance overview of active sessions, total PnL, and quick navigation to key areas. |
| Strategy Editor | Visual builder and raw TOML editor for defining trading rules. Real-time validation as you build. |
| Backtesting | Test strategies against historical data before risking real money. See PnL, trade count, win rate, and individual actions on a chart. |
| Live Trading | Execute strategies in real-time on Kraken and Binance. Start, pause, resume, and stop sessions. Live-updating charts with trade markers. |
| Accounts | Manage exchange API keys and paper (simulated) accounts. Each account is isolated. |
| Portfolio | Track total portfolio value over time in USD and BTC, with asset breakdowns per account. |
| Market Data | Download, browse, chart, and analyze historical candle data. Run indicators on stored data. |
| History Sync | Fetch historical 1-minute candles from your exchange. Derived timeframes (5m, 15m, 1h) are calculated locally. |
| Task Queue | Background job system for long-running operations like data sync and bulk backtests. |
| Activity Logs | Detailed log of every action the bot takes, filterable by category (strategy, trading, backtest, account, data, system). |
| Settings | Configure server host/port, storage paths, active trading pairs, Telegram notifications, password protection, and UI themes. |
Who This Manual Is For
This manual is for cryptocurrency traders -- both beginners exploring automated trading for the first time and experienced traders who want full control over their bot.
- If you are new to trading bots, start with the Getting Started section. It walks you through installation, your first run, and a tour of every page.
- If you want to jump straight into building strategies, head to Strategies.
- If you are deploying Botmarley on a server, see Deployment.
You do not need any programming knowledge to use Botmarley. Strategies are defined in TOML files (a simple configuration format), and everything else is done through the web interface.
How to Use This Manual
The sidebar on the left organizes content into sections:
- Getting Started -- Installation, first run walkthrough, and a tour of the interface.
- Features -- Deep dives into each major feature: Dashboard, Accounts, Strategies, Backtesting, Live Trading, and Market Data.
- System -- Settings, task queue, activity logs, authentication, and Telegram integration.
- Deployment -- Running Botmarley locally and in production environments.
- Reference -- Strategy TOML specification, indicator reference, and glossary.
Use the search bar at the top to find specific topics. Each page is self-contained, so you can read them in any order.