用途：在实盘前验证策略、试验下单数量与时机、无风险演示 cdcx，或对代理的交易行为做回归测试。该功能仅提供 CLI，不提供 MCP 工具，需要模拟盘交易的代理必须直接 shell 调用 cdcx paper。
引擎：模拟引擎在本地运行，订单状态不调用 API，只有市价来自 API。状态保存在 ~/.local/share/cdcx/paper/paper_account.json。成交使用订单被评估时从 REST API 获取的实时标记价格：MARKET 订单按当前 ticker 价格立即成交；LIMIT 订单挂单，待市场穿越限价时成交。
主要命令：cdcx paper init --balance <n> 新建模拟账户（默认 10000 USDT）；cdcx paper buy <INSTRUMENT> --quantity <q> [--price <p>] 买入（无价格则市价）；cdcx paper sell <INSTRUMENT> --quantity <q> [--price <p>] 卖出；cdcx paper positions 查看持仓与未实现盈亏；cdcx paper balance 查看现金余额与已实现盈亏；cdcx paper history 查看成交记录；cdcx paper reset --balance <n> 清空状态重新开始。所有命令支持 -o json、-o table、-o ndjson。
使用方式：先执行 cdcx paper init --balance 50000 与 cdcx paper balance -o json 初始化；市价往返可用 cdcx market ticker BTC_USDT -o json 查价，再 cdcx paper buy BTC_USDT --quantity 0.01 -o json，用 cdcx paper positions -o json 查看持仓，cdcx paper sell BTC_USDT --quantity 0.01 -o json 平仓，盈亏体现在 balance。限价耐心入场用 cdcx paper buy BTC_USDT --quantity 0.1 --price 49000 -o json，挂单在引擎中等待 ticker 穿越 49000，未成交前资金被预留。策略回测循环：init 后由外部脚本或代理读取 cdcx market ticker/candlestick 信号，调用 paper buy 或 sell，再经 positions -o json 跟踪盈亏，最后用 history 与 balance 复盘，每次运行之间用 reset 重置。
限制与注意：模拟状态在多次 cdcx 调用间持久保存，需用 reset 重新开始；默认不扣除手续费，如需真实感需在策略中自行加入；实时流式 ticker 未接入模拟引擎，订单只在后续 cdcx paper 调用时按当时的 REST ticker 评估成交；交互式模拟体验可用 cdcx tui 并按 p 切换 LIVE/PAPER 模式。资料未说明具体费率、费用模型及其他平台支持情况。