Create an account. Reuse idempotency_key safely when retrying the same mutation.

List all paper accounts and their cash balances.

Check all pending limit orders against current prices and fill any that crossed.

List open positions (symbol, side, qty, avg cost, asset class) for an account.

List paginated order history, including source agent and idempotency key.

Mark-to-market P&L report for an account: positions, unrealized P&L, cash, total equity.

Rename a paper portfolio. Updates positions, orders, history, and the default pointer.

One-line-per-portfolio snapshot for all accounts: cash, equity, unrealized P&L, position count. Fast overview for deciding which account to act on.

Portfolio performance since inception: return, CAGR, Sharpe, Sortino, volatility, max drawdown. Reconstructs a daily equity curve from the trade/cashflow ledger and real historical prices.

Backtest the account's current open positions and cash with backtesting.py.

The universe is read from this account's SQLite positions, options without reliable continuous history are reported as skipped, and results include the equity curve, return, CAGR, volatility, Sharpe, Sortino, and drawdown. The default window is five years; request up to 36500 calendar days. This is a current-holdings retrospective, not an out-of-sample strategy test.

Buy an option. expiry is YYYY-MM-DD, kind is 'C' or 'P', contracts x100 shares. Market order unless limit (premium) is given. Use option_chain to find valid expiries/strikes.

Sell/write an option (opens a short if not covering). Same params as buy_option.

List option expiries for an underlying, or near-the-money strikes for one expiry (YYYY-MM-DD).

List supported futures symbols with their contract multiplier and initial margin.

Set the default portfolio used by the CLI and dashboard when no account is specified.

Holiday/early-close-aware NYSE status and next open/close time.

Cancel one pending order by id; canonical counterpart to order_cancel_all.

Add cash to a paper account.

Remove cash from a paper account (fails if it would go negative).

Return the account used when CLI/TUI calls omit an explicit account.

Account balances, configured risk limits, and open-position count.

Dry-run an order against cash, margin, short, naked-option, and leverage limits.

Show the account's shorting, naked-option, leverage, and order-size limits.

Change selected account risk limits; omitted fields retain their current values.

Search Yahoo Finance for matching symbols, asset types, and exchanges.

Validate a symbol and return its live price, class, multiplier, and margin.

Fetch up to 50 comma-separated live symbols concurrently.

Check SQLite integrity, WAL mode, schema version, and core record counts.

Create a consistent online backup under ~/.papertrade_backups.

List all config keys.

Get a config value.

Set a config value.

Delete a config key.

Poll unified audit/order events since an id. For agents to replace polling with incremental sync.

Poll live quotes N times at an interval; returns list of snapshots for a simple stream without WebSocket.

Paginated mutation audit trail with agent and idempotency attribution.

Submit market, limit, stop, stop-limit, trailing, bracket, OCO, or OTO orders.

Get one order by numeric id or by account plus client order id.

Replace selected fields on a pending order and return the new order id.

Cancel every pending/held order, optionally restricted to one account.

Get one live-marked position with market value and unrealized P&L.

Close all or part of one position by quantity or percentage.

Liquidate every open position in an account at current market prices.

Parse and quote one OCC option contract.

Create a persistent named watchlist with comma-separated symbols.

List an account's persistent watchlists.

Get one named watchlist or numeric watchlist id.

Add a symbol to a persistent watchlist.

Remove a symbol from a persistent watchlist.

Delete a persistent watchlist.

Return live quotes for every symbol saved in a watchlist.

List NYSE sessions, including holidays and early closes.

Unified account fills, orders, transfers, dividends, splits, and option events.

Historical OHLCV bars from Yahoo Finance.

Latest bid, ask, and last indication.

Combined latest quote, daily bar, previous close, and change.

Recent symbol news headlines and links.

Current most-active equity screener.

Current day gainers and losers.

Describe the active catalog, response contract, profiles, and legacy aliases.