跳转至

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个字节,期货公司及终端厂商反馈该字段长度不够,故在RegisterUserSystemInfoSubmitUserSystemInfo的‘CThostFtdcUserSystemInfoField’新增‘ClientLoginRemark’字段,解决原登录备注长度不足的问题。

如需使用本功能,CTP后台系统需要升级至V6.6.1及以上版本。

调用的接口如下:

///注册用户终端信息,用于中继服务器多连接模式
///需要在终端认证成功后,用户登录前调用该接口
virtual int RegisterUserSystemInfo(CThostFtdcUserSystemInfoField *pUserSystemInfo) = 0;
///上报用户终端信息,用于中继服务器操作员登录模式
///操作员登录后,可以多次调用该接口上报客户信息
virtual int SubmitUserSystemInfo(CThostFtdcUserSystemInfoField *pUserSystemInfo) = 0;

接口中新增字段如下:(在CThostFtdcUserSystemInfoField如下字段,支持中继客户填写登录备注(例如客户端的IP,MAC等信息),该字段长度为150字节)

///客户登录备注2
TThostFtdcClientLoginRemarkType ClientLoginRemark;

3.2. 支持中金所顶单功能

支持中金所顶单业务,支持中金所报价填写被顶单的单子QuoteSysID,顶单即用一笔新报价,来更新相同合约的老报价,一次指令中包含撤销老报价和录入新报价两个操作,且会生成新的报价单编号。

如需使用本功能,CTP后台系统需要升级至V6.6.1及以上版本。

调用的接口如下:

///报价录入请求
virtual int ReqQuoteInsert(CThostFtdcInputQuoteField *pInputQuote, int nRequestID) = 0;

接口中CThostFtdcInputQuoteField增加字段:

///被顶单编号
TThostFtdcOrderSysIDType    ReplaceSysID;

注:

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版本支持。