Paper Trading

When to Use

• Validate a strategy before going live
• Experiment with order sizing and timing
• Teach/demo cdcx without risking funds
• Regression-test an agent's trading behaviour

CLI-only. Paper trading has no MCP tools — agents that need to paper trade must shell out to cdcx paper directly.

Engine

The paper engine is local (no API calls for order state — only for market prices). State lives in ~/.local/share/cdcx/paper/paper_account.json.

Fills use live mark prices fetched from the REST API at the moment the order is evaluated:

• MARKET orders fill immediately at the current ticker price
• LIMIT orders sit and fill when the market crosses the limit