跳转至

06.API_Changelog-4.1版本

[4.1.1380] - 20241119

支持的交易所：上期所、能源中心、中金所、广期所、大商所、郑商所

兼容级别：推荐更新

新增

  1. [通用] 支持TCP方式报撤单：通过配置文件增加TRADING_PROTOCOL=TCP的方式设置；柜台需升级至Release-007-P4及之后版本

修复

  1. [中金所] 修复柜台支持RCAMS组合保证金时，API关闭资金计算或极简模式下无法登录柜台的问题;

[4.1.1375] - 20240814

支持的交易所：上期所、能源中心、中金所、广期所、大商所、郑商所

兼容级别：推荐更新

新增

  1. [通用] 支持期权按照系列收取申报费：如果柜台支持按照系列收取，则信息量和费率查询也是系列级别；对应柜台需升级至Release-007-P3及之后版本

[4.1.1360] - 20240703

支持的交易所：上期所、能源中心、中金所、广期所、大商所、郑商所

兼容级别：推荐更新

新增

  1. [通用] 新增行情订阅的配置项，开启MD_ENABLED开关并配置行情服务地址端口MD_SERVER_IP和MD_SERVER_PORT后，即可接收柜台推送的逐笔行情；交易客户如需订阅柜台推送的一档行情，请联系期货公司升级柜台版本至Release-007-P1
  2. [通用] 支持根据合约的申报费开关判断是否计算投资者的申报费；

优化

  1. [通用] 优化XTFMarketData结构体，去除averagePrice、增加openPrice字段；

修复

  1. [郑商所] 修复行权后，可用仓位与柜台计算不一致的问题；
  2. [上期所/能源中心] 修复SPMM保证金在部分场景下与柜台计算不一致的问题；

[4.1.1350] - 20240619

支持的交易所：上期所、能源中心、中金所、广期所、大商所、郑商所

兼容级别：推荐更新

新增

  1. [通用] 新增网卡类型XNIC_TYPE和网卡名称XNIC_NAME两个配置项，启用低延迟网卡功能时可指定网卡类型，API使用对应类型的网卡驱动；
  2. [通用] 新增指定前置撤单/撤报价接口，支持指定channelSelectionType、channelID,该接口在 Release-007版本及以上柜台 才可生效；老的撤单接口默认从 原报单席位和管理席位 中随机选择可用席位进行撤单；
  3. [通用] 新增getMessageAmount()和getNextOrderCommissionRate()接口，可通过合约对象实时查询信息量，以及当前OTR、信息量档位对应的申报费率；
  4. [通用] 新增CHECK_VERSION_ENABLED配置项，用于控制头文件和库文件的版本不一致性检测，默认启用自动检测功能；
  5. [中金所][做市商] 新增报价顶单类型replaceType和指定报价编号replaceOrderID参数，报价时可指定不顶单/顶最近一笔/顶指定报价单中的任意一种类型；

优化

  1. [通用] 优化资金可用比例不能为0的问题，以兼容老版本柜台；
  2. [通用] 优化组合持仓处理，以兼容老版本柜台；
  3. [通用] 优化Order对象中对exchangeOrderID字段的维护，增加对报单回报、成交回报乱序场景的异常保护处理；

修复

  1. [广期所] 修复组合合约编号匹配错误，导致组合仓位计算不正确的问题；
  2. [大商所] 修复新组保RULE模型中，行权冻结保证金计算错误的问题；
  3. [郑商所] 修复非SPBM组保客户的行权冻结保证金计算错误的问题；

[4.1.1314] - 20240522

支持的交易所：上期所、能源中心、中金所、广期所、大商所、郑商所

兼容级别：推荐更新

优化

  1. [通用] 优化行权冻结保证金计算公式，增加虚值额的处理（与CTP保持一致）；
  2. [通用] 优化申报费查询接口XTFInstrument.getOrderCommissionRatio()，增加下标溢出保护；

[4.1.1300] - 20240513

提示

使用大批量撤单、撤报价功能的做市商客户需在柜台升级后同步升级此版本。

支持的交易所：上期所、能源中心、中金所、广期所、大商所、郑商所

兼容级别：推荐更新

新增

  1. [通用][做市商] 新增大批量撤报单cancelMassOrders()接口；
  2. [通用][做市商] 新增大批量撤报价cancelMassQuotes()接口；

优化

  1. [通用] 优化资金可用比例的变动推送，增加PrcID的保护判断，以防盘中出现其他事件导致该字段的异常更新；
  2. [通用] 优化投资者账号密码的规则校验，密码需要满足6~12位长度要求且至少由三种类型的字符组合（数字、大写字母、小写字母、特殊字符）；
  3. [通用] 优化配置项COMBINATION_TYPES和COMBINATION_ENABLED的使用说明，在4.1.1225及之后版本生效；

修复

  1. [中金所] 修复开仓价计算错误，导致持仓盈亏与柜台不一致的问题；
  2. [大商所] 修复RULE组保算法中，冻结附加保证金计算错误的问题；
  3. [通用] 修复期权行权申请成功后，可平仓位与柜台不一致的问题；

[4.1.1260] - 20240415

提示

使用大商RULE新组保、小节有效指令的交易客户需在柜台升级后同步升级此版本。

支持的交易所：上期所、能源中心、中金所、广期所、大商所、郑商所

兼容级别：推荐更新

新增

  1. [大商所] 支持大商所RULE新组保算法；
  2. [大商所] 新增报单类型的枚举值，支持小节有效 （GIS）类型；
  3. [通用] XTFAccount 结构体新增 getMarginType() 接口，支持交易客户查询柜台的保证金算法类型；

优化

  1. [通用] 完善Example06代码演示，增加修改密码功能；

修复

  1. [通用] 修复一键多条件撤单接口，将品种过滤器设置为XTF_PCF_ALL后过滤条件未生效的问题；
  2. [通用] 修复柜台重启后API自动重连的场景下，订单对象资源因为被回收但部分字段未重置，导致资金计算错误的问题；
  3. [郑商所] 修复行权未计算冻结保证金的问题；
  4. [大商所/广期所] 修复相同期权合约多次申请对冲，填写重复的LocalOrderID会遇到“-21013，行权/对冲报单已存在”的问题；

[4.1.1225] - 20240315

提示

使用上期SPMM新组保、指定前置优先级功能的交易客户需在柜台升级后同步升级此版本。

支持的交易所：上期所、能源中心、中金所、广期所、大商所、郑商所

兼容级别：推荐更新

新增

  1. [上期所/能源中心] 支持上期SPMM新组保算法；
  2. [通用] 新增投资者指定席位优先级的接口，如需使用此功能，需会员单位在Monitor 投资者参数配置 页面上开启 客户指定前置优先级 开关；

优化

  1. [通用] 优化订单的索引处理，取消对用户本地报单编号的依赖；
  2. [通用] 优化用户登录后的心跳发送处理，防止长时间登录后自动断开；
  3. [通用] 优化错误日志打印及部分头文件的注释说明；

修复

  1. [通用] 修复账户资金可用比例为0时，可用资金计算异常的问题；
  2. [通用] 修复部分查询接口未对入参进行有效性检查导致异常退出的问题；
  3. [通用] 修复使用本地报单编号撤单时，编号的边界值未处理导致撤单失败的问题；
  4. [通用] 修复成交明细日志打印时，交易所单号格式化的问题；
  5. [通用] 修复柜台盘中重启后API自动重连时，订单对象资源回收但未初始化导致资金计算错误的问题；
  6. [郑商所] 修复新组保对冲规则中包含异常数据时，可能导致API非法访问的问题；

[4.1.1072] - 20231226

提示

使用历史完结定单过滤、指定组合功能的交易客户需在柜台升级后同步升级此版本。

支持的交易所：上期所、能源中心、中金所、广期所、大商所、郑商所

兼容级别：推荐更新

新增

  1. [通用][做市商] 新增配置项HISTORICAL_FINISHED_ORDER_FILTER_ENABLED，用于过滤历史完结定单的流水；极简模式下历史回报过滤无效，仅正常模式有效
  2. [大商所/广期所] 新增配置项COMBINATION_TYPES组合类型与COMBINATION_ENABLED自动组合开关，用于指定自动组合的类型；COMBINATION_TYPES可设置多个XTFCombType枚举值，使用英文逗号分隔开，枚举值的填入顺序对组合优先级没有影响，柜台仍按交易所优先级进行处理；

修复

  1. [通用] 修复撤单被拒单时，回报中isHistory字段未更新赋值的问题；
  2. [通用] 修复交易所单号撤单在部分场景下撤销失败，报错“-21004报单没有找到”的问题；
  3. [通用] 修复多实例报单在部分场景下偶现“-23001合约找不到”的问题；
  4. [通用] 修复错误码2012对应错误信息的描述问题；

[4.1.1068] - 20231128

提示

使用郑商所SPBM业务的客户请下载此版本API,郑商所柜台也需配套升级至Release-004-P2。

支持的交易所：上期所、能源中心、中金所、广期所、大商所、郑商所

兼容级别：推荐更新

新增

  1. [通用] 前置席位选择类型新增FixedThenAuto选项，表示用户指定席位不可用时柜台自动分配可用席位；
  2. [通用] 支持关闭自动注册内部信号处理函数功能，调用makeXTFApi()接口时API默认注册signalhandler，若需关闭API自动注册signalhandler功能，可在配置文件中增加配置项REGISTER_SIGNAL_ENABLED=false，该配置项只可通过配置文件修改；

优化

  1. [通用] API头文件提供英文版说明；
  2. [郑商所] 优化SPBM的附加保证金算法，防止附加保证金率合约出现对冲不充分的问题；若使用此功能，柜台需配套升级至Release-004-P2，否则SPBM仍按旧算法计算，会出现总保证金不准确的问题;

修复

  1. [通用] 修复批量撤单接口中填入的报单编号全部不存在时，出现等待回报超时的问题；
  2. [通用] 修复计算期权占用保证金所用的价格类型与柜台不一致的问题；
  3. [通用] 修复资金可用比例修改后，可用资金与柜台不一致的问题；
  4. [郑商所] 修复SPBM参数包含不参与优惠的品种信息时，对应投资者出现登录报错的问题；
  5. [上期所/能源中心] 修复双交易所环境，onExchange事件推送未按客户交易权限过滤的问题；
  6. [上期所/能源中心] 修复双交易所环境，能源所的合约无法行权的问题；

[4.1.1050] - 20231017

提示

需交易郑商所业务的客户请下载、使用此版本API，同时，柜台需配套升级至Release-004及之后版本。

支持的交易所：上期所、能源中心、中金所、广期所、大商所、郑商所

兼容级别：推荐更新

新增

  1. [通用] 增加指定报单组编号功能，范围是[0,128]内的整数，客户可在启动前通过setConfig()或配置文件设置。若客户未指定报单组编号，则默认该实例的报单组编号为0;客户使用本地报单编号撤单功能时，只需保证报单、报价和行权对冲录入请求在报单组范围内单调递增即可;
  2. [通用][做市商] 增加设置回报过滤条件setReportFilter()是否启用“按报单组过滤”，true代表接收指定指定报单组的回报，false代表接收全部回报，该条件与之前的品种、合约过滤条件是并列关系;
  3. [通用] 增加低延迟网卡加速功能开关配置，配置项XNIC_ENABLED默认为true，表示启用。若设置为禁用状态，无论是否安装低延迟网卡，报撤单都使用默认的系统协议栈发送数据，不进行加速处理;
  4. [通用] 增加获取高精度纳秒级时间戳的接口getXTFNanoTimestamp();

改进

  1. [通用] API优化Onload驱动版本检测处理，若版本小于7.x或大于7.x，均提示告警日志;
  2. [通用] API 报单、报价以及成交结构体 中增加orderGroupID字段，代表所属的报单组编号;

修复

  1. [通用] API修复普通报单和衍生单的成交回报偶现TradeID字段与柜台不一致的问题;
  2. [通用] API修复 899之后的版本中 出现的实例停止后重启失败的问题;
  3. [通用] API修复冻结手续费在部分场景下计算错误的问题;
  4. [通用] API修复行权被拒后报单状态等字段未更新的问题;
  5. [通用] API修复接收流水时偶现连接断开，错误码为-5的问题;
  6. [通用] API修复可用资金的计算未包含资金比例系数的问题；
  7. [通用] API修复申报费和动态权益计算错误的问题；
  8. [通用] API修复成交查询设置时间参数，部分场景下过滤错误的问题；

[4.1.957] - 20230907

提示

非做市商业务的客户无需变更。

支持的交易所：上期所、能源中心、中金所、广期所、大商所

兼容级别：推荐更新

修复

  1. [通用][做市商] 修复AskHedgeFlag和BidHedgeFlag字段未初始化导致报价单被柜台拒单的问题；

[4.1.956] - 20230829

支持的交易所：上期所、能源中心、中金所、广期所、大商所

兼容级别：推荐更新

修复

  1. [通用] 修复流水序列号未初始化导致报错-20016 数据流水追平失败的问题；

[4.1.955] - 20230824

支持的交易所：上期所、能源中心、中金所、广期所、大商所

兼容级别：推荐更新

优化

  1. [通用] 适配Solarflare网卡7.1.3版本的onload驱动，建议将策略机的onload驱动同步更新至7.1.3；
  2. [通用] 优化发送报单时多线程互斥的保护处理；
  3. [通用] 优化日志打印，增加部分错误场景的打印数据内容；

修复

  1. [通用] 修复低延迟网卡场景下获取默认网关mac地址错误的问题；

[4.1.949] - 20230808

支持的交易所：上期所、能源中心、中金所、广期所、大商所

兼容级别：推荐更新

新增

  1. [通用] 新增配置参数RELEASE_FINISHED_ORDER_ENABLED，可以启用订单资源回收功能，释放错单和无成交的撤单，减少内存占用；
  2. [通用] 新增运行模式配置项RUN_MODE,0表示正常模式，1表示极简模式，默认为正常模式；
  3. [通用] 新增API极简运行模式，此模式下API不支持交易信息（订单和成交）的本地存储和查询，由用户自行管理；
  4. [通用] 新增按报单编号和交易所参数进行撤单的接口；

改进

  1. [通用] 优化报撤单接口的性能，支持Solarflare和Exablaze网卡的加速处理；
  2. [通用] 报单接口增加对参数有效性的判断；
  3. [通用] 新增XTFCombInstrumentID类型定义，XTFCombInstrument对象的合约编号从32字节扩展为36字节；

修复

  1. [通用] 修复本地单号撤单时，偶发报单查找不到的问题；
  2. [通用] 修复多线程访问共享资源增加保护处理以免发生潜在冲突问题；
  3. [通用] 修复报单响应和报单回报发生乱序时，IOC单（未成已撤状态）回报中的交易所编号为0的问题；

[4.1.899] - 20230626

提示

需交易做市商业务的客户请联系我司获取做市商专用API。

支持的交易所：上期所、能源中心、中金所、广期所、大商所

兼容级别：推荐更新

新增

  1. [通用][做市商] 新增支持做市商双边报价业务，可实现各交易所的双边报价请求、撤销、查询以及接收询价通知等功能，需要柜台打开做市商业务开关，且只限做市商用户使用，需使用做市商专用 API；
  2. [通用][做市商] 新增一键多条件撤单功能，可使用 API 发送一键条件撤单指令，将符合条件的所有挂单一次性全部撤销，包含单腿单与双边报价单，按前缀匹配，*代表所有字符，需使用做市商专用 API；
  3. [通用] 新增回报过滤功能，可按合约类型或合约名通配符条件匹配接收回报数据，只针对私有流数据，对话流不影响，设置回报过滤后，API 本地计算的资金仓位和柜台端结果可能不一致，登录前设置回报规则白名单，登录后设置无效；
  4. [通用] 新增询价请求功能，普通柜台可询价，但交易所询价通知，只在做市商柜台中才发送给客户；
  5. [通用] 新增用户本地单号撤单功能，需要在柜台端打开用户本地单号撤单权限，客户报单后可使用本地单号直接发起撤单指令，打开该功能后，柜台会强制校验本地报单编号投资者内递增，且本地单号上限值默认 5000000，超过上限的订单将只能使用 sysOrderID 撤单；
  6. [通用] Xele-Bot 客户端程序新增做市商相关双边报价报单、双边报价单撤销相关功能；
  7. [通用] Xele-Bot 客户端程序新增期权的行权、对冲、撤销等相关功能；
  8. [通用] API 新增投资者是否支持本地单号撤单及最大允许的本地单号的参数推送；
  9. [通用] API 合约结构 XTFInstrument 增加状态变更时间和原因等字段；

改进

  1. [通用] API 报单回报、成交回报中增加OrderType报单类型字段标识，可区分是否是报价衍生单；
  2. [通用] API 报单回报、成交回报、行权对冲回报、双边报价回报中增加 4 字节UserRef自定义字段，柜台将客户请求中内容值返回，当柜台清流时返回-1，便于客户管理订单；
  3. [通用] 样例代码优化：增加 Readme.txt 文件描述各演示代码的功能；增加多线程报单演示代码；增加做市商接口演示代码；
  4. [通用] 交易日志增加 ErrorCode 的打印：配置文件增加 TRADE_LOG_ENABLED=true 一行可以启用交易日志的打印，会稍微影响下行回报的处理，正常情况下不建议启用此调试选项；
  5. [通用] TCP 连接相关的操作系统错误码，做兼容性处理，以免和业务错误码冲突；

修复

  1. [通用] API 修复部分场景报单对象中的 channelSelectionType 未赋值的问题；
  2. [通用] 修复部分系统错误码未偏移，客户触发自成交时 API 报错“未知错误”的问题；
  3. [通用] 修复客户撤单时，部分场景提示撤单失败 50041 的问题；
  4. [通用] 修复部分场景下 double 价格精度损失造成自成交检测不准确的问题；
  5. [中金所] 修复部分中金所错误码未偏移，造成 API 连接未启动的柜台时，API 报错“超出客户限仓”的问题；

[4.1.770] - 20230511

支持的交易所：上期所、能源中心、中金所、广期所、大商所

兼容级别：推荐更新

修复

  1. [通用] 修复连续快速报单场景下，可能出现预冻结/释放乱序而引起资金计算错误的问题；

[4.1.760] - 20230412

支持的交易所：上期所、能源中心、中金所、广期所、大商所

兼容级别：推荐更新

新增

  1. [通用] 增加日志启用/禁用接口setXTFLogEnabled()；

修复

  1. [广期所/大商所] 修复广期所和大商所的行权仓位数据冻结错误；

改进

  1. [通用] 同步最新错误码表；

[4.1.755] - 20230322

提示

需交易商品期权业务的客户请升级到该版本。

支持的交易所：上期所、能源中心、中金所、广期所、大商所

兼容级别：推荐更新

新增

  1. [通用]支持上期所、能源中心、中金所、广期所、大商所商品期权交易业务，3.3版本API不支持该功能；
  2. [通用]支持上期所、能源中心、中金所、广期所、大商所商品期权行权、对冲类业务，3.3版本API不支持该功能；
  3. [通用]报单状态增加XTF_OS_Received，表示柜台收到报单请求并已通过柜台风控。此状态在交易所接受报单XTF_OS_Accepted状态之前到达,API版本需4.1.755及以上，柜台版本需Release-001及以上，3.3版本及旧4.1版本API将不会收到该回调；
  4. [通用]支持期权占用保证金计算价格类型同步柜台设为MAX（昨结算价，最新价）；
  5. [广期所/大商所]支持期权组合持仓优惠保证金业务；

修复

  1. [通用]修复stop调用之后没有onStop回调的问题；
  2. [通用]修复Example中std::map迭代器在撤单时可能失效的问题；
  3. [通用]修复Oracle Linux 8.3版本编译遇到的兼容性问题；
  4. [中金所]修复报单价计算期权保证金时，老仓的保证金按照报单价计算的问题，改成按照昨结算价计算老仓的保证金；

改进

  1. [通用]改进看穿式硬盘序列号读取方式，解决部分特殊场景采集异常的问题；
  2. [通用]单精度浮点数改成双精度浮点数，防止资金计算时精度丢失；
  3. [通用]完善示例代码：example03增加预热报单的构造和发送；example06修复状态判断的逻辑错误；
  4. [通用]XTFDataStruct.h文件定义的由API内部创建的数据结构对象中，增加用户可自定义的数据变量，以方便用户存储关联的临时数据；
  5. [通用]增加合约交易所保证金率的推送；
  6. [通用]报单和成交流水本地存储优化，增加预分配功能，减少运行时期间的动态分配；
  7. [通用]文档增加行权和对冲部分；
  8. [通用]完善快速入门手册的报单回报流程描述；

[4.1.692] - 20230214

提示

需交易大商所业务的客户请升级到该版本。

支持的交易所：上期所、能源中心、中金所、广期所、大商所

兼容级别：推荐更新

新增

  1. 日志默认写入当前目录的子目录xtf-api-log/；
  2. 修复广期所和大商所手续费计算与柜台存在偏差的问题；
  3. Release版本增加Info级别的日志记录；
  4. 报撤单接口增加多线程工作模式，在配置文件增加配置选项 ORDER_MT_ENABLED=true 可以启用多线程报单功能。默认为单线程报撤单，不启用多线程模式；

修复

  1. 修复UDP通信打开失败后，无法自动重连的问题；
  2. 修复禁用资金和仓位计算场景下，设置交易所特性没有空指针保护的问题；
  3. 修复写文件超过8G后出现SIGXFGZ信号的问题；

改进

  1. 撤单时间交易所暂不支持，当报单状态为撤销时，使用最后一次更新时间来标记撤单时间；
  2. 合约状态常量增加TransactionMatchPause | TransactionTradePause | Alarm的定义；
  3. 增加限制登录的错误码：2022；
  4. 风控事件结构体字段从investorID修改为accountID，大小为20字节；
  5. 删除未使用的接口getXTFLoginPacket；

[4.1.656] - 20230117

支持的交易所：上期所、能源中心、中金所、广期所

兼容级别：推荐更新

修复

  1. 修复上期中金冻结保证金与柜台计算不一致的问题；
  2. 修复持仓组合与拆组合导致的资金计算问题；

改进

  1. 优化使用手册文档；
  2. 规范错误码的定义；
  3. 发送TCP查询请求数据时增加多线程同步机制，以防数据交替发送造成异常；
  4. 增加在双交易所场景下的exchangeid空指针保护；

[4.1.629] - 20221219

提示

需使用广期所组合持仓与资金本地计算的客户请升级到该版本。

支持的交易所：上期所、能源中心、中金所、广期所

兼容级别：推荐更新

新增

  1. 提供资金同步接口syncFunds()，接口默认超时时间50ms（由于该功能是阻塞查询，推荐本地无法接入行情的客户使用）；
  2. XTFAccount结构体增加交割保证金字段；
  3. 中金期权空头保证金增加根据最新价和昨结算价的较大值来计算；
  4. 中金期权空头冻结保证金增加根据最新价和昨结算价的较大值来计算；
  5. 新增创建预热报单接口buildWarmOrder()；
  6. 增加昨日余额字段，与静态权益区分；
  7. 组合持仓结构体XTFCombPosition增加组合对冲标志字段combHedgeFlag；

修复

  1. 修改最后一笔流水数据History标记错误的问题；
  2. 修复FAK报单当MinVolume>1时，返回InsertType类型有误的问题；
  3. 修复柜台重新启动，API出现两次onStart()的问题；
  4. 修复网络异常中断情况下，onStop()没有通知的问题；
  5. 修复API本地缓存数据异常导致的崩溃问题；

改进

  1. 优化登录流程对AccountID的校验处理；
  2. 增加报单接口多线程不安全的注释说明；

[4.1.586] - 20221122

注意

必须在柜台升级完成后同步升级此版本。客户更新so库与头文件重新编译即可。

支持的交易所：上期所、能源中心、中金所

兼容级别：强制更新

新增

  1. 推送柜台配置的交易所特性参数；
  2. 增加对柜台版本的校验，对于版本号过低的柜台，提示不兼容；
  3. 账户字段扩展为20字节，详细变更如下： XTFAccountID类型从16字节变更为20字节； XTFAccount结构体需要关注一下对accountID的处理； 其他的结构体暂不涉及改动；
  4. 增加组合合约查询接口；
  5. 增加组合持仓查询接口；
  6. 增加交易流水的日志记录功能；
  7. 快速入门手册增加事件序列图，说明API各事件的触发顺序；

修复

  1. 修改报单出现无效合约时出现的访问非法；
  2. 修复中金所期权计算使用的手续费率错误问题；
  3. 修复中金所资金计算少了现货期权的问题；
  4. 修复柜台清流启动时本地报单编号处理冲突的问题；
  5. 修复中金所资金计算期权保证金买平时未释放的问题；
  6. 修复中金所资金期权计算平今手续费时，没有区分多空今仓数量的问题；
  7. 修复双交易所场景下计算昨持仓占用保证金错误的问题；
  8. 修复无法通过本地报单编号撤销乱序场景历史报单的问题；
  9. 修复某些场景下API登录柜台获取不到MAC地址和IP地址的问题；
  10. 修复大批量报单流水场景下登录可能超时的问题；
  11. 修复部分内存泄漏的问题；
  12. 修复使用带参数的login()接口登录时返回失败的问题；
  13. 修复getConfig接口在连续调用后使用printf格式化时可能存在string内存复用的问题；
  14. 报单响应和报单回报如果接收乱序，则不再通知用户Accepted该状态的事件；
  15. 修复报单响应和报单回报乱序时，重复创建报单对象的问题（需要用户确保交易日内LocalOrderID唯一，重复时API的按localOrderID撤单和getOrder()功能存在异常）；
  16. 修复多点登录，子账户同步报单字段错误的问题；
  17. 报单插入错误回报处理时，如果报单合约不存在，关联的合约指针对象为空。修复此场景下查询时出现的异常问题；
  18. 修复报单在不可撤销状态下依然可以发送撤单请求的问题；
  19. 修复错单回报是否历史流水字段未赋值问题，优化报单回报和成交回报是否历史流水字段，onLoadFinished()接口调用之前都赋值为true，之后都赋值为false；
  20. 修复使用手册缺失图片的问题，并提供PDF版本的使用手册；
  21. 修复配置文件DOS格式兼容性问题；

优化

  1. 日出流水数据推送处理优化，兼容未知消息类型的数据报处理；

[4.1.492] - 20221017

支持的交易所：上期所、能源中心

新增

  1. 增加示例代码Example04，演示了如何不使用配置文件的方式创建和配置API参数；

修复

  1. 修复冻结手续费计算时的手续费率错误问题；

[4.1.486] - 20221013

优化

  1. 报单插入错误回报处理优化：收到非本API报单（或协议报单）的报单插入错误回报时，自动创建XTFOrder对象，并通知用户接口；

[4.1.479] - 20221011

新增

  1. 持仓结构体XTFPosition增加今持仓量字段todayPosition；

优化

  1. UDP预热报单优化；

[4.1.475] - 20221010

新增

  1. 增加协议方式报单的示例代码Example03，演示了如何使用API登录柜台以及使用协议方式发送报撤单；
  2. 合约结构体XTFInstrument增加期权类型字段XTFOptionsType，增加获取期权对应的基础合约的接口getUnderlyingInstrument()；

[4.1.471] - 20221008

优化

  1. 合约结构体XTFInstrument中的expireDate字段，从int改成字符数组类型；

[4.1.468] - 20220930

修复

  1. 登录时偶现应答无法收到的问题；
  2. 修复报单响应和报单回报乱序时，出现realChannelID字段值不一致的问题；

[4.1.465] - 20220929

新增

  1. 增加错误码查询接口，支持错误消息内容的中英文版本；
  2. makeXTFApi()接口允许配置文件路径为空，启动API之前，通过API的setConfig()接口来设置参数；

优化

  1. 优化资金和仓位计算；
  2. XTFOrder结构体中的realChannelID字段默认为0xFF，表示无效值。当收到非0xFF时，表示realChannelI字段有效；

修复

  1. 修复XTFOrder报单状态乱序的问题，将报单状态的顺序进行检测和约束；避免报单状态可能先进入Queuing、PartTraded或者AllTraded，再进入Accepted状态。
  2. 修复同一API实例多次登录登出时偶先的崩溃问题；

[4.1.454] - 20220927

新增

  1. 数据回报处理线程增加开关配置项TCP_WORKER_BUSY_LOOP_ENABLED，如果配置为false，则不启用BusyLoop运行模式，以降低CPU核的负载。默认为true，表示启用BusyLoop运行模式。
  2. XTFExchange增加字段标记是否支持席位编号IP地址查询，如果支持IP地址查询，则可以通过getChannelIP()和getChannelIPByID()接口查询IP地址。
  3. XTFAccount增加最近一次本地撤单编号lastActionOrderID。

修复

  1. 修复裸协议报单无法收到OnRsp事件的问题。

[4.1.445] - 20220921

新增

  1. XTFInputOrder增加minVolume字段；
  2. XTFOrder增加orderMinVolume字段；

[4.1.441] - 20220920

新增

  1. 柜台在交易时段发生重启的通知接口onServerReboot()；
  2. 柜台在交易时段如果发生重启，API中断后会自动重连；
  3. 重新连接后，API会清空上一次登录的所有数据，并重新从柜台加载数据；
  4. 由于API的本地数据发生了变化，因此所有外部使用的指针数据会失效，用户需要在收到onReboot事件后，清理上一次的所有数据指针。此刻这些数据指针依然有效，当onReboot事件处理之后，数据指针将会失效。

[4.1.437] - 20220919

新增

  1. 配置文件标注线程的BusyLoop模式；
  2. XTFExchange增加tradingDay字段；
  3. XTFAccount增加lastLocalOrderID字段；

优化

  1. 完善LocalOrderID的注释说明；

[4.1.430] - 20220916

优化

  1. 时间字段从整型改成字符串类型，报单增加插入日期、更新时间、撤单时间；
  2. 撤单时间字段交易所暂不支持，使用最后一次更新时间来标记撤单时间；
  3. 收到错误的数据包后，断开TCP连接；
  4. 行情结构体未使用的字段标记说明；
  5. XTFAccount接口功能添加注释说明；
  6. xtf_trader_api.config TCP接收线程注释修改为回报处理线程；
  7. 完善看穿式监管信息采集，如果发生错误则禁止登录；

[4.1.425] - 20220915

优化

  1. XTFOrder启用insertTime字段；
  2. XTFOrderFilter和XTFTradeFilter增加时间字段含义的说明；

[4.1.414] - 20220913

修复

  1. 修复没有席位时无法获得交易所ID字符串的问题；
  2. 修复realChannelID查询为0的问题；
  3. onBookUpdate接口参数由引用对象改成指针对象；

[4.1.411] - 20220909

新增

  1. 新增onCancelOrder接口专门用于处理撤单回报的场景；

优化

  1. onOrder接口去掉actionCode参数，移入XTFOrder结构体内部；去掉XTFError参数，改成errorCode；调整参数顺序和个数；

删除

  1. 删除onOrder接口里撤单的相关通知；

[4.1.398] - 20220907

优化

  1. Example01-演示API登录登出和报单撤单功能；
  2. Example02-演示使用一个简单策略基于行情驱动进行报撤单功能；

[4.1.395] - 20220906

新增

  1. 按条件查询报单数据的接口findOrders()；
  2. 按条件查询成交数据findTrades()；

优化

  1. 优化预热功能以提高穿透性能；
  2. 优化API接口方法的注释说明；

修复

  1. 修复login()接口登录失败的问题；
  2. 修复部分报单回报没有通知回调的问题；

[4.1.376] - 20220831

新增

  1. 按柜台流水号撤销报单；
  2. 按柜台流水号批量撤销报单；

[4.1.372] - 20220830

新增

  1. 初始版本功能发布。