综合交易平台API技术开发指南

【综合交易平台API技术开发指南】

（查询数据流）的状态，通讯故障时，对话数据流（查询数据流）会重置，通讯途中的

数据可能会丢失。

私有通讯模式对应私有数据流（Private）

后台维护每个登录用户的私有流，在一个交易日内，CTP-API与CTP后台断线后恢复连

接时，

或断线期间（resume）的私有数据流。

广播通讯模式对应公共数据流（Public）

可靠的数据流。

11. CTP-API的实例会在客户端生成哪些流文件？如何指定流文件存放路径？

【答：

实例（DialogRsp.con，Private.con，Public.con，QueryRsp.con，TradingDay.con） 文件的存放路径都是通过接口实例创建函数（CreateFtdcTraderApi）参

数指定，如CreateFtdcTraderApi(\将会在当前目录的flow文件夹存放流文件。 客户端无法决定是否生成以上流文件，因此，在开发多CTP-API实例的客户端时需要注 意操作系统的文件句柄限制。

因此，多账号共用接口实例（或多实例共用流文件）将会造成数据紊乱或缺失。

12. 基于CTP-API的客户端交易软件在每个交易日开始之前需要执行哪些必要的步骤？

【答： 1创建API实例（CreateFtdcTraderApi）并为其注册对应的回调接口类的实例

??上海期货信息技术有限公司，2012

第 5 页 共 18 页

（RegisterSpi） → ○订 阅 私 有 流 （SubscribePrivateTopic） → ○订 阅 公 有 流 （SubscribePublicTopic）→○注册名字服务器网络地址（RegisterNameServer）或注册前 置机网络地址（RegisterFront）→○初始化API与CTP前置服务器连接（Init） 功后回调OnFrontConnected→○发起客户端认证请求（ReqAuthenticate）

结果由OnRspAuthenticate返回；在CTP后台开启强制客户端认证（或客户端在本次会 话主动发起认证）后，只有通过客户端认证才能接入CTP后台→○发起用户登录请求 （ReqUserLogin）

户端在当前交易日必须成功执行一次 后才能开始交易。

【综合交易平台API技术开发指南】

13. CTP的客户端怎样实现对代理服务器的支持？

【答： CTP的API提供了对代理服务器的支持，包括socks4、socks4a及socks5，客户

端开发时只需通过传递给API不同的连接字符串就可实现，例如：

RegisterFront(\地址或域名:端口号/user:pass@127.0.0.1:10001\

14. 什么是动态密码（OneTimePassword）

【答：

易使用的一种更强的身份验证工具，

为CTP供应动态令牌的厂商有坚石诚信和飞天诚信。证券（期货）公司购买动态令牌后 将随附的种子文件导入CTP后台，

令牌的投资者在登录CTP时需要将动态令牌当时显示的字符填写到OneTimePassword 字段，通过用户名/密码以及动态密码校验后方可登录成功。

15. 什么是客户端认证，怎样获取认证码（AuthCode）？

【答：

端产品接入CTP后台进行交易。

入指定的证券（期货）公司CTP交易系统之前，必须向该公司提交用户端产品信息

（UserProductInfo） 并 获 得 认 证 码 （AuthCode） 之 后 在 发 起 客 户 端 认 证 请 求 时 （ReqAuthenticate）填写正确的用户端产品信息及对应的认证码即可完成客户端认证。

16. CTP的名字服务器是做什么用的，如何使用？

【答：

名字服务器（RegisterNameServer）自动选择CTP后台分配的前置机地址接入CTP交易 系统，不再需要客户端直接注册CTP前置地址（RegisterFront）

17. CTP是否提供加密手段以保护通过互联网传送的交易数据的安全？

【答：

??上海期货信息技术有限公司，2012

第 6 页 共 18 页

方式接入CTP交易系统。客户端选择接入ssl前置时使用如下方式注册ssl前置地址：

【综合交易平台API技术开发指南】

RegisterFront(\前置IP地址或域名:端口号\

18. 如何接入CTP提供的UDP行情？

【答：

bIsUsingUdp=false) 中，参数bIsUsingUdp：为行情模式，该参数缺省或置为false时使用 TCP行情，否则为UDP行情。无论使用TCP或是UDP行情，都必须注册相对应的TCP 或UDP行情服务器地址。一般来说，CTP的普通行情前置都为TCP行情服务器，使用 UDP行情服务器需要向证券（期货）公司申请，且仅限专线或内网接入的投资者使用。

在注册行情前置服务器时，无论是tcp还是udp，都必须使用RegisterFront(\

行情前置服务器IP地址或域名:端口号\的格式，因为udp传输存在不可靠性，所以在

登录、订阅及接收第一次行情时仍然使用tcp方式；并且无需为udp方式提供配置节点 参数，udp仍然使用相同的地址和端口号。

19. CTP对每秒发送查询数量的限制是多少？

【答： CTP仅对查询进行流量限制，对交易指令没有限制。如果有在途的查询，不允

许发新的查询。1秒钟最多允许发送1个查询。返回值“-2”表示“未处理请求超过许 可数” “-3”表示“每秒发送请求数超过许可数”

20. 程序使用TradeApi和MdApi，并且把这2个dll放在同一个目录下。程序再次启动后，

如果某个api采用Resume模式订阅公有流/私有流，就会去参考相关的本地流文件。可

能会导致数据异常？ 【答：

对方写下的流文件。程序再次启动时，TradeApi可能去参考MdApi写下的流文件，所以 导致数据流不连续。解决方法：如果一定要把2个dll放在相同的目录下，可以在创建 api时指定流文件的路径。使得不同的dll写入不同流文件。

static CThostFtdcUserApi *CreateFtdcUserApi(const char *pszFlowPath = \ bIsUsingUdp=false);

21. 请问api是否多线程安全的（linux以及windows平台）？

【答： api,spi是不同的线程、可以同时被多个线程调用、

??上海期货信息技术有限公司，2012

第 7 页 共 18 页

【综合交易平台API技术开发指南】

这些特性和平台无关。

22. 测试时发现CThostFtdcMdSpi有个比较严重的问题，就是使用Release()退出清理对象时

会出现死机，并且频率很高，怎样解决？

【答：

template

void CUserApiEnv::UnInitialUserApi() {

// 释放UserApi

if (m_pUserApi) {

m_pUserApi->RegisterSpi(NULL);

m_pUserApi->Release(); m_pUserApi = NULL; }

// 释放UserSpi实例 if (m_pUserSpiImpl) {

delete m_pUserSpiImpl;

m_pUserSpiImpl = NULL; } }

23. CTP的LIB，是几字节对齐的，是一字节，还是八字节，还是其它的？

【答：

24. 使用查询函数时怎样设置查询条件？

【答： CTP提供了查询函数及查询相应函数，客户端可以使用这些函数向后台查询投

??上海期货信息技术有限公司，2012

第 8 页 共 18 页

资者以及基础数据信息，