SuperAPI AI 工具集

a-share-paper-trading

通用与其它

查看项目

更新于 10-16 09:34

技能介绍

用途:面向A股的模拟盘交易与回测技能,交易服务、CLI、账户、撮合与行情适配均在本目录内,不依赖其他技能脚本。适用场景包括启动或检查模拟盘服务、创建与重置账户、限价和市价买卖、撤单、查询账户持仓订单成交、验证涨跌停/T+1/收盘过期逻辑,以及运行简单回测。

主要能力:支持创建多账户、设定现金、入金出金、限价单与市价单、撤单、按状态查询订单、查看持仓与成交、定时撮合与净值快照,并可在交易时段自动撮合、非交易时段停止、收盘后让当日未成单过期。默认仅支持A股long-only;买入数量须为100股整数倍;卖出遵守T+1;限价单须符合0.01元最小报价单位;主板普通股涨跌幅10%、创业板科创板20%、主板ST 5%;触及涨停默认买不进、跌停默认卖不出;市价单仅在连续竞价时段接受;集合竞价与午休不自动撮合;行情时间戳非当日视为陈旧不执行市价成交;费用含最低佣金、卖出印花税与沪市过户费。

使用方式:推荐用控制脚本常驻运行,如 python3 "$SKILL_DIR/scripts/paper_trading_ctl.py" start / status / stop;也可直接启动服务 python3 "$SKILL_DIR/scripts/paper_trading_service.py" --host 127.0.0.1 --port 18765。CLI 默认基址与端口一致,常用命令如 create-account alpha --cash 500000、buy alpha 600519 100 --market、sell alpha 600519 100 --price 1450、positions alpha、orders alpha、cancel <order_id>、backtest 600519 --strategy sma_cross --start 2025-01-01 --end 2026-03-31 --cash 200000。下单前应确认账户路由、资金与未完成单;多账户且用户未指定时应先反问,仅一个账户则默认使用,存在默认账户优先使用;首次创建账户前须确认初始资金,未提供时建议默认100w并征得确认。可用参数包括 --host、--port、--db-path、--match-interval、--valuation-interval、--idle-valuation-interval。

限制:同一端口已有模拟盘进程时不可再启动第二个实例,否则报 Address already in use,且多进程可能争用同一SQLite库文件。常见错误还包括 default account not set、insufficient available cash、insufficient sellable qty、order is not open、market orders are only accepted during trading hours,需按提示调整或等待交易时段。更多细节与官方项目地址为 https://github.com/shouldnotappearcalm/a-share-skill。