用途:CTP(综合交易平台)是中国期货市场广泛使用的交易接口,本技能提供 CTP 6.7.8 版本 API 文档,用于期货/期权交易开发、行情订阅与数据处理、订单提交撤单查询、回调机制理解、连接登录交易问题排查,以及账户资金、持仓、成交记录查询。
主要能力:涵盖交易接口主类 CThostFtdcTraderApi、行情接口主类 CThostFtdcMdApi,交易回调 CThostFtdcTraderSpi、行情回调 CThostFtdcMdSpi。常用交易请求包括 ReqUserLogin、ReqOrderInsert、ReqOrderAction、ReqQryInvestorPosition、ReqQryTradingAccount;常用回调包括 OnRspUserLogin、OnRtnOrder、OnRtnTrade、OnErrRtnOrderInsert。行情侧提供 SubscribeMarketData 与 OnRtnDepthMarketData。文档还包含关键数据结构(如 CThostFtdcInputOrderField、CThostFtdcDepthMarketDataField)与常见错误码含义,例如 0 成功、3 不合法登录、5 用户未登录、13 资金不足、14 报单数量不合法、22 合约代码错误、25 平仓量超过持仓量、30 CTP 未初始化、31 前置不活跃。references/ 目录提供 52 个分类文件(约 1.1MB),含入门、交易/行情接口与回调、请求方法、回调方法、交易与行情功能、API 参考、版本记录及看穿式监管说明。
使用方式:交易流程为 CreateFtdcTraderApi() 创建实例、RegisterSpi() 注册回调、RegisterFront() 注册前置地址、Init() 启动连接并等待 OnFrontConnected()、ReqAuthenticate() 客户端认证、ReqUserLogin() 登录、随后发送报单与查询请求、最后 Release() 释放资源。行情流程为 CreateFtdcMdApi() 创建行情 API、注册 Spi 与前置地址、Init() 连接、ReqUserLogin() 登录、SubscribeMarketData() 订阅、经 OnRtnDepthMarketData() 接收推送。
限制与注意:所有请求异步,结果通过回调返回;每个请求需唯一 RequestID;登录前需先完成看穿式客户端认证;存在流控限制(每秒最多 1-2 个请求);需处理断线重连。代码示例为 C++ 风格,Python 绑定方法名相同。资料未提供具体收费、价格或平台支持范围。