openctp CTPAPI 兼容接口与 7x24 模拟环境从 0 到 1 上手教程

openctp CTPAPI 兼容接口与 7x24 模拟环境从 0 到 1 上手教程

【免费下载链接】openctpopenctp提供CTP股票期权、中泰证券XTP、华鑫证券奇点TORA、东方证券OST、东方财富证券EMT、盈透证券TWS、易盛TAP、量投QDP等各通道的CTPAPI兼容接口，CTP程序可以无缝对接各股票柜台。openctp也提供了一套基于TTS交易系统的模拟环境，同样提供了CTPAPI兼容接口，不仅支持国内期货与期权全品种，也支持A股股票、基金、债券以及股票期权模拟交易，可以替代Simnow，为CTP量化交易开发者提供7x24可用的模拟环境。项目地址: https://gitcode.com/GitHub_Trending/op/openctp

如果你写过 CTP 量化程序，又被 SimNow 只在工作日开放的时间限制卡住，openctp 值得花半小时跑一遍：它给各柜台提供 CTPAPI 兼容接口，并内置一套全天可用的模拟环境，期货、期权、A 股股票、基金、债券都能模拟交易，适合用 CTP 接口做策略开发和联调的新手。

📌 项目速览：openctp 能做什么

本节交代 openctp 的定位、能力范围和边界，避免你把模拟环境当实盘柜台用。

• 一套 CTPAPI 兼容接口：XTP、TORA、EMT、OST、IB、FEMAS、TAP、QDP 等 14 个柜台目录（见 TTS-CTPAPI 等），CTP 程序只需替换同版本 dll/so 即可接入。
• 三套模拟环境：7x24 环境、仿真环境、VIP 仿真环境，7x24 环境循环回放最近一个交易日行情，全天可用。
• 多语言接口：C++ 接口加上 Python、Java、Go、C、Rust、C# 封装，本教程只走 Python 路线。

🧰 准备工作：环境依赖一览

本节列出跑通示例前需要装好的依赖，全部为软件，无需申请服务器。

🚀 从安装到第一次运行

本节按「克隆 → 装依赖 → 跑示例」三步走，每步都给出最小可运行验证。

克隆仓库，仓库内有示例和文档，先看清结构再动手。

git clone https://gitcode.com/GitHub_Trending/op/openctp

装 CTPAPI 的 Python 接口，装完就能 import，无需编译。

pip install openctp-ctp==6.3.15.* -i https://pypi.tuna.tsinghua.edu.cn/simple --trusted-host=pypi.tuna.tsinghua.edu.cn

跑官方行情 demo，第一次连接 7x24 环境验证链路是否通。

cd openctp/ctpapi-python/demo python md_demo.py

终端输出OnFrontConnected，随后Login succeed，最后打印订阅确认，说明行情链路已通。demo 源码在 ctpapi-python/demo/md_demo.py，连接的前置地址写死在文件末尾一行，换成你自己的环境地址即可。最小订阅逻辑只有三步：RegisterFront注册前置、ReqUserLogin登录、SubscribeMarketData订阅合约。

💻 完整实战案例：认证、登录到下单

本节写一个最小交易程序，走完「认证 → 登录 → 确认结算单 → 查询 → 报单」全流程，对着 td_demo.py 逐段解释。

# mycase.py —— 保存后运行：python mycase.py import threading from openctp_ctp import thosttraderapi as tdapi sem = threading.Semaphore(0) class MyTd(tdapi.CThostFtdcTraderSpi): def __init__(self): super().__init__() self.api = tdapi.CThostFtdcTraderApi.CreateFtdcTraderApi() self.api.RegisterSpi(self) self.api.RegisterFront("tcp://121.37.80.177:20002") # openctp 7x24 交易前置 self.api.SubscribePrivateTopic(tdapi.THOST_TERT_QUICK) self.api.SubscribePublicTopic(tdapi.THOST_TERT_QUICK) self.api.Init() def OnFrontConnected(self): # 7x24 环境不做认证，直接登录；接实盘柜台时需先发 ReqAuthenticate req = tdapi.CThostFtdcReqUserLoginField() req.BrokerID = "" req.UserID = "000001" # 换成你注册的模拟账号 req.Password = "888888" # 默认共享密码，可自行修改 self.api.ReqUserLogin(req, 0) def OnRspUserLogin(self, pRspUserLogin, pRspInfo, nRequestID, bIsLast): if pRspInfo and pRspInfo.ErrorID != 0: print("Login failed:", pRspInfo.ErrorMsg) return print("Login succeed. TradingDay:", pRspUserLogin.TradingDay) # 确认结算单后才能报单，回调里发下一条请求 req = tdapi.CThostFtdcSettlementInfoConfirmField() req.BrokerID = "" req.InvestorID = "000001" self.api.ReqSettlementInfoConfirm(req, 0) def OnRspSettlementInfoConfirm(self, pField, pRspInfo, nRequestID, bIsLast): print("Settlement confirmed") req = tdapi.CThostFtdcQryTradingAccountField() req.BrokerID = "" req.InvestorID = "000001" self.api.ReqQryTradingAccount(req, 0) def OnRspQryTradingAccount(self, pAcct, pRspInfo, nRequestID, bIsLast): if pAcct: print("Available:", pAcct.Available, "Balance:", pAcct.Balance) if bIsLast: self.insert_order() sem.release() def OnRtnOrder(self, pOrder): print("Order:", pOrder.OrderSysID, pOrder.OrderStatus) def OnRtnTrade(self, pTrade): print("Trade:", pTrade.InstrumentID, pTrade.Price, pTrade.Volume) def insert_order(self): req = tdapi.CThostFtdcInputOrderField() req.BrokerID = "" req.UserID = "000001" req.InvestorID = "000001" req.ExchangeID = "SHFE" req.InstrumentID = "au2406" req.Direction = tdapi.THOST_FTDC_D_Buy req.CombOffsetFlag = tdapi.THOST_FTDC_OF_Open req.CombHedgeFlag = tdapi.THOST_FTDC_HF_Speculation req.OrderPriceType = tdapi.THOST_FTDC_OPT_LimitPrice req.LimitPrice = 10.0 req.VolumeTotalOriginal = 1 req.TimeCondition = tdapi.THOST_FTDC_TC_GFD req.VolumeCondition = tdapi.THOST_FTDC_VC_AnyVolume req.OrderRef = "1" req.ContingentCondition = tdapi.THOST_FTDC_CC_Immediately req.ForceCloseReason = tdapi.THOST_FTDC_FCC_NotForceClose self.api.ReqOrderInsert(req, 0) td = MyTd() sem.acquire() print("All done, press enter to exit") input()

关键逻辑：回调串起来的是整条链路。OnFrontConnected里登录，OnRspUserLogin里确认结算单，OnRspSettlementInfoConfirm里查资金，查询结果回调OnRspQryTradingAccount的最后一条（bIsLast为 True）才报单。查询类回调一次查询会分多批返回，必须靠bIsLast判断收尾，demo 里用threading.Semaphore配合acquire等待，这是 CTP 回调编程的标准写法。报单字段中OrderRef必须传字符串、从 1 开始逐单递增；OnRtnOrder和OnRtnTrade分别接收订单回报和成交回报，策略逻辑一般挂在这两个回调上。账号密码以 TTS-CTPAPI 中 7x24 环境说明为准，仿真环境前置为tcp://121.37.90.193:20002。

⚠️ 避坑与调优：连接失败怎么排查

本节汇总新手最常踩的 5 个问题，按「现象 → 原因 → 做法」处理。

1. 现象：程序一直不回调OnFrontConnected。原因：前置地址写错，或防火墙拦了 20002/20004 端口。做法：对照 TTS-CTPAPI 的地址表核对，用telnet 121.37.80.177 20002测端口连通性，再放行防火墙。
2. 现象：Login failed，错误信息提示密码或账号错误。原因：7x24 环境 BrokerID、AppID、AuthCode 均为空，你却填了实盘柜台值；或账号密码不匹配。做法：把三个字段清空重登，确认模拟账号与密码是否被修改过（同一微信注册的账号共享一个密码）。
3. 现象：查询接口只打印部分数据就卡住，程序提前退出。原因：查询结果分批返回，未判断bIsLast。做法：在每个OnRspQryXxx回调里用if bIsLast: ...收尾，再发下一条查询，不要发完就 sleep 猜时长。
4. 现象：报单成功但一直没有成交回报。原因：7x24 环境只循环回放最近一个交易日的行情，非交易时段不会即时撮合。做法：看OnRtnOrder里订单状态确认已挂单，验证策略成交链路时改用TEST、BTC、MINUS等支持客户间真实撮合的合约。
5. 现象：重启程序后登录失败，提示 OrderRef 冲突或委托异常。原因：OrderRef未持久化，重启后重复使用旧引用号。做法：OrderRef 按交易日从 1 开始递增，重启前把当日最大值存到本地文件，启动时读出续用。

🔗 相关项目与延伸

本节列出围绕 CTPAPI 的周边工具，按使用场景对号入座。

• VeighNa（vn.py）：Python 量化交易框架，CTP 接口可直接指向 openctp 前置，适合把本文案例升级为完整策略系统。
• ctpbee：C++ 编写的期货 CTP 实盘交易框架，支持 ctp 与 ctp_mini，适合做实盘对接前压测代码结构。
• MT5CTP：让 MT5 客户端直连期货柜台，适合习惯 MT5 终端下单的交易者。
• LocalCTP：无服务端的本地 CTPAPI 兼容嵌入式模拟环境，支持回测与结算单，适合离线单元测试。
• CTP 官方 SimNow：上期技术官方模拟环境，适合按标准流程验收接口后再迁到 openctp 全天调试。

下一步：把上面的mycase.py换成你自己的模拟账号跑通一遍，再用 tools/ctpcommand 命令行工具核对同一账号的资金、持仓与订单是否一致，然后去 docs/ 找 CTP 客户端开发指南对照 API 细节。

【免费下载链接】openctpopenctp提供CTP股票期权、中泰证券XTP、华鑫证券奇点TORA、东方证券OST、东方财富证券EMT、盈透证券TWS、易盛TAP、量投QDP等各通道的CTPAPI兼容接口，CTP程序可以无缝对接各股票柜台。openctp也提供了一套基于TTS交易系统的模拟环境，同样提供了CTPAPI兼容接口，不仅支持国内期货与期权全品种，也支持A股股票、基金、债券以及股票期权模拟交易，可以替代Simnow，为CTP量化交易开发者提供7x24可用的模拟环境。项目地址: https://gitcode.com/GitHub_Trending/op/openctp