Documentation
7. AI and Paper Trading
- Created
- Aug 29, 2026
- Updated
- Sep 1, 2026
The AI assistant can read your paper-trading accounts and answer questions about them — and, with your approval, place or manage simulated orders. Everything it sees is the same simulated data shown in the Account Manager; nothing here involves real money.
What the assistant knows without asking
While the chat drawer is open, the assistant's context carries a short summary of the selected paper account: balance, equity, open and realized P&L, how many positions and working orders there are, your position on the active symbol (side, size, average price, P&L, brackets), the other accounts by name, whether a replay is running, and whether one-click trading is on. Quick questions — "How is my account doing?", "Am I long BTC?" — are answered from this summary.
What it can look up
For detail the assistant calls read tools, which run immediately:
| Tool | Returns |
|---|---|
get_paper_account | Account summary; optionally the broker settings and the list of all accounts — the live account, replay sessions, and archived pre-reset records |
get_paper_positions | Open positions with mark, P&L, brackets, holding time, and an open-risk block: notional, distance to stop and target, loss if the stop fills, reward:risk, and an unprotected flag |
get_paper_orders | Working orders (with brackets), or order history |
get_paper_trades | Fills and closed trades, newest first, filterable by symbol and time window, paged |
get_paper_performance | Statistics with the Strategy Tester's definitions, an equity curve, and breakdowns by symbol, long/short, weekday, hour of day, and holding time, plus streaks, MFE/MAE excursions, and risk ratios |
get_paper_journal | The account journal |
Every tool accepts an accountId, so you can ask about a finished session by name — "How did the MGC replay go?" — and the assistant reads that archived record. Aggregates come from the app's own calculations, not from the model adding up rows, so figures match the Account Summary tab. Times are reported in your time zone; while a replay runs, "now" means the replayed bar's time.
Questions that work well:
- Why is my P&L down this week? — trades in the window plus breakdowns and streaks.
- Am I better at longs or shorts? At what time of day? — side and hour breakdowns.
- Do I have any unprotected positions? What do I lose if every stop fills? — the open-risk block.
- Compare my paper results on BTC with the strategy I backtested. — paper performance for the symbol next to
get_backtest_results.
What it can propose
Like every other assistant action, paper orders are proposals that appear as action cards; nothing happens until you click Apply:
| Tool | Proposes |
|---|---|
place_paper_order | A market, limit, stop, or stop-limit order with optional take-profit / stop-loss brackets and a duration |
modify_paper_order | New quantity, prices, or brackets on a working order |
cancel_paper_order | Cancelling one order, or all working orders on a symbol |
close_paper_position | Closing a position at market, fully or partially |
set_paper_brackets | New or removed take-profit / stop-loss levels on an open position |
Each action card carries a volatile, single-use approval that expires after 60 seconds and is bound to the exact action JSON, account, relevant account/settings/order revision, and executable quote. Apply consumes it before asynchronous execution; changing state or quotes, clicking twice, waiting too long, or restoring a card from history requires a fresh proposal. On Apply the action runs through the same broker as the ticket and is refused with the usual message when the account is archived, the live account is selected during replay, or the instrument is untradable. One-click trading never bypasses the approval card. AI-originated orders, executions, and journal entries carry ai Origin. The assistant cannot reset, delete, or reconfigure accounts.
Privacy
Account data is sent to your AI provider only when you send a message, in the same way chart data already is: the compact summary in the context, and whatever a read tool returns. Server-proxied providers (Bedrock, Vertex) receive a capped snapshot — the selected account's newest 150 fills and 150 closed trades (plus 60 final orders and 60 journal entries) and summaries of the others. Account summaries always carry the full counts of trades and working orders, and answers built from a capped ledger say so (ledgersTruncated). Turn the whole surface off with Trading properties → Share paper trading with the AI assistant; the tools then answer that access is disabled and the context carries no account data. Persisted conversation history removes attachment names/content and replayable action payloads, so reopening a conversation cannot recreate an approval.
Next steps
That completes the Paper Trading guide. Read what shipped in the release that introduced it.
Next: v0.12.0 — Paper trading