跳到主要内容

合约 API 更新日志

Version 1.0.1 (3rd December 2025)

这些变更于 2026 年 1 月 11 日生效。

  • Market Summary(现为市场信息)中的 minRiskLimitmaxRiskLimitmaxPosition 现在以名义价值表示,而非基于合约的单位。
  • 市场风险限额riskLimitValue 现在以名义价值表示。
  • Get Risk LimitriskLimit 现在以名义价值表示;响应中新增 riskLimitLevel 字段。
  • Set Risk Limit:新增必填请求字段 riskLimitLevelriskLimit 不再被接受。

Version 1.0.0 (10th July 2025)

这些变更于 2025 年 7 月 16 日生效。

  • 发布合约 v2.3 API。

相对于 v2.2 的破坏性变更

以下订单数量字段已被废弃并替换:

已废弃: sizefillSizeoriginalSize

替换字段:

新字段描述
originalOrderSize创建时的原始数量
currentOrderSize最新数量(已成交 + 剩余)
filledSize本次更新的成交数量
totalFilledSize累计成交数量

受影响的端点(订单操作): Create New Order、Amend Order、Cancel Order、Create New Algo Order、Bind TP/SL、Close Position

受影响的端点(订单查询): Query Order、Query Open Orders — sizefilledSizeoriginalOrderSizecurrentOrderSizetotalFilledSize 替换

WebSocket 通知: 推荐使用 notificationApiV4;包含所有新的数量字段。