版本更新介绍
版本更新介绍
文档版本与重要更新
描述主要和重要更新内容。
版本
V2.2.39.3
更新历史
version 2.2.39.3
（1）修复因与quote服务器协议不一致导致crash的bug
version 2.2.39.2
（1）QuoteSpi中新增逐笔行情丢包通知函数OnTickByTickLossRange()
（2）QuoteSpi中新增ETFIOPV行情回调函数OnETFIOPVData()
version 2.2.38.1
（1）XTP_SECURITY_TYPE中新增商品期货ETF XTP_SECURITY_ETF_COMMODITY_FUTURES = 22枚举值 （2）TraderApi新增新债信息查询接口QueryBondIPOInfoList以及响应接口OnQueryBondIPOInfoList
version 2.2.37.4
（1）XTP_SECURITY_TYPE新增现金债券ETF XTP_SECURITY_TYPE_ETF_CASH_BOND枚举值
version 2.2.36.1
（1）新三板全量静态信息结构体XTPNQFI中启用保留字段，新增分层信息layer_type、是否融资标的is_rzbd、是否融券标的is_rqbd、是否当日可融资is_drrz、是否当日可融券is_drrq等字段
（2）TraderApi中新增修改已有的算法单接口ModifyAlgoOrder()
（3）TraderSpi中新增修改已有策略单的响应接口OnModifyAlgoOrder()
version 2.2.35.1
（1）XTP_BUSINESS_TYPE证券业务类型新增债转股业务XTP_BUSINESS_TYPE_BOND_SWAP_STOCK枚举值
（2）TraderApi中新增债转股信息查询接口QueryBondSwapStockInfo()
（3）TraderSpi中新增债转股信息查询应答响应接口OnQueryBondSwapStockInfo()
version 2.2.34.10
（1）查询持仓结构体XTPQueryStkPositionRsp中新增昨日买入成本last_buy_cost、昨日盈亏成本last_profit_cost字段
version 2.2.34.9
（1）修复quote lib中单订阅新三板行情时，无法正确推送快照数据的bug
（2）资金流转方向XTP_FUND_TRANSFER_TYPE 新增信用双中心设置账户的资金划拨方向
（3）柜台资金查询类型XTP_FUND_QUERY_TYPE新增信用双中心设置账户的资金查询类型
version 2.2.34.8
（1）修复trader lib中分页查询组合策略期权成交的接口没有正确报送的bug
version 2.2.34.7
（1）融资融券账户附加信息结构体XTPCrdFundExtraInfo中启用预留字段，新增证券市值security_capital、融资负债financing_debts、融券负债short_sell_debts、授信总额度contract_debts_load这4个字段 （2）TraderApi中新增请求推荐算法接口StrategyRecommendation() （3）TraderSpi中新增推荐算法的响应接口OnStrategyRecommendation() （4）TraderSpi中新增母单创建时的推送消息响应接口OnNewStrategyCreateReport()
version 2.2.34.6
（1）XTP_MARKET_TYPE 新增2个枚举值：北京A XTP_MKT_BJ_A、港股 XTP_MKT_HK
（2）债券额外数据结构体XTPMarketDataBondExData中新增2个字段：匹配成交成交量(SZ)match_qty和匹配成交成交金额(SZ)match_turnover
（3）QuoteApi支持新三板行情：订阅、取消订阅、查询
（4）QuoteApi新增查询新三板合约完整静态信息请求函数QueryAllNQTickersFullInfo()
（5）QuoteSpi新增查询新三板合约完整静态信息应答回调函数OnQueryAllNQTickersFullInfo()
（6）查询持仓结构体XTPQueryStkPositionRsp中新增义务仓占用保证金margin字段
（7）查询期权组合策略持仓信息结构体XTPQueryOptCombPositionRsp中新增组合占用公司保证金secu_comb_margin字段
version 2.2.33.5
（1）QuoteSpi新增与行情回补服务器断开的回调函数 OnRebuildQuoteServerDisconnected() （2）QuoteSpi新增回补请求应答OnRequestRebuildQuote() （3）QuoteSpi新增逐笔数据回补响应函数OnRebuildTickByTick() （4）QuoteSpi新增快照数据回补响应函数OnRebuildMarketData() （5）QuoteApi新增登陆回补行情服务器请求函数LoginToRebuildQuoteServer() （6）QuoteApi新增登出回补行情服务器请求函数LogoutFromRebuildQuoteServer() （7）QuoteApi新增请求回补指定行情接口函数RequestRebuildQuote() （8）TradeAPI新增预先获取订单的xtp_id接口GetANewOrderXTPID() （9）TradeAPI新增预设xtpid的报单接口InsertOrderExtra() （10）TradeAPI新增预设xtpid的组合策略期权报单接口InsertOptionCombinedOrderExtra() （11）债券额外数据结构体XTPMarketDataBondExData中新增匹配成交最近价(SZ)match_lastpx 、债券加权平均价格(SH)ma_bond_price，当日均价avg_price变成保留字段 （12）成交类型TXTPTradeTypeType新增枚举值：港市资金成交XTP_TRDT_HK_MKT_CASH、非沪深资金成交XTP_TRDT_NON_SHSZ_MKT_CASH （13）查询持仓结构体XTPQueryStkPositionRsp中新增持仓市值market_value字段 （14）TradeAPI新增策略中指定证券的执行状态通知接口OnStrategySymbolStateReport() （15）修复quote库断线后无法再次登陆的bug
version 2.2.32.2
（1）修复bug
version 2.2.32.1
（1）行情快照结构体XTPMD中新增行情快照数据类型data_type_v2，以便更详细区分各种快照数据 （2）行情快照结构体XTPMD的联合体中新增债券额外信息结构体XTPMarketDataBondExData
version 2.2.31.2
（1）逐笔信息结构体XTPTBT的联合体中新增逐笔状态订单结构体XTPTickByTickStatus，为后续交易所行情数据升级做准备 （2）逐笔类型XTP_TBT_TYPE新增枚举类型 XTP_TBT_STATE 状态订单
version 2.2.31.1
（1）TradeAPI新增新版根据报单ID查询普通报单接口QueryOrderByXTPIDEx() （2）TradeAPI新增新版查询普通报单接口QueryOrdersEx() （3）TradeAPI新增新版查询未完结普通报单接口QueryUnfinishedOrdersEx() （4）TradeAPI新增新版查询普通报单相关接口对应的回调函数接口OnQueryOrderEx()，为用户提供更丰富的查询信息，例如拒单原因 （5）TradeAPI新增新版分页查询普通报单接口QueryOrdersByPageEx() （6）TradeAPI新增新版分页查询普通报单接口对应的回调函数接口OnQueryOrderByPageEx()，为用户提供更丰富的查询信息，例如拒单原因 （7）TradeAPI新增新版查询组合策略期权报单接口QueryOptionCombinedOrdersEx() （8）TradeAPI新增新版根据报单ID查询组合策略期权报单接口QueryOptionCombinedOrderByXTPIDEx() （9）TradeAPI新增新版查询组合策略期权未完结报单接口QueryOptionCombinedUnfinishedOrdersEx() （10）TradeAPI新增新版查询组合策略期权报单相关接口对应的回调函数接口OnQueryOptionCombinedOrdersEx()，为用户提供更丰富的查询信息，例如拒单原因 （11）TradeAPI新增新版分页查询组合策略期权报单接口QueryOptionCombinedOrdersByPageEx() （12）TradeAPI新增新版分页查询组合策略期权报单接口对应的回调函数接口OnQueryOptionCombinedOrdersByPageEx()，为用户提供更丰富的查询信息，例如拒单原因
version 2.2.30.7
（1）XTP_SECURITY_TYPE 新增 XTP_SECURITY_ETF_CROSS_BORDER_STOCK 跨境ETF类型
（2）XTP新增跨境ETF的买卖业务（申赎业务暂不支持）
（3）修复QuoteAPI在UDP连接中使用单订阅函数订阅行情且最后一个是无效订阅时，无法正确建立UDP连接的bug
（4）查询持仓结构体XTPQueryStkPositionRsp中新增持仓类型position_security_type字段，用户可以用此字段区分持仓是否为配股配债类型
（5）QuoteAPI新增设定接收线程绑核CPU集接口SetUDPRecvThreadAffinityArray，最多支持4个核，具体使用的核数视实际情况而定
（6）QuoteAPI新增设定解析线程绑核CPU集接口SetUDPParseThreadAffinityArray，最多支持4个核，具体使用的核数视实际情况而定
（7）QuoteAPI原有的SetUDPRecvThreadAffinity和SetUDPParseThreadAffinity弃用，为了兼容性还保留，但不建议使用
（8）QuoteAPI中SetUDPBufferSize()可以设置比以前小一些了，QuoteAPI占用的内存总体可能比以前大了
（9）逐笔委托结构体XTPTickByTickEntrust中新增原始订单号order_no字段，并针对上海逐笔委托数据增加部分说明
（10）行情全量静态信息结构体XTPQuoteFullInfo中新增证券状态security_status字段，用于区分风险警示板和退市整理板
（11）QuoteAPI修复bug - 全订阅/全取消订阅期权数据时，无法正确回调全订阅/全取消订阅响应函数
（12）查询资金响应结构体XTPQueryAssetRsp中新增2个期权账户专用字段（期权服务器版本后续即将支持，以服务器版本为准）：交易所实时风险度exchange_cur_risk_degree 和 公司实时风险度company_cur_risk_degree
version 2.2.30.6
（1）XTP_SECURITY_TYPE 新增 XTP_SECURITY_ETF_CROSS_BORDER_STOCK 跨境ETF类型 （2）XTP新增跨境ETF的买卖业务（申赎业务暂不支持）
version 2.2.30.5
（1）修复QuoteAPI在UDP连接中使用单订阅函数订阅行情且最后一个是无效订阅时，无法正确建立UDP连接的bug
version 2.2.30.3
（1）查询持仓结构体XTPQueryStkPositionRsp中新增持仓类型position_security_type字段，用户可以用此字段区分持仓是否为配股配债类型
version 2.2.30.2
（1）QuoteAPI新增设定接收线程绑核CPU集接口SetUDPRecvThreadAffinityArray，最多支持4个核，具体使用的核数视实际情况而定
（2）QuoteAPI新增设定解析线程绑核CPU集接口SetUDPParseThreadAffinityArray，最多支持4个核，具体使用的核数视实际情况而定
（3）QuoteAPI原有的SetUDPRecvThreadAffinity和SetUDPParseThreadAffinity弃用，为了兼容性还保留，但不建议使用
（4）QuoteAPI中SetUDPBufferSize()可以设置比以前小一些了，QuoteAPI占用的内存总体可能比以前大了
（5）逐笔委托结构体XTPTickByTickEntrust中新增原始订单号order_no字段，并针对上海逐笔委托数据增加部分说明
（6）行情全量静态信息结构体XTPQuoteFullInfo中新增证券状态security_status字段，用于区分风险警示板和退市整理板
version 2.2.27.6
（1）QuoteAPI修复bug - 全订阅/全取消订阅期权数据时，无法正确回调全订阅/全取消订阅响应函数
（2）查询资金响应结构体XTPQueryAssetRsp中新增2个期权账户专用字段（期权服务器版本后续即将支持，以服务器版本为准）：交易所实时风险度exchange_cur_risk_degree 和 公司实时风险度company_cur_risk_degree
version 2.2.27.5
（1）XTPStrategyStateReportStruct结构体新增2个参数：m_strategy_unclosed_qty 策略未平仓数量(T0卖出数量-买入数量) 和 m_strategy_asset_diff 策略执行绩效(T0资金预净收入) （2）TraderApi新增查询其他服务器节点可用资金接口 QueryOtherServerFund() （3）TraderSpi新增查询其他服务器节点可用资金响应接口 OnQueryOtherServerFund()
version 2.2.27.4
（1）ALGOUserEstablishChannel()接口参数中减少硬件信息相关参数输入 （2）去除CreateStrategy、CancelStrategy、StartStrategy、StopStrategy、DestroyStrategy以及对应的Spi回调接口 （3）新增InsertAlgoOrder() 、CancelAlgoOrder() 2个接口以及对应的Spi回调接口，替代（2）中提到的5个接口
version 2.2.27.2
（1）查询持仓结构体XTPQueryStkPositionRsp中新增盈亏成本profit_cost和买入成本buy_cost2个字段
（2）TradeAPI新增期权行权合并头寸查询接口QueryOptionCombinedExecPosition()
version 2.2.26.3
（1）查询持仓结构体XTPQueryStkPositionRsp中新增profit_price盈亏成本价字段
version 2.2.25.7
（1）用户终端信息XTPUserTerminalInfoReq结构体中新增客户端版本client_version字段和仅MacOS系统使用的macos_sno字段
version 2.2.25.5
（1）XTPQuoteFullInfo结构体中uint字段修改为uni字段
version 2.2.25.4
（1）QuoteAPI新增查询合约全量静态数据接口QueryAllTickersFullInfo()
version 2.2.25.3
（1）TradeAPI新增组合策略期权相关功能接口
（2）XTP_SIDE_TYPE新增期权组合策略业务相关枚举值
（3）XTP_BUSINESS_TYPE新增期权组合策略业务相关枚举值（组合拆分时使用）
（4）TradeAPI新增期权组合策略报单录入请求接口InsertOptionCombinedOrder()
（5）TradeAPI新增期权组合策略撤单请求接口CancelOptionCombinedOrder()
（6）TradeAPI新增期权组合策略查询未完结报单接口QueryOptionCombinedUnfinishedOrders()
（7）TradeAPI新增期权组合策略根据报单ID查询报单接口QueryOptionCombinedOrderByXTPID()
（8）TradeAPI新增期权组合策略查询报单接口QueryOptionCombinedOrders()
（9）TradeAPI新增期权组合策略分页查询报单接口QueryOptionCombinedOrdersByPage()
（10）TradeAPI新增期权组合策略根据报单ID查询成交接口QueryOptionCombinedTradesByXTPID
（11）TradeAPI新增期权组合策略查询成交回报接口QueryOptionCombinedTrades()
（12）TradeAPI新增期权组合策略分页查询成交回报接口QueryOptionCombinedTradesByPage()
（13）TradeAPI新增期权组合策略查询持仓接口QueryOptionCombinedPosition()
（14）TradeAPI新增期权组合策略查询组合策略信息接口QueryOptionCombinedStrategyInfo
version 2.2.24.2
（1）QuoteAPI新增接收行情线程绑定CPU接口SetUDPRecvThreadAffinity()
（2）QuoteAPI新增解析行情线程绑定CPU接口SetUDPParseThreadAffinity()
（3）QuoteAPI新增设定异步日志是否输出的接口SetUDPSeqLogOutPutFlag()
（4）TradeAPI新增查询未完结订单接口QueryUnfinishedOrders()
（5）TradeAPI新增查询信用账户余券信息接口QueryMulCreditExcessStock()
（6）TradeAPI新增报单查询分页接口QueryOrdersByPage()
（7）TradeAPI新增成交回报分页查询接口QueryTradesByPage()
version 2.2.23.2
（1）TradeAPI新增负债合约展期接口CreditExtendDebtDate()
（2）TradeAPI新增查询融资融券业务中账戶的附加信息接口QueryCreditFundExtraInfo()
（3）TradeAPI新增查询融资融券业务中账戶指定证券的附加信息接口QueryCreditPositionExtraInfo()
（4）TradeAPI新增查询融资融券业务中负债合约展期接口QueryCreditExtendDebtDateOrders()
（5）结构体XTPCrdDebtStockInfo中的 remain_quantity 字段更名为 stock_repay_quantity
（6）新股申购查询结构体XTPQueryIPOTickerRsp中新增对科创板新股的支持
（7）新股申购额度查询结构体XTPQueryIPOQuotaRsp中新增科创板额度
version 2.2.15.1
（1）优化行情UDP接收
version 2.2.14.2
（1）TradeAPI支持一账号两中心节点之间的资金划拨
（2）XTP_FUND_TRANSFER_TYPE增加节点之间的资金划拨方向枚举值
version 2.2.14.1
（1）单条融资融券负债记录信息结构体XTPCrdDebtInfo中增加字段（应偿还权益数量due_right_qty）
version 2.2.13.2
（1）TradeAPI新增对融资融券业务的支持
（2）查询资金结构体XTPQueryAssetRsp新增信用账户专用字段（融券卖出所得资金余额repay_stock_aval_banlance）
（3）XTP_SIDE_TYPE新增信用业务相关枚举值
（4）XTP_POSITION_EFFECT_TYPE新增信用业务相关枚举值（强平时使用）
（5）TradeAPI新增融资融券业务中现金直接还款接口CreditCashRepay()
（6）TradeAPI新增查询融资融券业务中现金直接还款报单接口QueryCreditCashRepayInfo()
（7）TradeAPI新增查询信用账户特有信息接口QueryCreditFundInfo()
（8）TradeAPI新增查询信用账户负债合约信息接口QueryCreditDebtInfo()
（9）TradeAPI新增查询指定证券负债未还信息接口QueryCreditTickerDebtInfo()
（10）TradeAPI新增查询信用账户待还资金信息接口QueryCreditAssetDebtInfo()
（11）TradeAPI新增查询信用账户可融券头寸信息接口QueryCreditTickerAssignInfo()
（12）TradeAPI新增融资融券业务中请求查询指定证券的余券接口QueryCreditExcessStock()
version 1.1.18.14
（1）TXTPTradeTypeType 新增跨市场资金成交枚举值 XTP_TRDT_CROSS_MKT_CASH
（2）TradeAPI新增跨市场ETF业务支持
version 1.1.18.13
（1）修复QuoteAPI在linux下使用UDP连接会crash的bug
version 1.1.18.12
（1）QuoteAPI修改笔误，将exchage_id更改为为exchange_id
（2）修改头文件编码，从GB2312改为UTF-8
version 1.1.18.9
（1）TradeAPI新增对期权业务的支持（business_type = XTP_BUSINESS_TYPE_OPTION）
（2）查询持仓结构体XTPQueryStkPositionRsp中新增部分字段（持仓方向position_direction，可行权合约executable_option，可锁定标的lockable_position，可行权标的executable_underlying，已锁定标的locked_position，可用已锁定标的usable_locked_position ）
（3）TradeAPI新增查询期权合约接口OnQueryOptionAuctionInfo()
（4）XTP_SIDE_TYPE由int32的枚举类型变更为uint8类型的枚举值
（5）结构体XTPOrderInsertInfo、XTPOrderInfo、XTPTradeReport中新增开平标识字段position_effect用于期权业务（普通股票业务position_effect = XTP_POSITION_EFFECT_INIT）
（6）XTP_PRICE_TYPE新增枚举值：期权限价申报FOK XTP_PRICE_LIMIT_OR_CANCEL
（7）查询资金结构体XTPQueryAssetRsp中新增部分字段（冻结的保证金frozen_margin，行权冻结资金frozen_exec_cash，行权费用frozen_exec_fee，垫付资金pay_later，预垫付资金preadva_pay，昨日余额orig_banlance，当前余额banlance，当天出入金deposit_withdraw，当日交易资金轧差trade_netting，资金资产captial_asset，强锁资金force_freeze_amount，可取资金preferred_amount）
（8）QuoteAPI新增对期权行情的支持（复用原有的单订阅函数）
（9）QuoteAPI的全市场订阅函数中，均新增exchage_id参数，用户可以进行单市场全订阅了（exchage_id = XTP_EXCHANGE_UNKNOWN 表示全市场订阅），原有的全市场订阅函数仅支持股票行情
（10）QuoteAPI新增期权全市场行情订阅/取消订阅函数SubscribeAllOptionMarketData()/UnSubscribeAllOptionMarketData()
（11）QuoteAPI新增期权全市场行情订阅/取消订阅函数SubscribeAllOptionOrderBook()/UnSubscribeAllOptionOrderBook()
（12）QuoteAPI新增期权全市场行情订阅/取消订阅函数SubscribeAllOptionTickByTick()/UnSubscribeAllOptionTickByTick()
version 1.1.16.20
（1）去除对sodium库的依赖
（2）修复某些虚拟机环境下，由于无法获取mac地址，导致crash的bug
（3）修复行情api在使用UDP连接时，在丢包严重时会导致连续丢包的bug
（4）添加mac os系统支持
version 1.1.16.13
（1）修复使用win32版本的库进行查询操作，查询结果可能与查询条件不匹配的bug
version 1.1.16.9
（1）QuoteAPI新增UDP连接方式
（2）QuoteAPI新增全订阅、全退订接口
（3）QuoteAPI支持OrderBook（即level2plus）订阅、退订
（4）QuoteAPI支持逐笔委托/成交的订阅、退订
（5）QuoteAPI新增查询合约最新价接口
（6）QuoteSPI弃用原有OnMarketData()回调函数
（7）QuoteSPI启用含有买一卖一队列的OnDepthMarketData()回调函数
（8）QuoteAPI新增修改默认缓存队列的大小接口SetUDPBufferSize()，单位为MB，默认大小为64MB（不可更改为比64MB更小的缓存
（9）TradeAPI新增新股申购额度查询接口QueryIPOQuotaInfo()
（10）TradeAPI新增新股申购信息列表查询接口QueryIPOInfoList()
（11）TradeAPI回调接口中新增session_id参数
（12）TradeAPI和QuoteAPI新增心跳检测超时时间设置接口SetHeartBeatInterval()
version 1.1.16.1
（1）TradeAPI新增查询ETF清单接口QueryETF
（2）TradeAPI新增查询ETF股票篮接口QueryETFTickerBasket
（3）TradeAPI新增支持ETF申赎业务（business_type = XTP_BUSINESS_TYPE_ETF， side = XTP_SIDE_PURCHASE或XTP_SIDE_REDEMPTION）
（4）查询资金回报结构体XTPQueryAssetRsp增加部分字段
（5）查询持仓回报的结构体XTPQueryStkPositionRsp增加了部分字段
version 1.1.15.101
（1）TradeAPI新增分级基金申赎业务（business_type = XTP_BUSINESS_TYPE_STRUCTURED_FUND_PURCHASE_REDEMPTION，side = XTP_SIDE_PURCHASE或者XTP_SIDE_REDEMPTION）
（2）TradeAPI新增分级基金拆分合并业务（business_type = XTP_BUSINESS_TYPE_STRUCTURED_FUND_SPLIT_MERGE，side = XTP_SIDE_SPLIT或XTP_SIDE_MERGE）
（3）TradeAPI新增分级基金查询功能QueryStructuredFund
（4）TradeAPI新增客户资金划拨功能接口FundTransfer
（5）TradeAPI新增查询客户资金划拨接口QueryFundTransfer
version 1.1.14.1
（1）XTP_BUSINESS_TYPE 新增部分业务类型
（2）XTP系统支持逆回购和配股业务
（3）XTP_TICKER_TYPE证券类型中新增XTP_TICKER_TYPE_BOND债券类型
version 1.1.13.10
（1）结构体XTPQuoteStaticInfo中新增一个字段：
///最小变动价位
double price_tick;
version 1.1.13.8
（1）结构体XTPQueryAssetRsp新增1个字段：
///预扣的资金（包括购买卖股票时预扣的交易资金+预扣手续费）
double withholding_amount;
version 1.1.13.3
（1）结构体XTPOrderInsertInfo，XTPOrderInfo，XTPTradeReport新增business_type字段
（2）结构体XTPMarketDataStruct中部分字段类型由int32_t变为int64_t
（3）新增新股申购业务功能
（4）开放order_client_id字段，去除限制
version 1.1.12.7
（1）修复linux下使用相对路径或者多线程创建日志目录导致程序core dump的bug
（2）api的Create接口中增加调整日志输出级别参数
（3）修复调用Release()导致程序崩溃的bug
version 1.1.10.0
（1）XTPQuoteAPI新增查询所有可交易合约接口
（2）去掉部分无用的数据结构和宏定义：包括
（
XTP_TICKER_LEN
XTP_TICKER_NAME_LEN
XTP_TICKERNAME_LEN
XTP_API_TICKER_LEN
XTP_API_TICKER_NAME_LEN
TXTPTickerType
TXTPTickerNameType
）
统一归整成：
XTP_TICKER_LEN
XTP_TICKER_NAME_LEN
version 1.1.8.2
（1）修正多个用户登录服务器，当部分用户断线，而部分用户不断线，此时断线用户重新登录时可能会丢失部分消息包的bug
version 1.1.8.0
（1）修改通讯协议
version 1.1.7.2
（1）清除目录下一周前的日志文件
（2）当传入的路径不存在时，尝试创建路径
（3）增加SetSoftwareKey()接口，其中key为客户申请开户时分配
（4）减少SetSoftwareCode()接口
（5）获取不到mac地址或者硬盘序列号时，强制性登录失败
version 1.1.6.2
（1）GetApiLastError（）接口的返回值，从 int32_t 变为 XTPRI*
（2）查询持仓响应接口中增加 market 字段