Paper trading

Live order book, simulated fills, real PnL on paper. The last step before you risk a cent.

Starting a run

From the dashboard click Run on a saved strategy and pick Paper. From Telegram, use `/start_paper <strategy> [symbol] [tf] [cash] <pin>`. The bot replies with a run ID; that ID is also visible on the Runs page.

What happens

The engine streams live candles from the venue you chose, evaluates your rules on each bar close, and simulates fills at the next bar's open with realistic slippage. Every fill, equity update, and risk event is logged to the run's database row.

Monitoring

/equity — current paper equity, peak, drawdown.
/positions — open positions with unrealised PnL.
/runs — list recent runs across all strategies.
/run <id> — one run's full details, ledger, and equity curve.
/pulse — BTC ticker + funding (sanity check that the bot is alive).

Switching to live

When OOS-robust and paper-validated over a couple of weeks, swap the run type from Paper to Live and provide your exchange API keys (read + trade, never withdraw). Live runs use the same rule engine — only the order-routing path differs.