ContextQMD
Back to Wondertrader

OES-API Update Guide {#update_guide}

src/API/oesApi0.17.5.8/include/oes_api/UpdateGuide.md

0.9.998.2 KB
Original Source

OES-API Update Guide {#update_guide}

OesApi 版本更新说明

完整变更说明请参考文档:
  • include/oes_api/CHANGELOG.md
  • include/oes_api/UpdateGuide.md

OES_0.17.5.8 / 2022-05-13

1. API更新概要

  1. 服务端兼容 v0.15.5.1 版本API, 客户可以选择不升级 (建议升级至当前版本)
  2. 股东账户交易权限枚举 (eOesTradingPermissionT) 中新增: - 公司债/企业债交易权限 (OES_PERMIS_CORPORATE_BOND)
  3. 新增如下错误码
| 错误码 | 描述

| ---- | ---------------
| 1299 | 股东账户没有交易公司债/企业债的权限

2. 服务端更新概要

  1. 完善对新债券业务的支持
  2. 其它细节完善和优化

3. 注意事项

  • 无

OES_0.17.5.7 / 2022-04-02

1. API更新概要

  1. 服务端兼容 v0.15.5.1 版本API, 客户可以选择不升级 (建议升级至当前版本)
  2. 优化异步API的超时检查处理, 避免频繁输出委托通道的超时检查日志

2. 服务端更新概要

  1. 完善对新债券业务的支持
  2. 其它细节完善和优化

3. 注意事项

  • 无

OES_0.17.5.6 / 2022-01-14

1. API更新概要

  1. 服务端兼容 v0.15.5.1 版本API, 客户可以选择不升级 (建议升级至当前版本)
  2. 新增如下错误码
| 错误码 | 描述

| ---- | ---------------
| 1449 | 不能偿还非临近到期日负债
| 1450 | 可转出资产不足

2. 服务端更新概要

  1. 完善信用业务防绕标控制
  2. 其它细节完善和优化

3. 注意事项

  1. API收到的市场状态信息中将新增沪市'新债券交易平台'和'衍生品集中竞价交易平台'的信息

OES_0.17.5.4 / 2021-11-23

1. API更新概要

  • 无

2. 服务端更新概要

  1. 支持上交所产品文件中的日中交易回转参数
  2. 其它细节完善和优化

3. 注意事项

  • 无

OES_0.17.5.3 / 2021-11-05

1. API更新概要

  1. 服务端兼容 v0.15.5.1 版本API, 客户可以选择不升级 (建议升级至当前版本)
  2. 优化出入金金额的精度处理，自动将出入金金额的有效精度向下舍入分，以方便前端使用
  3. 新增如下交易限制定义 - 禁止交易上交所新债券平台 (OES_LIMIT_SSE_BOND_PLATFORM) - 禁止市价委托 (OES_LIMIT_MARKET_ORDER)
  4. 投资者分类 (eOesInvestorClassT) 中宏定义调整 - 新增 专业投资者 （OES_INVESTOR_CLASS_PROFESSIONAL）
  5. 为支持客户端设置委托方式, API新增如下接口
| API                          | 描述

| ---------------------------- | ---------------
| OesApi_SetDefaultEntrustWay  | 设置客户端默认的委托方式
| OesApi_GetDefaultEntrustWay  | 获取客户端默认的委托方式
| OesApi_SetAssignedEntrustWay | 设置客户端会话使用的委托方式
| OesApi_GetAssignedEntrustWay | 获取客户端会话使用的委托方式

6. 新增如下错误码

| 错误码 | 描述
| ---- | ---------------
| 1041 | 需要再次尝试
| 1042 | 非法的委托方式
| 1276 | 限制交易上交所新债券平台
| 1297 | 禁止ETF申购
| 1298 | 禁止ETF赎回

2. 服务端更新概要

  1. 上海新债券平台指定交易相关业务调整
  2. 支持客户使用主柜密码登录系统 (只适用于特定券商)
  3. 支持上场时对每个资金账户进行预冻结佣金
  4. 支持对接多主柜台节点业务
  5. 其���细节完善和优化

3. 注意事项

  • 无

OES_0.17.4.8 / 2022-05-13

1. API更新概要

  1. 服务端兼容 v0.15.5.1 版本API, 客户可以选择不升级 (建议升级至当前版本)
  2. 股东账户交易权限枚举 (eOesTradingPermissionT) 中新增: - 公司债/企业债交易权限 (OES_PERMIS_CORPORATE_BOND)
  3. 新增如下错误码
| 错误码 | 描述

| ---- | ---------------
| 1299 | 股东账户没有交易公司债/企业债的权限

2. 服务端更新概要

  1. 完善对新债券业务的支持
  2. 其它细节完善和优化

3. 注意事项

  • 无

OES_0.17.4.7 / 2022-04-02

1. API更新概要

  1. 服务端兼容 v0.15.5.1 版本API, 客户可以选择不升级 (建议升级至当前版本)
  2. 优化异步API的超时检查处理, 避免频繁输出委托通道的超时检查日志

2. 服务端更新概要

  1. 完善对新债券业务的支持
  2. 其它细节完善和优化

3. 注意事项

  • 无

OES_0.17.4.6 / 2022-01-14

1. API更新概要

  1. 服务端兼容 v0.15.5.1 版本API, 客户可以选择不升级 (建议升级至当前版本)
  2. 新增如下错误码
| 错误码 | 描述

| ---- | ---------------
| 1449 | 不能偿还非临近到期日负债
| 1450 | 可转出资产不足

2. 服务端更新概要

  1. 完善信用业务防绕标控制
  2. 其它细节完善和优化

3. 注意事项

  1. API收到的市场状态信息中将新增沪市'新债券交易平台'和'衍生品集中竞价交易平台'的信息

OES_0.17.4.3 / 2021-11-08

1. API更新概要

  1. 服务端兼容 v0.15.5.1 版本API, 客户可以选择不升级 (建议升级至当前版本)
  2. 优化出入金金额的精度处理，自动将出入金金额的有效精度向下舍入分，以方便前端使用
  3. 新增如下交易限制定义 - 禁止交易上交所新债券平台 OES_LIMIT_SSE_BOND_PLATFORM - 禁止市价委托 OES_LIMIT_MARKET_ORDER
  4. 新增如下错误码
| 错误码 | 描述

| ---- | ---------------
| 1276 | 限制交易上交所新债券平台

2. 服务端更新概要

  1. 上海新债券平台指定交易相关业务调整
  2. 其它细节完善和优化

3. 注意事项

  • 无

OES_0.17.4.2 / 2021-10-18

1. API更新概要

  1. 服务端兼容 v0.15.5.1 版本API, 客户可以选择不升级
  2. c++样例代码中补充查询对端节点资金资产信息的接口

2. 服务端更新概要

  1. 修复盘前自动划拨资金概率性失效的问题
  2. 其它细节完善和优化

3. 注意事项

  • 无

OES_0.17.4.1 / 2021-09-24

1. API更新概要

  1. 服务端兼容 v0.15.5.1 版本API, 客户可以选择不升级
  2. fix: 尝试修复Windows平台下偶然发生一直检测不到网络连接异常的问题

2. 服务端更新概要

  1. 支持现货集中度控制
  2. 完善管理端数据访问权限控制

3. 注意事项

  • 无

OES_0.17.3.1 / 2021-08-26

1. API更新概要

  1. 服务端兼容 v0.15.5.1 版本API, 客户可以选择不升级
  2. 新增 计价方式 eOesPricingMethodT 枚举类型定义
  3. 证券禁止交易标识 eOesSecuritySuspFlagT 中宏定义调整
    • 新增 因闭市而禁止交易 OES_SUSPFLAG_MARKET_CLOSE
  4. 交易平台类型 eOesPlatformIdT 中宏定义调整
    • 新增 国际市场互联平台 OES_PLATFORM_INTERNATIONAL_MARKET (暂未对接)
    • 新增 新债券交易平台 OES_PLATFORM_BOND_TRADING
  5. 现货产品基础信息 OesStockBaseInfoT 中新增如下字段
    • 新增 计价方式 pricingMethod 字段

2. 服务端更新概要

  1. 支持上交所和深交所新债券交易系统改造
  2. 其它细节完善和优化

3. 注意事项

  1. 证券子类别 eOesSubSecurityTypeT 中的字段说明变更如下
    • [上交所] 新债券交易系统上线后, 企业债为"CPF" (存量企业债中部分延用"CBF"), 政府支持债为"GBF" (存量政府支持债中部分延用"CPF")
      • OES_SUB_SECURITY_TYPE_BOND_GBF <国债 (国债/地方债/政策性金融债/上交所政府支持债)>
      • OES_SUB_SECURITY_TYPE_BOND_CBF <企业债 (深交所企业债/上交所存量企业债)>
      • OES_SUB_SECURITY_TYPE_BOND_CPF <公司债 (公司债/上交所企业债/上交所存量政府支持债)>
      • OES_SUB_SECURITY_TYPE_BOND_FBF <金融机构发行债券 (仅适用于深交所, 上交所已废弃)>
    • [深交所] 未变更

OES_0.17.2.1 / 2021-08-09

1. API更新概要

  1. 服务端兼容 v0.15.5.1 版本API, 客户可以选择不升级 (建议升级, 以更好的支持两地交易业务)
  2. 为更好的支持两地交易业务, API新增如下接口

    • 增加同步API接口

      API描述
      OesApi_QueryColocationPeerCashAsset查询两地交易时对端结点的资金资产信息

    • 增加异步API接口

      API描述
      OesAsyncApi_QueryColocationPeerCashAsset查询两地交易时对端结点的资金资产信息
  3. 出入金委托请求 OesFundTrsfReqT 结构调整
    • 重命名出入金转账类型 isAllotOnly => fundTrsfType字段 (保持兼容)
    • 出入金转账类型 eOesFundTrsfTypeT 调整:
      • 新增 '沪深OES之间的内部资金划拨 OES_FUND_TRSF_TYPE_OES_TO_OES'
  4. 客户端总览信息 OesClientOverviewT 中新增如下字段
    • 新增 客户在本结点的初始资金资产占比(百分比) initialCashAssetRatio
    • 新增 是否支持两地交易内部资金划拨 isSupportInternalAllot 字段
  5. 券商参数信息 OesBrokerParamsInfoT 中新增如下字段
    • 新增 服务端是否支持两地交易内部资金划拨 isSupportInternalAllot 字段
    • 新增 上证风险警示板证券单日买入数量限制 sseRiskWarningSecurityBuyQtyLimit 字段
    • 新增 深证风险警示板证券单日买入数量限制 szseRiskWarningSecurityBuyQtyLimit 字段
  6. 新增如下错误码
| 错误码 | 描述

| ---- | ---------------
| 1294 | 无可用对端系统节点
| 1295 | 对端限制入金
| 1296 | 对端限制出金

2. 服务端更新概要

  1. 支持客户在沪深结点之间实时划拨可用资金

3. 注意事项

  • 无

OES_0.17.1.4 / 2021-09-10

1. API更新概要

  1. 服务端兼容 v0.15.5.1 版本API, 客户可以选择不升级 (建议升级, 以支持信用业务)
  2. 重构领域模型定义头文件的组织结构, 提取单独的常量定义文件, 以及单独的信用业务、期权业务领域模型定义文件
  3. 为支持信用业务, API新增如下接口

    • 增加同步API接口

      API描述
      OesApi_SendCreditRepayReq可以指定待归还合约编号的融资融券负债归还请求
      OesApi_SendCreditCashRepayReq直接还款(现金还款)请求
      OesApi_QueryCrdCreditAsset查询信用资产信息
      OesApi_QueryCrdUnderlyingInfo查询融资融券可充抵保证金证券及融资融券标的信息
      OesApi_QueryCrdCashPosition查询融资融券资金头寸信息 (可融资头寸信息)
      OesApi_QueryCrdSecurityPosition查询融资融券证券头寸信息 (可融券头寸信息)
      OesApi_QueryCrdHolding查询信用持仓信息
      OesApi_QuerySingleCrdHolding查询单条信用持仓信息
      OesApi_QueryCrdDebtContract查询融资融券合约信息
      OesApi_QueryCrdDebtJournal查询融资融券合约流水信息
      OesApi_QueryCrdCashRepayOrder查询融资融券直接还款信息
      OesApi_QueryCrdSecurityDebtStats查询融资融券客户单证券负债统计信息
      OesApi_QueryCrdExcessStock查询融资融券余券信息
      OesApi_QueryCrdInterestRate查询融资融券息费利率
      OesApi_GetCrdDrawableBalance查询融资融券业务最大可取资金
      OesApi_GetCrdCollateralTransferOutMaxQty查询融资融券担保品可转出的最大数量

    • 增加异步API接口

      API描述
      OesAsyncApi_SendCreditRepayReq可以指定待归还合约编号的融资融券负债归还请求
      OesAsyncApi_SendCreditCashRepayReq直接还款(现金还款)请求
      OesAsyncApi_QueryCrdCreditAsset查询信用资产信息
      OesAsyncApi_QueryCrdUnderlyingInfo查询融资融券可充抵保证金证券及融资融券标的信息
      OesAsyncApi_QueryCrdCashPosition查询融资融券资金头寸信息 (可融资头寸信息)
      OesAsyncApi_QueryCrdSecurityPosition查询融资融券证券头寸信息 (可融券头寸信息)
      OesAsyncApi_QueryCrdHolding查询信用持仓信息
      OesAsyncApi_QuerySingleCrdHolding查询单条信用持仓信息
      OesAsyncApi_QueryCrdDebtContract查询融资融券合约信息
      OesAsyncApi_QueryCrdDebtJournal查询融资融券合约流水信息
      OesAsyncApi_QueryCrdCashRepayOrder查询融资融券直接还款信息
      OesAsyncApi_QueryCrdSecurityDebtStats查询融资融券客户单证券负债统计信息
      OesAsyncApi_QueryCrdExcessStock查询融资融券余券信息
      OesAsyncApi_QueryCrdInterestRate查询融资融券息费利率
      OesAsyncApi_GetCrdDrawableBalance查询融资融券业务最大可取资金
      OesAsyncApi_GetCrdCollateralTransferOutMaxQty查询融资融券担保品可转出的最大数量
  4. 回报消息 OesRptMsgBodyT 中
    • 新增 '融资融券合约变动回报信息 OesCrdDebtContractReportT' 回报推送
      • 对应回报消息类型 '融资融券合约变动信息 OESMSG_RPT_CREDIT_DEBT_CONTRACT_VARIATION'
      • 对应回报消息体 OesRptMsgBodyT.crdDebtContractRpt
    • 新增 '融资融券合约流水回报信息 OesCrdDebtJournalReportT' 回报推送
      • 对应回报消息类型 '融资融券合约流水信息 OESMSG_RPT_CREDIT_DEBT_JOURNAL'
      • 对应回报消息体 OesRptMsgBodyT.crdDebtJournalRpt
    • 新增 '融资融券直接还款执行报告 OesCrdCashRepayReportT' 消息的结构体定义
      • 对应回报消息类型 '融资融券合约变动信息 OESMSG_RPT_CREDIT_CASH_REPAY_REPORT'
      • 对应回报消息体 OesRptMsgBodyT.crdDebtCashRepayRpt
  5. 查询现货产品信息接口调整
    • 查询现货产品信息过滤条件 OesQryStockFilterT中:
      • 新增查询条件 融资融券担保品标识 crdCollateralFlag
      • 新增查询条件 融资标的标识 crdMarginTradeUnderlyingFlag
      • 新增查询条件 融券标的标识 crdShortSellUnderlyingFlag
      • 新增查询条件 历史合约标识 historyContractFlag
    • '现货产品信息 OesStockBaseInfoT / OesStockItemT' 中新增融资融券扩展字段:
      • 新增 融资融券可充抵保证金证券的交易状态 isCrdCollateralTradable 字段
      • 新增 是否为高流通性证券 isHighLiquidity 字段
      • 新增 可充抵保证金折算率 collateralRatio 字段
      • 新增 融资买入保证金比例 marginBuyRatio 字段
      • 新增 融券卖出保证金比例 shortSellRatio 字段
      • 新增 公允价格 fairPrice 字段
  6. 委托拒绝 OesOrdRejectT 中增加如下字段
    • 业务类型 businessType
  7. 委托回报和委托信息 OesOrdCnfmT / OesOrdItemT 中增加如下字段
    • 业务类型 businessType
    • 归还模式(仅适用于卖券还款委托) repayMode
    • 强制标志 mandatoryFlag
  8. 成交回报和成交信息 OesTrdCnfmT / OesTrdItemT 中增加如下字段
    • 业务类型 businessType
    • 强制标志 mandatoryFlag
    • 所有者类型 ownerType
  9. 股票持仓回报和股票持仓信息 OesStkHoldingReportT / OesStkHoldingItemT 中增加如下字段
    • 信用持仓标识 isCreditHolding
    • 直接还券可用持仓 repayStockDirectAvlHld
    • 直接还券冻结持仓 collateralRepayDirectQty
    • 增加证券头寸可用数量以及客户该证券融资融券负债统计相关字段
  10. 客户资金回报和客户资金信息 OesCashAssetReportT / OesCashAssetItemT 中增加如下字段
    • 日中归还债务的累计金额 totalRepaidAmt
    • 日中为归还债务而在途冻结的金额 repayFrzAmt
    • 增加总资产、总负债、融资买入可用授信额度、资金头寸可用余额、证券持仓总市值等融资融券负债统计相关字段
  11. 券商参数信息 OesBrokerParamsInfoT 中增加如下字段
    • 当前会话对应的业务类型 currentBusinessType
    • 客户代码 custId
    • 信用业务参数 creditExt 子结构:
      • 维持担保比安全线 safetyLineRatio
      • 维持担保比警戒线 warningLineRatio
      • 维持担保比平仓线 liqudationLineRatio
      • 是否支持使用 '仅归还息费' 模式归还融资融券负债的息费 isRepayInterestOnlyAble
    • 期权业务参数 creditExt 子结构
      • 保证金盘中追保线 marginCallLineRatio
      • 保证金盘中平仓线 liqudationLineRatio
      • 保证金即时处置线 marginDisposalLineRatio
  12. 客户端总览信息 OesClientOverviewT 中增加如下字段
    • 当前会话对应的业务类型 currentBusinessType
  13. 通知消息回报 OesNotifyInfoReportT 中增加如下字段
    • 业务类型 businessType
    • 证券代码 securityId
    • 市场代码 mktId
    • 通知内容长度 contentLen
  14. 新增如下错误码
| 错误码 | 描述

| ---- | ---------------
| 1039 | 非法的指令类型
| 1040 | 数据已存在
| 1291 | 限制入金
| 1292 | 限制出金
| 1293 | 无可用现货系统节点
| 1401 | 保证金可用余额不足
| 1402 | 可用还款资金不足
| 1403 | 客户可用两融总额度不足
| 1404 | 券商可用两融总额度不足
| 1405 | 客户可用融资额度不足
| 1406 | 券商可用融资额度不足
| 1407 | 客户可用融券额度不足
| 1408 | 券商可用融券额度不足
| 1409 | 可用融资头寸不足
| 1410 | 可用融券头寸不足
| 1411 | 无可用融资头寸
| 1412 | 无可用融券头寸
| 1413 | 非法的头寸性质
| 1414 | 单笔委托融资金额超上限
| 1415 | 单笔委托融券规模超上限
| 1416 | 禁止担保品转入
| 1417 | 禁止担保品转出
| 1418 | 禁止融资买入
| 1419 | 禁止卖券还款
| 1420 | 禁止直接还款
| 1421 | 禁止融券卖出
| 1422 | 禁止买券还券
| 1423 | 禁止直接还券
| 1424 | 禁止董监高或大股东的融资融券交易
| 1425 | 禁止提交限售股份为担保物
| 1426 | 禁止个人投资者提交解除限售存量股份为担保物
| 1427 | 禁止大小非开展该证券的融资融券交易
| 1428 | 禁止其他股东角色开展该证券的融资融券交易
| 1429 | 无效的担保品状态
| 1430 | 非担保证券
| 1431 | 非融资标的证券
| 1432 | 非融券标的证券
| 1433 | 非融资负债
| 1434 | 非融券负债
| 1435 | 非法的融资融券负债类型
| 1436 | 非法的融资融券归还模式
| 1437 | 非法的担保证券划转指令类型
| 1438 | 无可归还的负债
| 1439 | 不能归还当日开仓的合约
| 1440 | 不能归还已了结的合约
| 1441 | 指定合约的负债证券非委托归还的证券
| 1442 | 还券数量超过融券合约待归还数量
| 1443 | 未找到融资融券合约信息
| 1444 | 未通过维保比检查
| 1445 | 申报价格不得低于最近成交价
| 1446 | 信用合同不存在或者状态异常
| 1447 | 信用客户处于监管黑名单
| 1448 | 券商深圳市场融资融券专用交易单元未配置
| 15xx | 未通过集中度检查

2. 服务端更新概要

  1. 支持信用业务
    • 担保品买入
    • 担保品卖出
    • 担保品转入
    • 担保品转出
    • 融资买入
    • 卖券还款
    • 直接还款
    • 融券卖出
    • 买券还券
    • 直接还券

3. 注意事项

  1. v0.17.1.4版本API在v0.17.0.11版本API基础上做了如下调整, 客户端需替换API并重新编译, 以支持信用业务
    • 调整资金回报和持仓回报的融资融券业务扩展字段定义, 改为内嵌统一的信用资产和单证券负债统计信息结构体定义
      • 调整 '信用资产基础信息 OesCrdCreditAssetBaseInfoT' 结构体定义
      • 重命名 证券持仓市值 holdingMarketCap => collateralHoldingMarketCap (字段取值含义也调整为包含担保品转出冻结和直接还券冻结在内的持仓总市值)
    • 调整 '客户单证券融资融券负债统计基础信息 OesCrdSecurityDebtStatsBaseInfoT' 结构体定义
      • 删除 '证券持仓市值 holdingMarketCap' 等市值字段
      • 删除 '证券名称 securityName' 字段
      • 新增市值计算使用的证券价格、证券头寸可用数量等字段
    • '资金回报 OesCashAssetReportT'、'资金信息查询 OesCashAssetItemT' 中
      • 增加融资买入可用授信额度、资金头寸可用余额、证券持仓总市值等融资融券负债统计相关字段
    • '持仓回报 OesStkHoldingReportT'、'持仓信息查询 OesStkHoldingItemT' 中
      • 调整 总持仓数量 sumHld 字段取值含义 => 包含担保品转出冻结和直接还券冻结在内的总持仓
      • 增加证券头寸可用数量、融资负债金额等融资融券负债统计相关字段
    • '通知消息回报 OesNotifyInfoReportT' 中
      • 增加 '证券代码' 和 '市场代码' 字段
      • 调整通知内容不定长, 并增加 '通知内容实际长度' 字段
    • 其他调整详见 OES-API Change Log 说明

OES_0.16.2.1 / 2021-04-20

1. API更新概要

  1. 服务端兼容 v0.15.5.1 版本API, 但建议升级到0.16.0.3及之后版本, 以支持期权业务

  2. fix: 增加对Windows下的CPU绑定操作的支持, 并完善Windows下的进程号、线程号处理

  3. 证券属性枚举(eOesSecurityAttributeT) 中新增 '科创板标记 (OES_SECURITY_ATTR_KSH)' 定义, 用于标识科创板股票、科创板CDR、科创板ETF、科创板LOF及科创板可转债等具有科创板属性的证券

  4. 市场类型枚举(eOesMarketIdT) 中新增 '港股(OES_MKT_EXT_HK)' 定义, 用于且仅用于跨沪深港ETF的成分股查询

  5. 为异步API增加内置的查询通道，并整合查询通道管理和查询接口到异步API中

    • 增加查询通道相关的配置接口

      API描述
      OesAsyncApi_SetBuiltinQueryable返回是否启用内置的查询通道 (即启动异步API时自动创建内置的查询通道)
      OesAsyncApi_IsBuiltinQueryable返回是否启用内置的查询通道
      OesAsyncApi_GetBuiltinQueryChannelRef返回内置的查询通道的会话信息

    • 增加异步API查询接口

      API描述
      OesAsyncApi_GetTradingDay获取当前交易日
      OesAsyncApi_GetClientOverview获取客户端总览信息
      OesAsyncApi_QuerySingleCashAsset查询单条资金资产信息
      OesAsyncApi_QuerySingleStkHolding查询单条股票持仓信息
      OesAsyncApi_QuerySingleOrder查询单条委托信息
      OesAsyncApi_QueryOrder查询所有委托信息
      OesAsyncApi_QueryTrade查询成交信息
      OesAsyncApi_QueryCashAsset查询客户资金信息
      OesAsyncApi_QueryStkHolding查询股票持仓信息
      OesAsyncApi_QueryLotWinning查询新股配号、中签信息
      OesAsyncApi_QueryCustInfo查询客户信息
      OesAsyncApi_QueryInvAcct查询证券账户信息
      OesAsyncApi_QueryCommissionRate查询佣金信息
      OesAsyncApi_QueryFundTransferSerial查询出入金流水
      OesAsyncApi_QueryIssue查询证券发行产品信息
      OesAsyncApi_QueryStock查询现货产品信息
      OesAsyncApi_QueryEtf查询ETF申赎产品信息
      OesAsyncApi_QueryEtfComponent查询ETF成份证券信息
      OesAsyncApi_QueryMarketState查询市场状态信息
      OesAsyncApi_QueryCounterCash查询主柜资金信息
      OesAsyncApi_QueryBrokerParamsInfo查询券商参数信息

    • 样例代码参见: samples/oes_sample_c/03_oes_async_api_sample.c

  6. 增加辅助的异步API接口, 以支持对通信线程、回调线程等异步API线程进行初始化处理

    API描述
    OesAsyncApi_SetOnCommunicationThreadStart设置通信线程的线程初始化回调函数
    OesAsyncApi_SetOnCallbackThreadStart设置回调线程的线程初始化回调函数
    OesAsyncApi_SetOnIoThreadStart设置异步I/O线程的线程初始化回调函数

  7. 增加辅助的会话管理接口

    API描述
    OesAsyncApi_DefaultOnConnect连接完成后处理的默认实现
    OesApi_GetClientId返回通道对应的客户端编号

2. 服务端更新概要

  1. 增加对跨沪深港ETF申购赎回业务的支持
  2. 增加对上交所基础设施基金(REITS)的支持
  3. 增加深交所风险警示证券的适当性管理和买入限额控制
  4. 其它细节完善和优化

OES_0.16.1.10 / 2021-01-29

1. API更新概要

  1. 服务端兼容 v0.15.5.1 版本API, 但建议升级到0.16.0.3及之后版本, 以支持期权业务
  2. 完善Windows平台下的CPU绑定支持
  3. 增加辅助异步API接口 | API | 描述 | | ------------------------------------------| -------------------- | | OesAsyncApi_SetOnCommunicationThreadStart | 设置通信线程的线程初始化回调函数 | | OesAsyncApi_SetOnCallbackThreadStart | 设置回调线程的线程初始化回调函数 | | OesAsyncApi_SetOnIoThreadStart | 设置异步I/O线程的线程初始化回调函数 | | OesAsyncApi_DefaultOnConnect | 连接完成后处理的默认实现 (执行默认的回报订阅处理) |

2. 服务端更新概要

  1. 支持上交所TDGW流式接口交易网关对接
  2. 其它细节完善和优化

OES_0.16.1.9 / 2020-11-20

1. API更新概要

  1. 服务端兼容 v0.15.5.1 版本API, 但建议升级到0.16.0.3及之后版本, 以支持期权业务
  2. 证券子类别枚举(eOesSubSecurityTypeT) 中: - 新增 基础设施基金(OES_SUB_SECURITY_TYPE_FUND_REITS)
  3. 股东账户交易权限枚举(eOesTradingPermissionT) 中: - 字段重命名 基础设施基金交易权限(OES_PERMIS_INFRASTRUCTURE_FUND => OES_PERMIS_REITS)
  4. 证券属性枚举(eOesSecurityAttributeT) 中: - 删除 基础设施基金(OES_SECURITY_ATTR_INFRASTRUCTURE_FUND)
  5. 重命名错误码的宏定义 - 1290, 股东账户没有交易基础设施基金的权限 (OESERR_NO_INFRASTRUCTURE_FUND_PERM => OESERR_NO_REITS_PERM)
  6. 增加辅助接口 | API | 描述 | | ------------------------------| -------------------- | | OesApi_GetClientType | 返回通道对应的客户端类型 | | OesApi_GetClientStatus | 返回通道对应的客户端状态 | | OesApi_GetBusinessType | 返回通道对应的业务类型 | | OesApi_IsBusinessSupported | 返回会话是否支持指定的业务类别 | | OesApi_SetRetainExtDataAble | 设置是否保留(不清空)由应用层自定义使用的扩展存储空间数据 (__extData) | | OesApi_IsRetainExtDataAble | 返回是否保留(不清空)由应用层自定义使用的扩展存储空间数据 | | OesApi_SetThreadBusinessType | 设置当前线程登录OES时所期望对接的业务类型 (正常情况下无需调用) | | OesApi_GetThreadBusinessType | 返回当前线程登录OES时所期望对接的业务类型 |

2. 服务端更新概要

  1. 完善对深交所基础设施基金产品交易的支持
  2. 其它细节完善和优化

OES_0.16.1.7 / 2020-09-30

1. API更新概要

  1. 服务端兼容 v0.15.5.1 版本API, 但建议升级到0.16.0.3及之后版本, 以支持期权业务
  2. 新增 证券属性定义(eOesSecurityAttributeT) 枚举类型
  3. 股东账户交易权限枚举(eOesTradingPermissionT)中新增:
    • 可转换公司债券交易权限 (OES_PERMIS_CONVERTIBLE_BOND)
    • 基础设施基金交易权限 (OES_PERMIS_INFRASTRUCTURE_FUND)
  4. '现货产品基础信息 (OesStockBaseInfoT)' 中启用 证券属性 (securityAttribute) 字段
  5. '证券发行基础信息(OesIssueBaseInfoT)' 中启用 证券属性 (securityAttribute) 字段
  6. 调整错误码
    • 新增 '1289, 股东账户没有交易可转换公司债券的权限'
    • 新增 '1290, 股东账户没有交易基础设施基金的权限'

2. 服务端更新概要

  1. 支持可转换公司债券的适当性检查
  2. 支持上交所科创板ETF和科创板LOF产品的交易
  3. 支持深交所基础设施基金产品的交易及适当性检查
  4. 其它细节完善和优化

OES_0.16.1.4 / 2020-08-28

1. API更新概要

  1. 服务端兼容 v0.15.5.1 版本API, 但建议升级到0.16.0.3及之后版本, 以支持期权业务
  2. fix: 完备Windows平台下的WSACleanup资源释放处理, 避免额外调用WSACleanup导致外部系统的网络操作异常
  3. fix: 修复Win64下不能正确获取纳秒级时间戳的问题
  4. fix: 修复MinGW下 struct timespec 结构体未按64位对齐的问题
  5. API结算单重复确认不再返回错误
  6. '客户端总览信息 (OesClientOverviewT)' 中新增如下字段
    • 新增 最大委托笔数限制 (maxOrdCount) 字段
  7. 为异步API增加用于返回尚未被处理的剩余数据数量的辅助接口 | API | 描述 | | ----------------------------------------| -------------------- | | OesAsyncApi_GetAsyncQueueTotalCount | 返回异步API累计已入队的消息数量 | | OesAsyncApi_GetAsyncQueueRemainingCount | 返回队列中尚未被处理的剩余数据数量 |

2. 服务端更新概要

  1. 创业板注册制业务的细节调整
  2. 完善系统在异常场景下24小时持续运行的可靠性
  3. 新增事中风控处理 - 风控规则1: 客户最大委托笔数限制, 触发后客户被限制开仓 - 风控规则2: 营业部委托流水号限制, 触发后营业部所有客户被限制开仓
  4. 其它细节完善和优化

OES_0.16.1.2 / 2020-07-07

1. API更新概要

  1. 服务端兼容 v0.15.5.1 版本API, 但建议升级到0.16.0.3及之后版本, 以支持期权业务
    • 如果使用到了时间戳字段下的微秒时间, 则需要升级最新的API, 因为时间戳字段已全部升级为纳秒级时间戳。具体请参见注意事项说明
  2. fix: 修复在Win32下因为对齐问题导致指针位置不正确的BUG (正常不会触发, 只有在启用异步API的异步回调处理时才会触发)
  3. 异步API新增如下接口 | API | 描述 | | ------------------------------------- | -------------------- | | OesAsyncApi_SendReportSynchronization | 发送回报同步消息接口 | | OesAsyncApi_IsAllTerminated | 检查所有线程是否均已安全退出 |
  4. 同步API新增如下接口 | API | 描述 | | ------------------------------------- | -------------------- | | OesApi_GetChannelGroupLastRecvTime | 返回通道组最近接收消息时间 | | OesApi_GetChannelGroupLastSendTime | 返回通道组最近发送消息时间 | | OesApi_HasStockStatus | 返回现货产品是否具有指定状态 | | __OesApi_CheckApiVersion | 检查API版本是否匹配 (检查API头文件和库文件的版本是否匹配) |
  5. 为支持创业板注册制改革, 现货产品信息 (OesStockItemT) 中新增如下字段: | 字段 | 描述 | | -------------------------- | -------------------- | | isRegistration | 是否注册制 | | securityStatus | 证券状态 | | securityAttribute | 证券属性 (保留字段) | | isCrdMarginTradeUnderlying | 是否为融资标的 | | isCrdShortSellUnderlying | 是否为融券标的 | | isCrdCollateral | 是否为融资融券担保品 | | isNoProfit | 是否尚未盈利 | | isWeightedVotingRights | 是否存在投票权差异 | | isVie | 是否具有协议控制框架 | | lmtBuyQtyUnit | 限价买入单位 (重命名 buyQtyUnit) | | lmtSellQtyUnit | 限价卖出单位 (重命名 sellQtyUnit) | | mktBuyQtyUnit | 市价买入单位 | | mktSellQtyUnit | 市价卖出单位 | | parValue | 面值 (重命名 parPrice) | | auctionLimitType | 连续交易时段的有效竞价范围限制类型 | | auctionReferPriceType | 连续交易时段的有效竞价范围基准价类型 | | auctionUpDownRange | 连续交易时段的有效竞价范围涨跌幅度 | | listDate | 上市日期 | | maturityDate | 到期日期 (仅适用于债券等有发行期限的产品) | | underlyingSecurityId | 基础证券代码 |
  6. 为支持创业板注册制改革, 证券发行信息 (OesIssueItemT) 中新增如下字段: | 字段 | 描述 | | -------------------------- | -------------------- | | isRegistration | 是否注册制 | | securityAttribute | 证券属性 (保留字段) | | isNoProfit | 是否尚未盈利 | | isWeightedVotingRights | 是否存在投票权差异 | | isVie | 是否具有协议控制框架 | | alotRecordDay | 配股股权登记日 | | alotExRightsDay | 配股股权除权日 |
  7. 查询ETF成份证券信息接口调整
    • 查询过滤条件 (OesQryEtfComponentFilterT) 中:
      • 查询条件 ETF基金申赎代码 (fundId) 字段不再是必填项
      • 新增查询条件 ETF基金市场代码 (fundMktId) 字段
    • ETF成份证券信息 (OesEtfComponentItemT) 中新增如下字段:
      字段描述
      fundMktIdETF基金市场代码
      isTrdComponent是否是作为申赎对价的成份证券
      discountRatio赎回折价比例
      securityName成份证券名称
      premiumRatio申购溢价比例 (重命名 premiumRate)
      redemptionSubCash赎回替代金额 (重命名 redemptionCashSub)
  8. 新增证券子类型
    • 创业板存托凭证 (OES_SUB_SECURITY_TYPE_STOCK_GEMCDR)
    • 可交换债券 (OES_SUB_SECURITY_TYPE_BOND_EXG)
    • 商品期货ETF (OES_SUB_SECURITY_TYPE_ETF_COMMODITY_FUTURES)
  9. 调整买卖类型 (eOesBuySellTypeT) 定义:
    • 重命名 质押式逆回购 (OES_BS_TYPE_CREDIT_SELL => OES_BS_TYPE_REVERSE_REPO)
    • 废弃 OES_BS_TYPE_CREDIT_SELL (融资买入或质押式逆回购)
    • 废弃 OES_BS_TYPE_CREDIT_BUY (融资买入)
  10. 股东账户交易权限枚举(eOesTradingPermissionT)中新增: - 商品期货ETF申赎权限 (OES_PERMIS_COMMODITY_FUTURES_ETF)
  11. 删除已经过时的期权相关查询接口和结构体定义, 包括: - 删除接口
    • 查询单条期权持仓信息 (OesApi_QuerySingleOptHolding)
    • 查询期权持仓信息 (OesApi_QueryOptHolding)
    • 查询期权产品信息 (OesApi_QueryOption) - 删除结构体
    • 期权合约结构体 (OesOptionItemT)
    • 期权持仓结构体 (OesOptHoldingItemT) - 从0.16版本开始正式支持期权业务
  12. 优化异步API - 为异步API增加是否优先使用大页内存来创建异步队列的配置项 - 为异步API的I/O线程增加追加模式输出的配置项 - 为异步API的I/O线程增加支持忙等待的配置选项，以使异步队列的延迟统计结果更接近实际情况 - '异步修改客户端密码 (OesAsyncApi_SendChangePasswordReq)' 接口中删除多余的应答参数
  13. 优化时间戳精度, 将系统下的时间戳全部升级为纳秒级时间戳, 以提高时延统计的精度 - 时间戳字段的数据类型从 STimevalT/STimeval32T 变更为 STimespecT/STimespec32T - 协议保持兼容, 但如果使用到了时间戳字段下的微秒时间(tv_usec 字段), 则需要修改为纳秒时间(tv_nsec 字段), 否则会因为时间单位的调整而导致时延计算错误
  14. API中添加vs2015工程样例
  15. 调整错误码 - 删除 '1242, 出入金笔数超过限制' - 调整描述内容 '1249, 不支持市价委托或账户无市价委托的交易权限' - 调整描述内容 '1258, 股东账户没有交易货币ETF的权限' - 调整描述内容 '1250, 股东账户没有交易创业板核准制证券的权限' - 新增 '1285, 股东账户没有交易债券ETF的权限' - 新增 '1286, 股东账户没有交易黄金ETF的权限' - 新增 '1287, 股东账户没有交易商品期货ETF的权限' - 新增 '1288, 股东账户没有交易创业板注册制证券的权限'

2. 服务端更新概要

  1. 支持创业板注册制改革
  2. 上海市场风险警示(ST/*ST)证券和退市整理证券不再支持市价买卖
  3. 其它细节完善和性能优化

3. 注意事项说明

  1. 时间戳精度的修改没法完全兼容之前的API, 如果使用到了时间戳字段下的微秒时间(tv_usec 字段), 则需要升级API到最新版本
    • 通常只有在统计延迟时才会使用到微秒时间(tv_usec)字段, 如果使用到了该字段, 则需要改为使用纳秒时间(tv_nsec)字段, 否则会因为时间单位的调整而导致时延计算错误
    • 升级API以后, 可以通过检查有无编译错误的方式, 来检查是否使用到了 tv_usec 字段。如果没有编译错误就无需再做额外的调整
  2. 查询ETF成份证券信息接口的行为有如下变化:
    • 查询过滤条件中的 fundId 字段不再是必填项
      • 查询过滤条件如中不填写 fundId 字段, 查询结果会返回所有成份证券信息。 客户端需要通过返回内容中的 fundId 来判断该成份证券属于哪支ETF。
    • 对于深圳跨市场ETF，返回内容将包括其上海成份证券信息
      • 对深交所跨市场ETF进行申赎时应使用 159900 虚拟成份券进行沪市成份证券份额的现金替代处理, 深圳跨市场ETF中的上海成份证券信息仅作参考使用。
      • 如需过滤深圳跨市场ETF中的上海成份证券信息, 可通过 '是否是作为申赎对价的成份证券 (isTrdComponent)' 字段来判断。 对于深圳跨市场ETF中的上海成份证券, 该字段取值为0。

OES_0.16.0.5 / 2020-04-17

1. API更新概要

  1. 服务端兼容 v0.15.5.1 版本API, 但建议升级到0.16.0.3及之后版本, 以支持期权业务
  2. 新增如下错误码
    错误码描述
    1284投资者未进行程序化交易报备
  3. 调整示例代码的目录位置

2. 服务端更新概要

  1. 无

OES_0.16.0.4 / 2020-02-28

1. API更新概要

  1. 服务端兼容 v0.15.5.1 版本API, 但建议升级到0.16.0.3及之后版本, 以支持期权业务
  2. fix: 为API增加对SIGPIPE信号的屏蔽处理，以避免连接断开以后重复send导致程序异常退出
  3. 增加异步API接口, 以支持异步回报处理和连接管理。原API接口不受影响, 可以正常使用
    • 支持异步接收回报数据
    • 支持自动的连接管理 (自动识别异常并重建连接)
    • 支持异步数据落地和延迟统计 (可以通过配置文件进行控制, 默认为禁用)
    • 主要接口:
      • OesAsyncApi_CreateContext
      • OesAsyncApi_AddChannel
      • OesAsyncApi_Start
      • OesAsyncApi_Stop
      • OesAsyncApi_ReleaseContext
    • 样例代码参见: oes_api/samples/c_sample/03_oes_async_api_sample.c
  4. 重构C++样例代码, 改为基于异步API实现, 增加如下特性:
    • 支持自动的连接管理 (自动识别异常并重建连接)
    • 增加和完善了 OnConnected/OnDisconnected 回调接口 (客户端可以不用实现这两个接口, 采用默认实现即可)
    • 样例代码及更新说明参见: oes_api/samples/cpp_sample/oes_client_sample.h
  5. API新增如下接口
    API描述
    OesApi_IsBusinessSupported返回会话是否支持指定的业务类别
  6. 新增如下错误码
    错误码描述
    1280有未成交的卖出委托时禁止买入
    1281有未成交的买入委托时禁止卖出
    1282客户当日交易总量超出限制
    1283委托数量超出报备的单笔委托数量限制
  7. 股票持仓信息 (OesStkHoldingItemT) 结构体字段变更
    • 新增 当日最大可减持额度 (maxReduceQuota) 字段
  8. 期权标的持仓信息 (OesOptUnderlyingHoldingItemT) 结构体字段变更
    • 新增 当日最大可减持额度 (maxReduceQuota) 字段
  9. 资金变动回报 (OesCashAssetReportT) 和 客户资金信息 (OesCashAssetItemT) 结构体字段变更 - 新增 未对冲实时价格保证金 (totalMarketMargin) 字段 - 新增 已对冲实时价格保证金 (totalNetMargin) 字段
  10. 券商参数信息 (OesBrokerParamsInfoT)' 结构体字段变更 - 新增 服务端业务范围 (businessScope) 字段 - 新增 期权扩展参数 (optionExt) 结构
    • 其中新增 投资人出金提取线 (withdrawLineRatio) 字段
  11. 期权行权指派信息 (OesOptExerciseAssignItemT)' 结构体字段变更 - 新增 期权合约名称 (securityName) 字段

2. 服务端更新概要

  1. 支持大股东减持控制
  2. 支持深交所公开增发业务
  3. 支持深交所期权备兑业务
  4. 加强期权业务的风控检查, 包括客户自成交、程序化报备信息等
  5. 其它细节优化与完善

3. 注意事项说明

  1. C++样例代码发生了如下变化, 请参考更新说明进行升级处理:
    • 删除以下连接重建相关的接口, 不再需要显式的重建连接
      • ReconnectOrdChannel
      • ReconnectRptChannel
      • ReconnectQryChannel
      • SendReportSynchronization
    • 删除或重名以下公有成员变量
      • 删除 apiEnv
      • 重命名 apiCfg => _apiCfg
    • 简化和废弃了 Start 方法的参数, 具体描述参见 Start 方法的函数注释

OES_0.16.0.1 / 2019-12-12

1. API更新概要

  1. 0.16 版本的API中期权业务的市价委托类型控制不准确, 建议升级到当前版本
  2. 新增上证期权业务委托类型枚举定义 (eOesOrdTypeShOptT)

2. 服务端更新概要

  1. 完善期权业务的相关细节
  2. 修复其它系统缺陷, 增强系统的健壮性

OES_0.16 / 2019-11-20

1. API更新概要

  1. 服务端兼容 v0.15.5.1 版本API, 客户可以选择不升级 (建议升级, 以支持期权业务)
  2. API新增如下接口 | API | 描述 | ---------------------------------- | --------------- | OesApi_SendOptSettlementConfirmReq | 期权账户结算单确认 | OesApi_QueryOption | 查询期权产品信息 | OesApi_QueryOptHolding | 查询期权持仓信息 | OesApi_QuerySingleOptHolding | 查询单条期权持仓信息 | OesApi_QueryOptUnderlyingHolding | 查询期权标的持仓信息 | OesApi_QueryOptExerciseAssign | 查询期权行权指派信息 | OesApi_QueryOptPositionLimit | 查询期权限仓额度信息 | OesApi_QueryOptPurchaseLimit | 查询期权限购额度信息 | OesApi_QueryOptSettlementStatement | 查询期权结算单信息 | OesApi_QueryBrokerParamsInfo | 查询券商参数信息 | OesApi_QueryNotifyInfo | 查询通知消息
  3. 回报消息 (OesRptMsgBodyT) 中 - 新增 '通知消息 (OesNotifyInfoReportT)' 回报推送
    • 对应回报消息类型 '通知消息回报 (OESMSG_RPT_NOTIFY_INFO)'
    • 对应回报消息体 OesRptMsgBodyT.notifyInfoRpt - 新增 '期权标的持仓变动信息 (OesOptUnderlyingHoldingReportT)' 回报推送
    • 对应回报消息类型 '期权标的持仓变动信息回报 (OESMSG_RPT_OPTION_UNDERLYING_HOLDING_VARIATION)'
    • 对应回报消息体 OesRptMsgBodyT.optUnderlyingHoldingRpt - 新增 '期权账户结算单确认 (OesOptSettlementConfirmReportT)' 回报推送
    • 对应回报消息类型 '期权账户结算单确认回报 (OESMSG_RPT_OPTION_SETTLEMENT_CONFIRMED)'
    • 对应回报消息体 OesRptMsgBodyT.optSettlementConfirmRpt - 重命名 '资金变动回报信息' 消息的结构体定义 OesCashAssetItemT => OesCashAssetReportT
    • 对应回报消息 OesRptMsgBodyT.cashAssetRpt - 重命名 '持仓变动回报信息 (股票)' 消息的结构体定义 OesStkHoldingItemT => OesStkHoldingReportT
    • 对应回报消息 OesRptMsgBodyT.stkHoldingRpt - 重命名 '持仓变动回报信息 (期权)' 消息的结构体定义 OesOptHoldingItemT => OesOptHoldingReportT
    • 对应回报消息 OesRptMsgBodyT.optHoldingRpt
  4. 资金变动回报和客户资金信息 (OesCashAssetItemT) 中增加如下字段 - 日初持仓占用保证金 (initialMargin) - 行权累计待交收冻结资金 (totalExerciseFrzAmt) - 待追加保证金 (pendingSupplMargin) - 上海市场可用限购/套保额度 (sseAvailablePurchaseLimit) - 深圳市场可用限购/套保额度 (szseAvailablePurchaseLimit)
  5. 股票持仓信息 (OesStkHoldingItemT) 结构体字段变更 - 删除 当前已锁定持仓 (lockHld) 字段 - 删除 当前锁定冻结持仓 (lockFrzHld) 字段 - 删除 当前解锁定冻结持仓数量 (unlockFrzHld) 字段 - 删除 当前备兑冻结的现货持仓数量 (coveredFrzHld) 字段 - 删除 当前已备兑使用的现货持仓数量 (coveredHld) 字段 - 新增 日初锁定持仓 (originalLockHld) 字段 - 新增 日中累计锁定持仓 (totalLockHld) 字段 - 新增 日中累计解锁持仓 (totalUnlockHld) 字段 - 新增 日初可用持仓 (originalAvlHld) 字段
  6. 委托回报和委托信息 (OesOrdCnfmT/OesOrdItemT) 中增加如下字段 - 委托当前冻结的保证金 (frzMargin) - 委托累计已使用的保证金 (cumMargin)
  7. 成交回报和成交信息 (OesTrdCnfmT/OesTrdItemT) 中增加如下字段 - 债券利息 (trdInterest) - 交易费用 (trdFee) - 占用/释放的保证金 (trdMargin) - 累计占用/释放的保证金 (cumMargin)
  8. 委托状态 (eOesOrdStatusT) 枚举定义调整 - 重命名 OES_ORD_STATUS_UNDEFINE => OES_ORD_STATUS_PENDING (待处理 (仅内部使用))
  9. 新增如下错误码 | 错误码 | 描述 | ---- | --------------- | 1278 | 结算单未确认 | 1279 | 结算单重复确认 | 1331 | 非法的持仓类型 | 1332 | 合约限制开仓 | 1333 | 客户权利仓持仓限额不足 | 1334 | 客户总持仓限额不足 | 1335 | 客户单日买入开仓限额不足 | 1336 | 客户买入额度不足 (限购) | 1337 | 券商总持仓限额不足 | 1338 | 券商总保证金额度不足 | 1339 | 非法的标的锁定指令类型 | 1340 | 禁止买入开仓 | 1341 | 禁止卖出平仓 | 1342 | 禁止卖出开仓 | 1343 | 禁止买入平仓 | 1344 | 禁止备兑开仓 | 1345 | 禁止备兑平仓 | 1346 | 禁止标的锁定 | 1347 | 禁止标的解锁 | 1348 | 禁止期权行权 | 1349 | 非行权日

2. 服务端更新概要

  1. 支持期权业务

3. 注意事项说明

  1. v0.15.9 及其之前版本API中 OesApi_QueryOptHolding、OesApi_QueryOption、OesApi_QuerySingleOptHolding 已废弃, 需使用 v0.16 版本API进行相关信息的查询

OES_0.15.12.4 / 2021-08-08

1. API更新概要

  1. 服务端兼容 v0.15.5.1 版本API, 客户可以选择不升级

  2. 重构C++接口库示例程序, 增加对多通道的支持

    • 为支持多通道, C++接口库示例程序中增加如下接口

      API描述
      GetDefaultOrdChannel返回默认的委托通道
      SetDefaultOrdChannel设置默认的委托通道
      AddOrdChannel添加委托通道配置信息
      AddOrdChannelFromFile添加委托通道配置信息 (从配置文件中加载通道配置信息)
      AddRptChannel添加回报通道配置信息
      AddRptChannelFromFile添加回报通道配置信息 (从配置文件中加载通道配置信息)
      GetOrdChannelCount返回委托通道数量
      GetRptChannelCount返回回报通道数量
      GetOrdChannelByTag返回标签对应的委托通道
      GetRptChannelByTag返回标签对应的回报通道
      ForeachOrdChannel遍历所有的委托通道并执行回调函数
      ForeachRptChannel遍历所有的回报通道并执行回调函数
      SendOrder发送委托申报请求的重载方法 (使用指定的连接通道)
      SendCancelOrder发送撤单请求的重载方法 (使用指定的连接通道)
      SendFundTrsf发送出入金请求的重载方法 (使用指定的连接通道)
      GetTradingDay获取当前交易日 (基于指定的连接通道)
      GetClientOverview获取客户端总览信息的重载方法 (基于指定的连接通道)
      QueryOrder查询委托信息的重载方法 (基于指定的连接通道)
      Query...其它查询接口的重载方法 (基于指定的连接通道)

    • 为C++接口库示例程序补充如下功能接口

      API描述
      SendBatchOrders批量发送多条委托请求
      SendChangePassword发送密码修改请求
      QueryCounterCash查询主柜资金信息

    • 删除独立维护的查询通道, 改为使用异步API内置的查询通道

    • 提供默认的回调接口实现, 使应用程序无需实现所有的回调接口, 仅实现感兴趣的接口即可

    • 样例代码和样例配置参见:

      • samples/oes_sample_cpp/oes_client_main_sample.cpp
      • samples/oes_sample_cpp/oes_client_sample.conf

  3. 增加辅助的异步API接口, 以方便检查内置查询通道是否已连接就绪

| API                                        | 描述 |

| ------------------------------             | -------------------- |
| OesAsyncApi_IsBuiltinQueryChannelConnected | 返回内置的查询通道是否已连接就绪 |

2. 服务端更新概要

  • 无

OES_0.15.12.2 / 2021-05-28

1. API更新概要

  1. 服务端兼容 v0.15.5.1 版本API, 客户可以选择不升级
  2. 为回报服务增加时间同步处理, 以统计客户端与服务器端之间的网络延迟和时钟偏差

2. 服务端更新概要

  1. 添加可转债程序化交易投资者报备信息上场文件, 针对可转债程序化交易报备信息, 增加相应的可转债交易权限和限制处理
  2. 为回报服务增加时间同步处理, 以统计客户端与服务器端之间的网络延迟和时钟偏差
  3. 其它细节完善和优化

OES_0.15.12 / 2021-03-23

1. API更新概要

  1. 服务端兼容 v0.15.5.1 版本API, 客户可以选择不升级

  2. fix: 增加对Windows下的CPU绑定操作的支持, 并完善Windows下的进程号、线程号处理

  3. 证券属性枚举 eOesSecurityAttributeT 中新增 '科创板标记 OES_SECURITY_ATTR_KSH' 定义, 用于标识科创板股票、科创板CDR、科创板ETF、科创板LOF及科创板可转债等具有科创板属性的证券

  4. 市场类型枚举eOesMarketIdT 中新增 '港股OES_MKT_EXT_HK' 定义, 用于且仅用于跨沪深港ETF的成分股查询

  5. 为异步API增加内置的查询通道, 并整合查询通道管理和查询接口到异步API中

    • 增加查询通道相关的配置接口

      API描述
      OesAsyncApi_SetBuiltinQueryable设置是否启用内置的查询通道
      OesAsyncApi_IsBuiltinQueryable返回是否启用内置的查询通道
      OesAsyncApi_GetBuiltinQueryChannelRef返回内置的查询通道的会话信息

    • 增加异步API查询接口

      API描述
      OesAsyncApi_GetTradingDay获取当前交易日
      OesAsyncApi_GetClientOverview获取客户端总览信息
      OesAsyncApi_QuerySingleCashAsset查询单条资金资产信息
      OesAsyncApi_QuerySingleStkHolding查询单条股票持仓信息
      OesAsyncApi_QuerySingleOrder查询单条委托信息
      OesAsyncApi_QueryOrder查询所有委托信息
      OesAsyncApi_QueryTrade查询成交信息
      OesAsyncApi_QueryCashAsset查询客户资金信息
      OesAsyncApi_QueryStkHolding查询股票持仓信息
      OesAsyncApi_QueryLotWinning查询新股配号、中签信息
      OesAsyncApi_QueryCustInfo查询客户信息
      OesAsyncApi_QueryInvAcct查询证券账户信息
      OesAsyncApi_QueryCommissionRate查询佣金信息
      OesAsyncApi_QueryFundTransferSerial查询出入金流水
      OesAsyncApi_QueryIssue查询证券发行产品信息
      OesAsyncApi_QueryStock查询现货产品信息
      OesAsyncApi_QueryEtf查询ETF申赎产品信息
      OesAsyncApi_QueryEtfComponent查询ETF成份证券信息
      OesAsyncApi_QueryMarketState查询市场状态信息
      OesAsyncApi_QueryCounterCash查询主柜资金信息
      OesAsyncApi_QueryBrokerParamsInfo查询券商参数信息

    • 样例代码参见: samples/oes_sample_c/03_oes_async_api_sample.c

  6. 增加辅助的异步API接口, 以支持对通信线程、回调线程等异步API线程进行初始化处理

| API                                       | 描述 |

| ------------------------------            | -------------------- |
| OesAsyncApi_SetOnCommunicationThreadStart | 设置通信线程的线程初始化回调函数 |
| OesAsyncApi_SetOnCallbackThreadStart      | 设置回调线程的线程初始化回调函数 |
| OesAsyncApi_SetOnIoThreadStart            | 设置异步I/O线程的线程初始化回调函数 |

7. 增加辅助的会话管理接口

| API                                       | 描述 |
| ------------------------------------------| -------------------- |
| OesAsyncApi_DefaultOnConnect              | 连接完成后处理的默认实现 |
| OesApi_GetClientId                        | 返回通道对应的客户端编号 |

2. 服务端更新概要

  1. 增加对跨沪深港ETF申购赎回业务的支持
  2. 增加对上交所基础设施基金(REITS)的支持
  3. 增加深交所风险警示证券的适当性管理和买入限额控制
  4. 其它细节完善和优化

OES_0.15.11.15 / 2020-11-20

1. API更新概要

  1. 服务端兼容 v0.15.5.1 版本API, 客户可以选择不升级
  2. 证券子类别枚举 eOesSubSecurityTypeT 中: - 新增 基础设施基金 OES_SUB_SECURITY_TYPE_FUND_REITS
  3. 股东账户交易权限枚举 eOesTradingPermissionT 中: - 字段重命名 基础设施基金交易权限 OES_PERMIS_INFRASTRUCTURE_FUND => OES_PERMIS_REITS
  4. 证券属性枚举 eOesSecurityAttributeT 中: - 删除 基础设施基金 OES_SECURITY_ATTR_INFRASTRUCTURE_FUND
  5. 重命名错误码的宏定义 - 1290, 股东账户没有交易基础设施基金的权限 OESERR_NO_INFRASTRUCTURE_FUND_PERM => OESERR_NO_REITS_PERM
  6. 增加辅助接口
| API                           | 描述 |

| ------------------------------| -------------------- |
| OesApi_GetClientType          | 返回通道对应的客户端类型 |
| OesApi_GetClientStatus        | 返回通道对应的客户端状态 |
| OesApi_GetBusinessType        | 返回通道对应的业务类型 |
| OesApi_IsBusinessSupported    | 返回会话是否支持指定的业务类别 |
| OesApi_SetRetainExtDataAble   | 设置是否保留(不清空)由应用层自定义使用的扩展存储空间数据 (__extData) |
| OesApi_IsRetainExtDataAble    | 返回是否保留(不清空)由应用层自定义使用的扩展存储空间数据 |
| OesApi_SetThreadBusinessType  | 设置当前线程登录OES时所期望对接的业务类型 (正常情况下无需调用) |
| OesApi_GetThreadBusinessType  | 返回当前线程登录OES时所期望对接的业务类型 |

2. 服务端更新概要

  1. 完善对深交所基础设施基金产品交易的支持
  2. 其它细节完善和优化

OES_0.15.11.12 / 2020-09-30

1. API更新概要

  1. 服务端兼容 v0.15.5.1 版本API, 客户可以选择不升级
  2. '客户端总览信息 OesClientOverviewT' 中新增如下字段
    • 新增 最大委托笔数限制 maxOrdCount 字段
  3. 新增 证券属性定义 eOesSecurityAttributeT 枚举类型
  4. 股东账户交易权限枚举 eOesTradingPermissionT 中新增:
    • 可转换公司债券交易权限 OES_PERMIS_CONVERTIBLE_BOND
    • 基础设施基金交易权限 OES_PERMIS_INFRASTRUCTURE_FUND
  5. '现货产品基础信息 OesStockBaseInfoT' 中启用 证券属性 securityAttribute 字段
  6. '证券发行基础信息 OesIssueBaseInfoT' 中启用 证券属性 securityAttribute 字段
  7. 新增错误码
| 错误码 | 描述 |

| ----- | ---- |
| 1289  | 股东账户没有交易可转换公司债券的权限 |
| 1290  | 股东账户没有交易基础设施基金的权限 |

2. 服务端更新概要

  1. 新增事中风控处理 - 风控规则1: 客户最大委托笔数限制, 触发后客户被限制开仓 - 风控规则2: 营业部委托流水号限制, 触发后营业部所有客户被限制开仓
  2. 支持可转换公司债券的适当性检查
  3. 支持上交所科创板ETF和科创板LOF产品的交易
  4. 支持深交所基础设施基金产品的交易及适当性检查
  5. 其它细节完善和优化

OES_0.15.11.6 / 2020-07-23

1. API更新概要

  1. 该版本是 v015.11.4 的BUG修复版本, 建议升级到该版本
  2. 服务端兼容 v0.15.5.1 版本API, 客户可以选择不升级 (建议升级)
    • 如果使用到了时间戳字段下的微秒时间, 则需要升级最新的API, 因为时间戳字段已全部升级为纳秒级时间戳。具体请参见 v0.15.11.4 版本的更新说明
  3. fix: 完备Windows平台下的 WSACleanup 资源释放处理, 避免额外调用 WSACleanup 导致外部系统的网络操作异常
  4. fix: 修复Win64下不能正确获取纳秒级时间戳的问题
  5. fix: 修复MinGW下 struct timespec 结构体未按64位对齐的问题
  6. 为异步API增加用于返回尚未被处理的剩余数据数量的辅助接口
| API                                     | 描述 |

| ----------------------------------------| -------------------- |
| OesAsyncApi_GetAsyncQueueTotalCount     | 返回异步API累计已入队的消息数量 |
| OesAsyncApi_GetAsyncQueueRemainingCount | 返回队列中尚未被处理的剩余数据数量 |

2. 服务端更新概要

  1. 创业板注册制业务的细节调整
  2. 完善系统在异常场景下24小时持续运行的可靠性
  3. 其它细节完善和优化

OES_0.15.11.4 / 2020-07-07

1. API更新概要

  1. 服务端兼容 v0.15.5.1 版本API, 客户可以选择不升级 (建议升级以支持创业板注册制改革的相关内容)
    • 如果使用到了时间戳字段下的微秒时间, 则需要升级最新的API, 因为时间戳字段已全部升级为纳秒级时间戳。具体请参见注意事项说明
  2. fix: 修复在Win32下因为对齐问题导致指针位置不正确的BUG (正常不会触发, 只有在启用异步API的异步回调处理时才会触发)
  3. 异步API新增如下接口
| API                                   | 描述 |

| ------------------------------------- | -------------------- |
| OesAsyncApi_SendReportSynchronization | 发送回报同步消息接口 |
| OesAsyncApi_IsAllTerminated           | 检查所有线程是否均已安全退出 |

4. 同步API新增如下接口

| API                                   | 描述 |
| ------------------------------------- | -------------------- |
| OesApi_GetChannelGroupLastRecvTime    | 返回通道组最近接收消息时间 |
| OesApi_GetChannelGroupLastSendTime    | 返回通道组最近发送消息时间 |
| OesApi_HasStockStatus                 | 返回现货产品是否具有指定状态 |
| __OesApi_CheckApiVersion              | 检查API版本是否匹配 (检查API头文件和库文件的版本是否匹配) |

5. 为支持创业板注册制改革, 现货产品信息 OesStockItemT 中新增如下字段:

| 字段                        | 描述 |
| -------------------------- | -------------------- |
| isRegistration             | 是否注册制 |
| securityStatus             | 证券状态 |
| securityAttribute          | 证券属性 (保留字段) |
| isCrdMarginTradeUnderlying | 是否为融资标的 |
| isCrdShortSellUnderlying   | 是否为融券标的 |
| isCrdCollateral            | 是否为融资融券担保品 |
| isNoProfit                 | 是否尚未盈利 |
| isWeightedVotingRights     | 是否存在投票权差异 |
| isVie                      | 是否具有协议控制框架 |
| lmtBuyQtyUnit              | 限价买入单位 (重命名 buyQtyUnit) |
| lmtSellQtyUnit             | 限价卖出单位 (重命名 sellQtyUnit) |
| mktBuyQtyUnit              | 市价买入单位 |
| mktSellQtyUnit             | 市价卖出单位 |
| parValue                   | 面值 (重命名 parPrice) |
| auctionLimitType           | 连续交易时段的有效竞价范围限制类型 |
| auctionReferPriceType      | 连续交易时段的有效竞价范围基准价类型 |
| auctionUpDownRange         | 连续交易时段的有效竞价范围涨跌幅度 |
| listDate                   | 上市日期 |
| maturityDate               | 到期日期 (仅适用于债券等有发行期限的产品) |
| underlyingSecurityId       | 基础证券代码 |

6. 为支持创业板注册制改革, 证券发行信息 OesIssueItemT 中新增如下字段:

| 字段                        | 描述 |
| -------------------------- | -------------------- |
| isRegistration             | 是否注册制 |
| securityAttribute          | 证券属性 (保留字段) |
| isNoProfit                 | 是否尚未盈利 |
| isWeightedVotingRights     | 是否存在投票权差异 |
| isVie                      | 是否具有协议控制框架 |
| alotRecordDay              | 配股股权登记日 |
| alotExRightsDay            | 配股股权除权日 |

7. 查询ETF成份证券信息接口调整 - 查询过滤条件 OesQryEtfComponentFilterT 中: - 查询条件 ETF基金申赎代码 fundId 字段不再是必填项 - 新增查询条件 ETF基金市场代码 fundMktId 字段 - ETF��份证券信息 OesEtfComponentItemT 中新增如下字段:

    | 字段                        | 描述 |
    | -------------------------- | -------------------- |
    | fundMktId                  | ETF基金市场代码 |
    | isTrdComponent             | 是否是作为申赎对价的成份证券 |
    | discountRatio              | 赎回折价比例 |
    | securityName               | 成份证券名称 |
    | premiumRatio               | 申购溢价比例  (重命名 premiumRate) |
    | redemptionSubCash          | 赎回替代金额  (重命名 redemptionCashSub) |

8. 新增证券子类型 - 创业板存托凭证 OES_SUB_SECURITY_TYPE_STOCK_GEMCDR - 可交换债券 OES_SUB_SECURITY_TYPE_BOND_EXG - 商品期货ETF OES_SUB_SECURITY_TYPE_ETF_COMMODITY_FUTURES 9. 调整买卖类型 eOesBuySellTypeT 定义: - 重命名 质押式逆回购 (OES_BS_TYPE_CREDIT_SELL => OES_BS_TYPE_REVERSE_REPO) - 废弃 OES_BS_TYPE_CREDIT_SELL (融资买入或质押式逆回购) - 废弃 OES_BS_TYPE_CREDIT_BUY (融资买入) 10. 股东账户交易权限枚举 eOesTradingPermissionT 中新增: - 商品期货ETF申赎权限 OES_PERMIS_COMMODITY_FUTURES_ETF 11. 删除已经过时的期权相关查询接口和结构体定义, 包括: - 删除接口 - 查询单条期权持仓信息 OesApi_QuerySingleOptHolding - 查询期权持仓信息 OesApi_QueryOptHolding - 查询期权产品信息 OesApi_QueryOption - 删除结构体 - 期权合约结构体 OesOptionItemT - 期权持仓结构体 OesOptHoldingItemT - 从0.16版本开始正式支持期权业务 12. 优化异步API - 为异步API增加是否优先使用大页内存来创建异步队列的配置项 - 为异步API的I/O线程增加追加模式输出的配置项 - 为异步API的I/O线程增加支持忙等待的配置选项, 以使异步队列的延迟统计结果更接近实际情况 - '异步修改客户端密码 OesAsyncApi_SendChangePasswordReq' 接口中删除多余的应答参数 13. 优化时间戳精度, 将系统下的时间戳全部升级为纳秒级时间戳, 以提高时延统计的精度 - 时间戳字段的数据类型从 STimevalT / STimeval32T 变更为 STimespecT / STimespec32T - 协议保持兼容, 但如果使用到了时间戳字段下的微秒时间(tv_usec 字段), 则需要修改为纳秒时间(tv_nsec 字段), 否则会因为时间单位的调整而导致时延计算错误 14. API中添加vs2015工程样例 15. 调整错误码 - 删除 '1242, 出入金笔数超过限制' - 调整描述内容 '1249, 不支持市价委托或账户无市价委托的交易权限' - 调整描述内容 '1258, 股东账户没有交易货币ETF的权限' - 调整描述内容 '1250, 股东账户没有交易创业板核准制证券的权限' - 新增 '1285, 股东账户没有交易债券ETF的权限' - 新增 '1286, 股东账户没有交易黄金ETF的权限' - 新增 '1287, 股东账户没有交易商品期货ETF的权限' - 新增 '1288, 股东账户没有交易创业板注册制证券的权限'

2. 服务端更新概要

  1. 支持创业板注册制改革
  2. 上海市场风险警示(ST/*ST)证券和退市整理证券不再支持市价买卖
  3. 其它细节完善和性能优化

3. 注意事项说明

  1. 时间戳精度的修改没法完全兼容之前的API, 如果使用到了时间戳字段下的微秒时间(tv_usec 字段), 则需要升级API到最新版本
    • 通常只有在统计延迟时才会使用到微秒时间 tv_usec 字段, 如果使用到了该字段, 则需要改为使用纳秒时间 tv_nsec 字段, 否则会因为时间单位的调整而导致时延计算错误
    • 升级API以后, 可以通过检查有无编译错误的方式, 来检查是否使用到了 tv_usec 字段。如果没有编译错误就无需再做额外的调整
  2. 查询ETF成份证券信息接口的行为有如下变化:
    • 查询过滤条件中的 fundId 字段不再是必填项
      • 查询过滤条件如中不填写 fundId 字段, 查询结果会返回所有成份证券信息。 客户端需要通过返回内容中的 fundId 来判断该成份证券属于哪支ETF。
    • 对于深圳跨市场ETF, 返回内容将包括其上海成份证券信息
      • 对深交所跨市场ETF进行申赎时应使用 159900 虚拟成份券进行沪市成份证券份额的现金替代处理, 深圳跨市场ETF中的上海成份证券信息仅作参考使用。
      • 如需过滤深圳跨市场ETF中的上海成份证券信息, 可通过 '是否是作为申赎对价的成份证券 isTrdComponent' 字段来判断。 对于深圳跨市场ETF中的上海成份证券, 该字段取值为0。

OES_0.15.10.5 / 2020-04-07

1. API更新概要

  1. 服务端兼容 v0.15.5.1 版本API, 客户可以选择不升级 (建议升级)
  2. fix: 为API增加对 SIGPIPE 信号的屏蔽处理, 以避免连接断开以后重复 send 导致程序异常退出
  3. 增加异步API接口, 以支持异步回报处理和连接管理
    • 支持异步接收回报数据
    • 支持自动的连接管理 (自动识别异常并重建连接)
    • 支持异步数据落地和延迟统计 (可以通过配置文件进行控制, 默认为禁用)
    • 主要接口:
      • OesAsyncApi_CreateContext
      • OesAsyncApi_AddChannel
      • OesAsyncApi_Start
      • OesAsyncApi_Stop
      • OesAsyncApi_ReleaseContext
    • 样例代码参见:
      • oes_api/samples/oes_sample/c_sample/03_oes_async_api_sample.c
  4. 重构C++样例代码, 改为基于异步API实现, 增加如下特性:
    • 支持自动的连接管理 (自动识别异常并重建连接)
    • 增加和完善了 OnConnected / OnDisconnected 回调接口 (客户端可以不用实现这两个接口, 采用默认实现即可)
    • 样例代码及更新说明参见:
      • oes_api/samples/oes_sample/cpp_sample/oes_client_sample.h
  5. 调整示例代码的目录位置
  6. '股票持仓基础信息 OesStkHoldingBaseInfoT' 如下字段变更
    • 删除 当前已锁定持仓 lockHld 字段
    • 删除 当前锁定冻结持仓 lockFrzHld 字段
    • 删除 当前解锁定冻结持仓数量 unlockFrzHld 字段
    • 删除 当前备兑冻结的现货持仓数量 coveredFrzHld 字段
    • 删除 当前已备兑使用的现货持仓数量 coveredHld 字段
    • 新增 日初可用持仓 originalAvlHld 字段
    • 新增 日初锁定持仓 originalLockHld 字段
    • 新增 日中累计锁定持仓 totalLockHld 字段
    • 新增 日中累计解锁持仓 totalUnlockHld 字段
    • 新增 当日最大可减持额度 maxReduceQuota 字段
  7. '客户端总览信息 OesClientOverviewT' 中新增如下字段
    • 新增 客户端适用的业务范围 businessScope 字段

2. 服务端更新概要

  1. 支持深证增发业务
  2. 支持大股东减持控制
  3. ⽀持上证ETF业务改造
  4. 其它细节完善和性能优化

3. 注意事项说明

  1. C++样例代码发生了如下变化, 请参考更新说明进行升级处理:
    • 删除以下连接重建相关的接口, 不再需要显式的重建连接
      • ReconnectOrdChannel
      • ReconnectRptChannel
      • ReconnectQryChannel
      • SendReportSynchronization
    • 删除或重名以下公有成员变量
      • 删除 apiEnv
      • 重命名 apiCfg => _apiCfg
    • 简化和废弃了 Start 方法的参数, 具体描述参见 Start 方法的函数注释

OES_0.15.9.4 / 2019-12-24

1. API更新概要

  1. API新增如下接口
| API                          | 描述 |

| ---------------------------- | --------------- |
| OesApi_IsErrorOf             | 判断错误码与错误信息条目是否匹配 |
| OesApi_IsErrorOf2            | 判断消息头中的状态码与错误信息条目是否匹配 |

2. 现货产品信息 OesStockItemT 中增加如下字段 - 新增 总股本 outstandingShare 字段 - 新增 流通股数量 publicFloatShare 字段 3. 证券账户信息 OesInvAcctItemT 中增加如下字段 - 新增 个股持仓比例阀值 stkPositionLimitRatio 字段 4. 证券发行信息 OesIssueBaseInfoT / OesIssueItemT 中新增字段: - 停牌标识 suspFlag - 发行方式 issueType 5. 新增错误码

| 错误码 | 描述 |
| ---- | ---------------
| 1276 | 个股持仓比例超过限制 |
| 1277 | 营业部委托流水号超出有效范围 |

2. 服务端更新概要

  1. 支持上证增发业务
  2. 其它细节完善

OES_0.15.9.1 / 2019-08-16

1. API更新概要

  1. API新增如下接口
| API                          | 描述 |

| ---------------------------- | --------------- |
| OesApi_QueryBrokerParamsInfo | 查询券商参数信息 |

2. 替换头文件中使用的 likely / unlikely 关键字, 以避免与第三方库的同名函数冲突 - 若编译时提示 likely 与 boost 库中的函数名称冲突, 可以通过指定宏 __NO_SHORT_LIKELY 来解决

2. 服务端更新概要

  1. 支持两地交易 (同一个客户账号可以分别托管到上海、深圳机房就近交易, 并支持实时资金划转)
  2. 支持沪伦通业务
  3. 其它细节完善

OES_0.15.9_u4 / 2019-12-03

1. API更新概要

  1. 证券发行信息 OesIssueBaseInfoT / OesIssueItemT 中新增字段:
    • 停牌标识 suspFlag
    • 发行方式 issueType

2. 服务端更新概要

  1. 支持上证增发业务

OES_0.15.9 / 2019-05-31

1. API更新概要

  1. 服务端兼容 v0.15.5.1 版本API, 客户可以选择不升级 (建议升级, 以支持科创版业务)
  2. fix: 修复API无法支持取值大于1024的文件描述符的问题
  3. 新增证券子类型
    • 科创板股票 OES_SUB_SECURITY_TYPE_STOCK_KSH
    • 科创板存托凭证 OES_SUB_SECURITY_TYPE_STOCK_KCDR
    • 沪伦通CDR OES_SUB_SECURITY_TYPE_STOCK_HLTCDR
  4. 新增配股认购对应的买卖类型 OES_BS_TYPE_ALLOTMENT, 以支持配股业务
  5. 新增产品类型属性的定义, 并在如下结构中体现:
    • 证券信息 OesStockBaseInfoT / OesStockItemT
    • 证券发行信息 OesIssueBaseInfoT / OesIssueItemT
    • 股票持仓信息 OesStkHoldingBaseInfoT / OesStkHoldingItemT
    • 委托回报 OesOrdCnfmT / OesOrdItemT
    • 成交回报 OesTrdCnfmT / OesTrdItemT
    • 证券发行信息查询接口 OesApi_QueryIssue 的过滤条件
    • 股票持仓信息查询接口 OesApi_QueryStkHolding 的过滤条件
  6. 为了支持科创板, 扩展以下数据结构以及相应的查询结果 (兼容之前版本的API)
    • 证券账户基础信息 OesInvAcctBaseInfoT, OesInvAcctItemT 中增加如下字段:
      • 科创板权益 kcSubscriptionQuota
    • 现货产品基础信息 OesStockBaseInfoT, OesStockItemT 中增加如下字段:
      • 限价买数量上限 lmtBuyMaxQty
      • 限价买数量下限 lmtBuyMinQty
      • 限价卖数量上限 lmtSellMaxQty
      • 限价卖数量下限 lmtSellMinQty
      • 市价买数量上限 mktBuyMaxQty
      • 市价买数量下限 mktBuyMinQty
      • 市价卖数量上限 mktSellMaxQty
      • 市价卖数量下限 mktSellMinQty
    • 客户端总览信息中的股东账户总览 OesInvAcctOverviewT 中增加如下字段:
      • 科创板权益 kcSubscriptionQuota
  7. 重构涨跌停价格、价格档位字段命名, 为这些字段增加新的别名 (兼容之前版本的API)
    • ceilPrice => upperLimitPrice
    • floorPrice => lowerLimitPrice
    • priceUnit => priceTick
  8. 调整上证委托类型 eOesOrdTypeShT
    • 增加 '对手方最优价格申报 OES_ORD_TYPE_SH_MTL_BEST' 类型 (仅适用于科创板)
    • 增加 '本方最优价格申报 OES_ORD_TYPE_SH_MTL_SAMEPATY_BEST' 类型 (仅适用于科创板)
  9. 股东账户交易权限枚举 eOesTradingPermissionT 中新增
    • 科创板交易权限 OES_PERMIS_KSH
  10. 新增错误码1035、1036、1274、1275, 调整错误码1007、1022的描述信息
| 错误码 | 描述

| ---- | ---------------
| 1007 | 非服务开放时间
| 1022 | 尚不支持或尚未开通此业务
| 1035 | 非法的产品类型
| 1036 | 未通过黑白名单检查
| 1274 | 股东账户没有交易沪伦通存托凭证的权限
| 1275 | 股东账户没有交易科创板的权限

2. 服务端更新概要

  1. 支持配股申购业务
  2. 支持对客户设置禁止买入和限制卖出某支证券
  3. 支持逆回购闭市时间延后到15:30
  4. 支持科创板业务
  5. 修复其他系统缺陷, 完善安全机制

3. 科创板市价委托保护限价说明

  1. 在进行科创板市价委托交易时, 保护限价填在委托请求中的ordPrice字段内 (对于主板的市价委托, 委托请求中的ordPrice字段无意义)
  2. 对于上市前五日、无涨跌幅限制的科创板证券, 市价委托的保护限价必填, 且保护限价需符合价格变动单位
  3. 对于上市五日后、有涨跌幅限制的科创板证券, 市价委托的保护限价可填写有效值或者0
    • 对于市价买委托, 委托请求中ordPrice填0将使用涨停价作为其保护限价
    • 对于市价卖委托, 委托请求中ordPrice填0将使用跌停价作为其保护限价
  4. 对于有涨跌幅限制的科创板证券:
    • 当市价买委托的保护限价高于涨停价时, 将使用涨停价冻结交易资金, 委托正常处理
    • 当市价买委托的保护限价低于涨停价时, 将使用保护限价冻结交易资金
    • 当市价买委托的保护限价低于跌停价时, 委托将被拒绝
    • 当市价卖委托的保护限价低于跌停价时, 委托正常处理
    • 当市价卖委托的保护限价高于涨停价时, 委托将被拒绝

OES_0.15.7.4 / 2018-09-28

1. API更新概要

  1. 服务端兼容 v0.15.5.1 版本API，客户可以选择不升级 (建议升级)
  2. fix: 修复当多个线程同时初始化API日志时, 会导致日志信息重复输出的问题
  3. API新增如下接口 | API | 描述 | ---------------------------- | --------------- | OesApi_SendBatchOrdersReq | 批量委托 | OesApi_SendBatchOrdersReq2 | 批量委托 | OesApi_SendChangePasswordReq | 修改客户端登录密码，仅支持15:00之后修改 | OesApi_SetLastError | 设置当前线程的API错误号 | OesApi_GetLastError | 获取当前线程最近一次API调用失败的错误号 | OesApi_SetCustomizedDriverId | 获取已设置的设备序列号 | OesApi_GetCustomizedDriverId | 设置设备序列号 | OesApi_GetClientOverview | 获取客户端总览信息 | OesApi_QueryCounterCash | 查询主柜资金信息(仅支持部分主柜台) | OesApi_QueryMarketState | 查询市场状态(目前仅能获取到深圳市场状态) | OesApi_HasMoreCachedData | 获取回报通道中尚未被回调函数处理的缓存数据长度 | OesApi_SetThreadUsername | 设置当前线程的登录用户名 | OesApi_SetThreadPassword | 设置当前线程的登录密码 | OesApi_SetThreadEnvId | 设置当前线程的客户端环境号
  4. 回报通道新增一类推送消息: 市场状态推送(目前仅推送深圳市场的状态)，默认订阅条件不会订阅此消息
  5. 新增存托凭证对应的证券子类别 OES_SUB_SECURITY_TYPE_STOCK_CDR
  6. 回报的消息头结构(OesRptMsgHeadT)中增加 execType 字段，用于表明回报执行类型(参考eOesExecTypeT定义)。
  7. 查询证券信息接口(OesApi_QueryStock)中新增过滤条件“证券类别”、“证券子类别”
  8. 查询委托接口(OesApi_QueryOrder)中新增过滤条件“证券类别”、“买卖类型”
  9. 查询成交接口(OesApi_QueryTrade)中新增过滤条件“证券类别”、“买卖类型”
  10. 查询股票持仓接口(OesApi_QueryStkHolding)中新增过滤条件“证券类别”
  11. 调整出入金委托请求接口, 支持银行和主柜之间的银证转账
  12. 客户资金信息中增加是否禁止出入金的标识
  13. 客户股东信息中增加是否禁止交易的标识
  14. 成交信息中增加证券子类型、原始委托数量、原始委托价格
  15. 新增部分错误码 | 错误码 | 描述 | ---- | --------------- | 1029 | 密码未改变 | 1030 | 非法的来源分类 | 1031 | 非法的加密类型 | 1032 | 非法的客户端设备序列号 | 1033 | 无可用节点 | 1271 | 股东账户没有交易存托凭证的权限 | 1272 | 股东账户没有交易创新企业股票的权限 | 1273 | 非法的出入金转账类型

2. 服务端更新概要

  1. 支持修改密码
  2. 支持批量委托
  3. 支持CDR交易、创新企业股票交易
  4. 在监控管理端新增应急撤单功能
  5. 系统增加盘前开工和盘后收工操作。开工前（9:00）可以查询数据，但不受理交易和出入金。收工后（15:10）不受理交易，但可以执行出入金、修改密码和查询数据。
  6. 修复系统缺陷，完善管理功能和故障恢复处理

OES_0.15.5.16 / 2018-09-28

1. API更新概要

  1. 服务端兼容 v0.15.5.1 版本API, 客户可以选择不升级 (建议升级)
  2. fix: 修复当多个线程同时初始化API日志时, 会导致日志信息重复输出的问题
  3. 增加 OesApi_HasMoreCachedData 接口, 用于返回已经接收到但尚未被回调函数处理的缓存数据长度
  4. 增加 OesApi_GetLastError 接口, 用于返回最近一次API调用失败的错误号
  5. 增加 OesApi_QueryCounterCash 接口, 用于查询主柜的资金信息 (仅支持部分主柜)
  6. 增加 OesApi_GetClientOverview 接口, 用于查询客户端总览信息
  7. 增加设置当前线程登录用户名/登录密码/客户端环境号的接口
  8. 查询现货产品信息接口的过滤条件中新增证券类型、证券子类型的过滤条件
  9. 调整出入金委托请求接口, 支持银行和主柜之间的银证转账
  10. 客户资金信息中增加是否禁止出入金的标识
  11. 客户股东信息中增加是否禁止交易的标识
  12. 成交信息中增加证券子类型、原始委托数量、原始委托价格

2. 服务端更新概要

  1. 支持CDR交易、创新企业股票交易
  2. 新增监控管理端的应急撤单功能
  3. 修复系统缺陷, 完善管理功能和故障恢复处理

OES_0.15.5.11 / 2018-06-20

1. API更新概要

  1. API没有变化
  2. 服务端兼容 v0.15.5.1 版本API, 客户可以选择不升级 (建议升级)

2. 服务端更新概要

  1. 修复系统缺陷
  2. 完善容错处理
  3. 其它功能性更新

OES_0.15.5.4 / 2018-02-22

1. API更新概要

  1. 服务端兼容 v0.15.5.1 版本API, 客户可以选择不升级
  2. fix: 解决在Windows下的兼容性问题
  3. fix: 修正注释信息中的错误 ('佣金查询结果 (OesCommissionRateItemT)' 中 feeRate 字段精度描述不正确)
  4. API将优先使用自动获取到的ip/mac信息，只有自动获取到的ip/mac信息非法时，才会使用客户自设的ip/mac
  5. 修正ETF产品信息中的字段拼写错误 (preTrdaingDay => preTradingDay)
  6. 增加 OesApi_GetLastRecvTime、OesApi_GetLastSendTime 接口, 用于获取通道最新发送/接受消息的时间
  7. 登录失败时, 可以通过 errno/SPK_GET_ERRNO() 获取到具体失败原因

2. 服务端更新概要

  1. fix: 优化回报推送，改善推送服务的公平性
  2. fix: 修复在委托确认时没有回填 exchOrdId 的问题
  3. 服务端将拒绝来自本地回环地址以及非法IP/MAC地址的登录

OES_0.15.5 / 2017-11-12

1. 更新概要

  1. API中增加客户端环境号(clEnvId)，不同客户端环境号(clEnvId)下的委托顺序号(clSeqNo)序列互不影响
  2. 增加独立的撤单接口，支持通过 clEnvId+clSeqNo 进行撤单
  3. 回报通道支持消息订阅功能，默认情况下订阅所有类型的回报消息
  4. 回报消息新增两类：资金变动通知、持仓变动通知
  5. 撤单委托执行成功后，补充被撤委托的状态推送
  6. 查询接口回调方法类型定义调整，查询回调接口中增加 isEnd 标志
  7. 持仓信息中增加持仓成本相关字段，将影响持仓查询返回结构和持仓变动通知结构
  8. API退出时在日志中输出延迟统计信息

2. 详细更新内容

2.1 API中增加客户端环境号(clEnvId)

  • clEnvId 是客户端环境号，用于区分不同客户端实例上报的委托。即可以为每个客户端实例分配不同的 clEnvId，这样这些客户端实例就可以各自维护自己的 clSeqNo 而不会相互干扰
  • 不同客户端实例可以使用同一 clEnvId 登录服务端。此时这些使用了同一 clEnvId 的客户端实例共享同一个 clSeqNo 序列
  • clEnvId 客户端的取值范围是 [0~99] ([100~127] 为保留区间，客户端应避免使用)
  • 可以通过 OesApi_GetClEnvId() 接口获得本客户端实例绑定的 clEnvId
  • 服务端维护的委托信息中，会记录发送此委托的源客户端实例所绑定的 clEnvId。委托回报消息(OesOrdCnfmT.clEnvId) 和 委托查询应答(OesOrdItemT.clEnvId) 会携带此信息
  • 配置文件相关设置请参考 oes_client_sample.conf 中 [oes_client].clEnvId 参数的设置

2.2 增加独立的撤单接口

  • 增加独立的撤单接口 OesApi_SendOrderCancelReq()
  • 接口中 pCancelReq 参数的 pCancelReq->mktId 必填
  • 接口中 pCancelReq 参数的 pCancelReq->invAcctId、pCancelReq->securityId 选填。如果填写则会与被撤委托作匹配
  • 仍保留通过被撤委托 clOrdId 的方式进行撤单。倘若接口中 pCancelReq->origClOrdId > 0，则优先通过pCancelReq->origClOrdId 来匹配被撤委托进行撤单
  • 在通过被撤委托 clEnvId+clSeqNo 进行撤单的场景，倘若接口中 pCancelReq->origClEnvId = 0，则默认使用当前客户端实例绑定的 clEnvId 作为被撤委托的 clEnvId 进行撤单。也就是说，对于本客户端实例发出的委托进行撤单，撤单时 pCancelReq->origClEnvId 可以写0； 如果要对其他客户端实例发出的委托进行撤单，需要准确写撤单接口中的 pCancelReq->origClEnvId 字段

2.3 回报通道支持消息订阅功能

  • 默认情况下，订阅所有类型的回报消息
  • 配置文件相关设置请参考oes_client_sample.conf 中 [oes_client].rpt.subcribeRptTypes 参数的设置

2.4 新增资金变动、持仓变动通知

  • 回报新增两个推送消息：OESMSG_RPT_CASH_ASSET_VARIATION (资金变动通知)、OESMSG_RPT_STOCK_HOLDING_VARIATION (持仓变动通知)
  • 当因委托请求、委托成交、委托撤单而引起可用资金、可用持仓变动时，会触发回报通道的资金变动/持仓变动通知
  • 以一笔买委托为例，OES服务端将会依次推送如下消息：
    1. OESMSG_RPT_ORDER_INSERT 消息 (新委托触发)
    2. OESMSG_RPT_CASH_ASSET_VARIATION 消息（因资金冻结触发）
    3. OESMSG_RPT_ORDER_REPORT 消息（因交易所委托回报触发）
    4. OESMSG_RPT_TRADE_REPORT 消息（因交易所成交回报触发）
    5. OESMSG_RPT_CASH_ASSET_VARIATION 消息（因成交引起资金扣减触发）
    6. OESMSG_RPT_STOCK_HOLDING_VARIATION 消息（因成交引起持仓增加触发）

2.5 补充被撤委托的状态推送

  • 以一笔买委托被成功撤单为例，回报通道会依次推送如下回报消息：
    1. 撤单委托的 OESMSG_RPT_ORDER_INSERT 消息
    2. 撤单委托的 OESMSG_RPT_ORDER_REPORT 消息
    3. 被撤 委托的 OESMSG_RPT_ORDER_REPORT 消息
    4. OESMSG_RPT_CASH_ASSET_VARIATION 消息（因释放冻结资金触发）

2.6 查询接口回调方法类型定义调整

  • 调整查询接口回调方法类型定义 F_OESAPI_ONMSG_T => F_OESAPI_ON_QRY_MSG_T
  • 查询接口回调方法中增加参数 OesQryCursorT *pQryCursor，使用 pQryCursor->isEnd 判断是否是查询的最后一条

2.7 持仓信息中增加持仓成本相关字段

  • '股票持仓信息 (OesStkHoldingItemT)' 结构体中增加字段:
    1. 日初总持仓成本 (originalCostAmt)
    2. 日中累计买入金额 (totalBuyAmt)
    3. 日中累计卖出金额 (totalSellAmt)
    4. 日中累计买入费用 (totalBuyFee)
    5. 日中累计卖出费用 (totalSellFee)
    6. 持仓成本价 (costPrice)

2.8 回报接口回调方法类型定义调整

  • 回报接口回调方法类型定义调整 F_OESAPI_ONMSG_T => F_OESAPI_ON_RPT_MSG_T
  • 回报接口回调方法实际参数列表没有变化

2.9 其他调整

  • 委托回报信息中增加独立的交易所错误码字段
    1. 原错误码字段 OesOrdCnfmT.ordRejReason 保持不变
    2. 当委托被交易所打回废单后，OesOrdCnfmT.ordRejReason 释义为 “交易所拒绝”，此时具体错误原因需要参考 OesOrdCnfmT.exchErrCode，此字段携带交易所定义的错误码
  • 委托状态定义调整
    1. 删除 'OES_ORD_STATUS_DECLARING (正报)' 状态
    2. 重命名 OES_ORD_STATUS_NORMAL => OES_ORD_STATUS_NEW (新订单)
    3. 保留 OES_ORD_STATUS_NORMAL 定义作为版本切换间的兼容
  • 回报消息类型定义调整
    1. 重命名回报消息类型 OESMSG_RPT_ORDER_REJECT => OESMSG_RPT_BUSINESS_REJECT (OES业务拒绝, 委托/撤单未通过风控检查等)
    2. 保留 OESMSG_RPT_ORDER_REJECT 定义作为版本切换间的兼容
  • 调整 '资金信息(OesCashAssetItemT)' 中部分字段: 3. '当前余额'字段重命名 currentBal => currentTotalBal
  • 新增API接口 '获取API的发行版本号 (OesApi_GetApiVersion)'
  • 新增API接口 '获取当前交易日 (OesApi_GetTradingDay)'
  • 调整佣金查询结果中feeRate字段的精度，当佣金计算模式为 ‘按金额’ 时，feeRate 字段所代表的比率精度由 '百万分之一' => '千万分之一'

OES_0.15.3 / 2017-08-14

更新内容

  1. 现货产品基础信息(OesStockBaseInfoT) 中 - 调整字段 isQualificationRequired => qualificationClass, 取值请参考 eOesQualificationClassT - 新增字段 产品风险等级(securityRiskLevel)，取值请参考 eOesSecurityRiskLevelT - 新增字段 逆回购期限(repoExpirationDays) - 新增字段 占款天数(cashHoldDays) 字段
  2. 客户资金基础信息(OesCashAssetBaseInfoT) 中 - 字段重命名 期初余额(originalBal => beginningBal) - 新增字段 期初可用余额(beginningAvailableBal) - 新增字段 期初可取余额(beginningDrawableBal) - 新增字段 当前冲正金额(红冲蓝补的资金净额, reversalAmt) - 新增字段 当前余额(currentBal) - 字段重命名 当前可用余额(tradeAvlAmt => currentAvailableBal) - 字段重命名 当前可取余额(withdrawAvlAmt => currentDrawableBal)
  3. 客户基础信息(OesCustBaseInfoT) 中 - 新增 机构标志(institutionFlag) 字段 - 新增 投资者分类(investorClass) 字段
  4. 证券账户基础信息(OesInvAcctBaseInfoT) 中 - 调整字段 '(股东账户权限限制, acctLimit)'
    • 类型 uint32 => uint64
    • 重命名 acctLimit => Limits - 调整字段 '(股东权限/客户权限, acctRight)'
    • 类型 uint32 => uint64
    • 重命名 acctRight => permissions
  5. API接口中新增 发送出入金委托请求(OesApi_SendFundTrsfReq) 接口
  6. API接口中新增 查询新股配号、中签信息(OesApi_QueryLotWinning) 接口
  7. 新增 ‘新股认购、中签信息查询’ 相关报文定义 - 新增字段 查询新股认购、中签信息过滤条件(OesQryLotWinningFilterT) - 新增字段 新股认购、中签信息内容(OesLotWinningItemT) - 新增字段 查询新股认购、中签信息请求(OesQryLotWinningReqT) - 新增字段 查询新股认购、中签信息应答(OesQryLotWinningRspT)
  8. 出入金业务拒绝消息类型变更 OesFundTrsfReqT => OesFundTrsfRejectT
  9. 出入金委托回报的结构体(OesFundTrsfReportT) 中新增字段 错误码信息(errorInfo)
  10. 出入金委托状态(eOesFundTrsfStatusT) 中 - 调整宏定义 OES_FUND_TRSF_STS_RECV => OES_FUND_TRSF_STS_UNDECLARED - 调整宏定义 OES_FUND_TRSF_STS_DCLR => OES_FUND_TRSF_STS_DECLARED - 新增状态 指令已报到主柜前待回滚(OES_FUND_TRSF_STS_UNDECLARED_ROLLBACK) - 新增状态 指令已报到主柜后待回滚(OES_FUND_TRSF_STS_DECLARED_ROLLBACK) - 新增状态 出入金指令完成，等待事务结束(OES_FUND_TRSF_STS_WAIT_DONE) - 新增状态 出入金执行的挂起状态(OES_FUND_TRSF_STS_SUSPENDED)
  11. 权限不足交易失败时的错误码细分(详情请见 README 错误码表部分)

OES_0.12.9 / 2017-06-06

更新内容

  1. 使用API发起新股认购时，认购委托的bsType需要填成 ‘OES_BS_TYPE_SUBSCRIPTION’
  2. 可以使用API的查询股东账户接口(OesApi_QueryInvAcct)获取该股东账户的新股认购额度(OesInvAcctItemT.subscriptionQuota)
  3. 可以使用API的查询证券发行产品信息接口(OesApi_QueryIssue)获取当日可认购的新股信息(OesIssueItemT)
  4. 可以使用API的查询现货产品信息接口(OesApi_QueryStock)获取债券的每百元应计利息额(OesStockItemT.bondInterest)， 此字段精确到元后八位，即123400000相当于一元二角三分四厘
  5. 买卖国债委托涉及的利息，可以参考‘委托确认信息(OesOrdCnfmT)’中的‘冻结利息(frzInterest)’、‘已发生利息(cumInterest)’字段
  6. 买卖国债成交涉及的利息，可以参考‘成交确认信息(OesTrdCnfmT)’中的‘已发生利息(cumInterest)’字段
  7. ‘买卖类型’的宏定义重命名，具体请参考OES_0.12.8.2版本修改历史。原始宏定义将在下一个版本之后被废弃

OES_0.12.7 / 2017-04-13

1. 主要更新内容

  1. 使用API发逆回购委托时，逆回购委托的bsType需要赋值成 ‘OES_BS_TYPE_REVERSE_REPO’，而不是普通的‘卖出’。
  2. 使用API发逆回购委托时，ordQty 字段代表的单位是‘张’而不是‘手’。
  3. 回报通道增加两类消息：‘出入金委托响应-业务拒绝（OESMSG_RPT_FUND_TRSF_REJECT）’ 和‘出入金委托执行报告(OESMSG_RPT_FUND_TRSF_REPORT)’ 。 - 出入金委托业务拒绝回报消息的回报消息体结构为 OesFundTrsfReqT， - 出入金委托执行报告回报消息的回报消息体结构为 OesFundTrsfReportT， - 如果不在oes系统内做出入金可以忽略这两类回报消息
  4. 在mds_api.h、oes_api.h中增加sutil库头文件的引用，API使用者只需引用mds_api.h、oes_api.h， 不再需要显式引用sutil库的头文件

2. 其他调整：

  1. 不再有独立的出入金通道，client的配置中可以去掉62**端口的配置了
  2. 调整佣金查询结果中feeRate字段的精度，当佣金计算模式为 ‘按金额’ 时， feeRate 字段所代表的比率精度由 '十万分之一' => '百万分之一'
  3. ‘费用计算模式’ 的宏定义名称的调整 eOesCalFeeModeT => eOesCalcFeeModeT
  4. 新增债券、基金的证券类别，调整ETF证券类别宏定义的取值
  5. 新增证券子类别定义
  6. 现货产品基础信息中增加“证券子类别”字段，并且重命名“买入单位”、“卖出单位”字段
  7. ETF产品基础信息中增加“证券类别”、“证券子类别”字段
  8. ETF成份股基础信息中增加“证券子类别”字段