algoderiv CTP 6.7.8 API Skill
CTP（综合交易平台）是中国期货市场最广泛使用的交易接口。本技能涵盖 CTP 6.7.8 版本的完整 API 文档，包括交易接口、行情接口、数据结构和错误处理。
When to Use This Skill
This skill should be triggered when:
- 使用 CTP API 进行期货/期权交易开发
- 实现行情订阅和数据处理
- 处理订单提交、撤单、查询操作
- 理解 CTP 回调机制和事件处理
- 调试 CTP 连接、登录、交易问题
- 查询账户资金、持仓、成交记录
Quick Reference
核心类
| 类名 | 用途 |
|---|---|
CThostFtdcTraderApi |
交易接口主类，处理订单、查询 |
CThostFtdcMdApi |
行情接口主类，订阅市场数据 |
CThostFtdcTraderSpi |
交易回调接口，接收交易响应 |
CThostFtdcMdSpi |
行情回调接口，接收行情数据 |
常用请求方法 (TraderApi)
// 登录
ReqUserLogin(CThostFtdcReqUserLoginField *pReqUserLoginField, int nRequestID);
// 报单
ReqOrderInsert(CThostFtdcInputOrderField *pInputOrder, int nRequestID);
// 撤单
ReqOrderAction(CThostFtdcInputOrderActionField *pInputOrderAction, int nRequestID);
// 查询持仓
ReqQryInvestorPosition(CThostFtdcQryInvestorPositionField *pQryInvestorPosition, int nRequestID);
// 查询资金
ReqQryTradingAccount(CThostFtdcQryTradingAccountField *pQryTradingAccount, int nRequestID);
常用回调方法 (TraderSpi)
// 登录响应
OnRspUserLogin(CThostFtdcRspUserLoginField *pRspUserLogin, CThostFtdcRspInfoField *pRspInfo, int nRequestID, bool bIsLast);
// 报单回报
OnRtnOrder(CThostFtdcOrderField *pOrder);
// 成交回报
OnRtnTrade(CThostFtdcTradeField *pTrade);
// 报单错误
OnErrRtnOrderInsert(CThostFtdcInputOrderField *pInputOrder, CThostFtdcRspInfoField *pRspInfo);
行情接口 (MdApi)
// 订阅行情
SubscribeMarketData(char *ppInstrumentID[], int nCount);
// 行情回调
OnRtnDepthMarketData(CThostFtdcDepthMarketDataField *pDepthMarketData);
关键数据结构
// 报单输入
struct CThostFtdcInputOrderField {
TThostFtdcBrokerIDType BrokerID; // 经纪公司代码
TThostFtdcInvestorIDType InvestorID; // 投资者代码
TThostFtdcInstrumentIDType InstrumentID; // 合约代码
TThostFtdcDirectionType Direction; // 买卖方向
TThostFtdcCombOffsetFlagType CombOffsetFlag; // 开平标志
TThostFtdcVolumeType VolumeTotalOriginal; // 数量
TThostFtdcPriceType LimitPrice; // 限价
// ...
};
// 深度行情
struct CThostFtdcDepthMarketDataField {
TThostFtdcInstrumentIDType InstrumentID; // 合约代码
TThostFtdcPriceType LastPrice; // 最新价
TThostFtdcVolumeType Volume; // 成交量
TThostFtdcPriceType BidPrice1; // 买一价
TThostFtdcVolumeType BidVolume1; // 买一量
TThostFtdcPriceType AskPrice1; // 卖一价
TThostFtdcVolumeType AskVolume1; // 卖一量
// ...
};
常见错误码
| 错误码 | 含义 |
|---|---|
| 0 | 成功 |
| 3 | 不合法的登录 |
| 5 | 用户未登录 |
| 13 | 资金不足 |
| 14 | 报单数量不合法 |
| 22 | 合约代码错误 |
| 25 | 平仓量超过持仓量 |
| 30 | CTP未初始化 |
| 31 | 前置不活跃 |
Reference Files
This skill includes comprehensive documentation in references/ (52 files, ~1.1MB total):
| 类别 | 文件 | 描述 |
|---|---|---|
| 入门 | getting_started_*.md |
入门指南、阅读指引 (3 files) |
| 交易接口 | trader_api.md |
CThostFtdcTraderApi 类 |
| 行情接口 | md_api.md |
CThostFtdcMdApi 类 |
| 交易回调 | trader_spi.md |
CThostFtdcTraderSpi 回调 |
| 行情回调 | md_spi.md |
CThostFtdcMdSpi 回调 |
| 请求方法 | requests_*.md |
Req* 方法 (5 files) |
| 回调方法 | callbacks_*.md |
OnRsp*/OnRtn* (10 files) |
| 交易功能 | trading_*.md |
交易相关 (5 files) |
| 行情功能 | market_data_*.md |
行情相关 (5 files) |
| API参考 | api_reference_*.md |
完整 API (14 files) |
| 版本记录 | changelog_*.md |
更新日志 (4 files) |
| 监管 | monitoring.md |
看穿式监管说明 |
Working with This Skill
交易流程
- 初始化:
CreateFtdcTraderApi()创建 API 实例 - 注册:
RegisterSpi()注册回调，RegisterFront()注册前置地址 - 连接:
Init()启动连接，等待OnFrontConnected()回调 - 认证:
ReqAuthenticate()客户端认证（看穿式监管） - 登录:
ReqUserLogin()用户登录 - 交易: 发送报单、查询等请求
- 释放:
Release()释放资源
行情流程
- 初始化:
CreateFtdcMdApi()创建行情 API - 注册: 注册 Spi 和前置地址
- 连接:
Init()启动，等待OnFrontConnected() - 登录:
ReqUserLogin()登录行情服务器 - 订阅:
SubscribeMarketData()订阅合约行情 - 接收: 通过
OnRtnDepthMarketData()接收行情推送
注意事项
- 所有请求都是异步的，通过回调返回结果
- 每个请求需要唯一的 RequestID
- 登录前需要先完成看穿式客户端认证
- 流控限制：每秒最多 1-2 个请求
- 注意处理断线重连逻辑
Source
- PDF: CTP 6.7.8 API接口说明
- Pages: 2466
- Version: 6.7.8
- Date: 2024-12
Notes
- 本技能从官方 PDF 文档自动提取
- 包含完整的 API 方法、回调、数据结构
- 代码示例为 C++ 风格，Python 绑定方法名相同
- 详细信息请参考 references/ 目录下的分类文档