主页

CTP-API接口说明

1.介绍

本接口说明旨在帮助开发者快速查阅综合交易平台API（CTP-API）的使用方法、参数说明及注意事项。文中汇集了CTP-API使用过程中常见的问题、重要参数说明及接口调用示例。

2.版本

本接口文档基于v6.7.7版本。具体更新内容请参照6.7.7版本更新说明。API使用监控中心分配给上期技术CTP系统的正式密钥进行编译，只能接入6.5.0版本及以上的front_se（看穿式监管交易前置）。

各终端需要通过期货公司评测后方能接入生产正式交易，评测时，需要使用集成了监控中心评测密钥的评测版API进行评测，在官网均有下载。

各版本接入规则如下（更详细的版本前后台说明请参考SFIT官网API下载页面描述）：

6.3.11API为非看穿式监管版本，只能连接普通front前置

看穿式监管各版本API由于集成了不同的监控中心密钥，所以：

6.3.16_T1以上的评测版API只能连接评测版front_se前置；

6.3.15以上的生产版API只能连接生产版front_se前置。

API、采集库和前置版本必须遵循以上接入规则，否则无法连接前置或无法解密采集数据！！

API数据采集相关说明参见看穿式监管数据采集说明

API编译时使用的字符集为GBK。

3.接口文件列表

文件名	详情
ThostFtdcTraderApi.h	交易接口C++头文件包含交易相关的指令，如报单
ThostFtdcMdApi.h	交易接口C++头文件包含获取行情相关的指令。
ThostFtdcUserApiStruct.h	包含了所有用到的数据结构的头文件。
ThostFtdcUserApiDataType.h	包含了所有用到的数据类型的头文件。
DataCollect.h	穿透式监管采集模块头文件
thosttraderapi.dll	交易部分的动态链接库和静态链接库。
thosttraderapi.lib	交易部分的动态链接库和静态链接库。
thostmduserapi.dll	行情部分的动态链接库和静态链接库。
thostmduserapi.lib	行情部分的动态链接库和静态链接库。
WinDataCollect.dll	穿透式监管采集模块的动态链接库和静态链接库
WinDataCollect.lib	穿透式监管采集模块的动态链接库和静态链接库
error.dtd	包含所有可能的错误信息。
error.xml	包含所有可能的错误信息。

TraderApi使用对象为直连CTP的终端和连接CTP的中继平台

WinDataCollect采集库的使用对象对中继平台下的客户交易终端，他们只需调用采集库采集信息

4.命名规则

消息	格式	实例
请求	Req------	ReqUserLogin
响应	OnRsp------	OnRspUserLogin
查询	ReqQry------	ReqQryInstrument
查询请求的响应	OnRspQry------	OnRspQryInstrument
回报	OnRtn------	OnRtnOrder
错误回报	OnErrRtn------	OnErrRtnOrderInsert

5.官方网站

开发者可以通过上期技术官网http://www.sfit.com.cn/下载API接口及说明文档。

6.模拟账号

开发者可以向上期技术SIMNOW官网http://www.simnow.com.cn/申请账号并接入测试；也可以向期货公司申请仿真账号，并接入期货公司的仿真环境测试。

7.综合交易平台API技术服务群

QQ群：615403410 （需通过期货公司向上期技术提交入群申请）

8.更多

更多信息请关注上期技术官方微信公众号。如有意见或建议请联系CTP-API技术支持