6.6.1P1版本更新说明
版本号:V6.6.1_P1_20210407_traderapi
1. 兼容性
V6.3.X的API可以访问6.3.X~6.6.X及其以上的CTP后台系统,但无法支持大商所长合约期权组合,无法支持IPv6;
V6.5.X、V6.6.X的API只能访问6.5.X及其以上的CTP后台系统,支持大商所长合约期权组合,支持IPv6;
注意:6.6.1API引入的新函数只有在接入6.6.1及以上后台的时候才会有响应,接入6.5.0时无响应。
2. 运行环境
Linux操作系统版本为Redhat5.8及以上。
Windows为vista及以上的操作系统,支持32位和64位。
只支持vista及以上的操作系统是由于本次更新支持IPv6,涉及函数只能在vista及以上版本使用。
3. API变动
3.1. 新增‘ClientLoginRemark’字段
因原API接口中ReqUserLogin中的登录备注字段LoginRemark长度为36个字节,期货公司及终端厂商反馈该字段长度不够,故在RegisterUserSystemInfo和SubmitUserSystemInfo的‘CThostFtdcUserSystemInfoField’新增‘ClientLoginRemark’字段,解决原登录备注长度不足的问题。
如需使用本功能,CTP后台系统需要升级至V6.6.1及以上版本。
调用的接口如下:
///注册用户终端信息,用于中继服务器多连接模式
///需要在终端认证成功后,用户登录前调用该接口
virtual int RegisterUserSystemInfo(CThostFtdcUserSystemInfoField *pUserSystemInfo) = 0;
///上报用户终端信息,用于中继服务器操作员登录模式
///操作员登录后,可以多次调用该接口上报客户信息
virtual int SubmitUserSystemInfo(CThostFtdcUserSystemInfoField *pUserSystemInfo) = 0;
接口中新增字段如下:(在CThostFtdcUserSystemInfoField如下字段,支持中继客户填写登录备注(例如客户端的IP,MAC等信息),该字段长度为150字节)
3.2. 支持中金所顶单功能
支持中金所顶单业务,支持中金所报价填写被顶单的单子QuoteSysID,顶单即用一笔新报价,来更新相同合约的老报价,一次指令中包含撤销老报价和录入新报价两个操作,且会生成新的报价单编号。
如需使用本功能,CTP后台系统需要升级至V6.6.1及以上版本。
调用的接口如下:
接口中CThostFtdcInputQuoteField增加字段:
注:
1)ReplaceSysID为空:普通报价,即不顶单;
2)ReplaceSysID填"last":对最近一笔报价顶单;
3)ReplaceSysID填指定报价编号:对指定报价编号顶单。
3.3. 支持交易所结算风险隔离功能
针对已完成风险计算但尚未完成正式结算的品种,支持查询该风险产品与风险持仓。
如需使用本功能,CTP后台系统需要升级至V6.6.0及以上版本。
新增接口如下:
///投资者风险结算持仓查询
virtual int ReqQryRiskSettleInvstPosition(CThostFtdcQryRiskSettleInvstPositionField *pQryRiskSettleInvstPosition, int nRequestID) = 0;
///风险结算产品查询
virtual int ReqQryRiskSettleProductStatus(CThostFtdcQryRiskSettleProductStatusField *pQryRiskSettleProductStatus, int nRequestID) = 0;
///投资者风险结算持仓查询响应
virtual void OnRspQryRiskSettleInvstPosition(CThostFtdcRiskSettleInvstPositionField *pRiskSettleInvstPosition, CThostFtdcRspInfoField *pRspInfo, int nRequestID, bool bIsLast) {};
///风险结算产品查询响应
virtual void OnRspQryRiskSettleProductStatus(CThostFtdcRiskSettleProductStatusField *pRiskSettleProductStatus, CThostFtdcRspInfoField *pRspInfo, int nRequestID, bool bIsLast) {};
3.4. API与前置传输过程中的数据压缩
支持API与前置传输过程中的数据压缩,该变更对API使用者来说无影响。CTP后台系统在V6.6.1_P1版本支持。