CTP 直连数据

CTP 直连数据适合那些需要把期货行情、交易指令和账户状态从经纪商接口拿进自己工程体系的场景。很多量化项目不只是要一个能连上 CTP 的脚本，而是要同时处理行情订阅、委托回报、持仓资金、数据落盘和实时分发，尤其是 SimNow 测试与实盘穿透式环境之间的配置差异，容易在联调时反复踩坑。

它解决什么问题

这个技能把 CTP 接口封装为可复用的数据与交易连接器：行情侧覆盖 Tick、深度行情和 K 线；交易侧覆盖下单、撤单、查委托、查成交、查持仓和查资金；输出侧支持 CSV/JSON 文件、数据库存储，以及 ZeroMQ、WebSocket 实时推送。对于策略开发，它更像一个本地数据管道，而不是孤立的 API 调用。

技能如何工作

核心能力由几个模块组成：CTPMarketData 负责行情接口，CTPTrader 负责交易接口，数据模型统一承载返回结构。配置通过 config/ctp_config.yaml 与环境变量共同完成，敏感字段建议用 ${ENV_VAR} 注入，避免明文密码和 auth_code。运行路径通常是：登录行情/交易前置，订阅合约，接收回报，再把数据写入存储或推送给下游服务。对回测场景，行情落盘后可直接作为历史数据输入；对实时场景，ZeroMQ/WebSocket 能把数据分发给策略、监控或可视化模块。

适用边界与注意点

它适合 SimNow 仿真环境和用户自己的实盘账户，不适合绕过期货公司权限或进行未授权交易。实盘使用前需要确认 app_id、auth_code、broker_id 和前置地址，并完成穿透式认证。连接失败时通常要检查网络连通性、账户密码、交易时段、合约代码大小写以及登录状态。若用于生产环境，应重视日志脱敏、.env 版本控制、依赖版本固定和存储权限控制。