跳到主要内容

更新日志

最后更新:2026-06-29

本页面集中记录 Deepcoin API 已确认的变更,包括新增接口、行为调整、废弃计划、限频变更,以及可能影响接入理解的文档修正。

即将上线

暂无已确认的即将上线 API 变更。

已上线

2026-06-29

新增:WebSocket 批量撤单与批量改单

  • 类型:新增
  • 影响范围:WebSocket
  • 变化说明:私有 WebSocket 现支持通过 batch-cancel-order 动作提交批量撤单(最多 50 笔),以及通过 batch-replace-order 动作提交批量改单(最多 20 笔),响应中逐笔返回结果码和结果说明。
  • 用户影响:现有 WebSocket 交易和单笔撤单/改单接口不受影响。用户可在单次 WebSocket 请求中撤销或修改多笔订单,减少网络往返次数。
  • 相关入口:WS 交易

2026-06-25

更新:持仓跟单标签

  • 类型:更新
  • 影响范围:账户
  • 变化说明:GET /deepcoin/account/positions 的每条持仓数据新增返回 isLeadingisFollow,用于标识带单仓位和跟单仓位。
  • 用户影响:现有持仓字段不变。用户可直接通过新增布尔字段区分普通仓、带单仓和跟单仓,无需自行解析内部跟单标识。
  • 相关入口:获取持仓列表

2026-06-19

新增:WebSocket 批量下单

  • 类型:新增
  • 影响范围:WebSocket
  • 变化说明:私有 WebSocket 现支持通过 batch-orders 动作提交批量订单。发送 {"action":"batch-orders","param":{"id":"...","args":[...]}} 即可在单次请求中提交最多 5 笔订单。每笔订单支持与 REST 批量下单相同的字段(instId、tdMode、side、ordType、sz、px 等),并支持可选止盈止损触发价。
  • 用户影响:现有 WebSocket 交易和 REST 下单接口不受影响。用户可在同时提交多笔订单时减少网络往返次数。
  • 相关入口:WS 交易

2026-06-12

新增:交易大数据行情接口

  • 类型:新增
  • 影响范围:行情
  • 变化说明:新增 GET /deepcoin/market/open-interest-volumeGET /deepcoin/market/long-short-ratioGET /deepcoin/market/taker-volume,支持按合约产品 ID、时间粒度、可选时间范围和返回数量查询交易大数据。
  • 用户影响:现有行情接口不受影响。用户可直接查询合约持仓量和交易量、多空人数比、主动买卖量,无需直接接入底层图表配置接口。
  • 相关入口:获取持仓量和交易量获取多空人数比获取主动买卖量限频默认规则

2026-06-11

新增:WebSocket 私有频道订阅

  • 类型:新增
  • 影响范围:WebSocket
  • 变化说明:私有 WebSocket 现支持通过 tables 参数订阅指定频道。发送 {"action":"subscribe","tables":["Account","AccountDetail","Order","Position","Trade","TriggerOrder"]} 即可只订阅需要的频道。若不指定 tables 参数,则默认订阅所有频道。如需取消订阅某些频道,重新订阅时在 tables 参数中仅包含需要保留的频道即可。
  • 用户影响:现有私有 WebSocket 连接不受影响。仅需部分推送频道的用户可通过订阅子集减少数据传输量。
  • 相关入口:WebSocket 私有频道订阅

新增:标记价格查询

  • 类型:新增
  • 影响范围:行情
  • 变化说明:新增 GET /deepcoin/market/mark-price,用于查询永续合约标记价格。instType=SWAP 必填。用户可通过 instId 查询,也可通过 uly 查询;两者都不传时返回全部支持的合约标记价格。若 instIduly 同时传入,优先使用 instId
  • 用户影响:现有行情 ticker 和标记价 K 线接口不受影响。只需要当前标记价格的用户可直接接入该接口,不必从 ticker 或 K 线数据中推导。
  • 相关入口:获取标记价格

2026-06-10

新增:撤单与改单客户自定义订单 ID 支持

  • 类型:新增
  • 影响范围:交易
  • 变化说明:POST /deepcoin/trade/cancel-orderPOST /deepcoin/trade/replace-order 现支持通过 clOrdId 定位活动订单。客户自定义订单 ID 必须符合 ^[A-Za-z0-9]{1,20}$
  • 用户影响:现有按 ordIdOrderSysID 撤单、改单的方式不受影响。用户现在可以通过 clOrdId 撤销或修改活动订单;若同时传入系统订单 ID 与 clOrdId,优先使用系统订单 ID。若一个 clOrdId 匹配到多笔活动订单,请使用系统订单 ID。
  • 相关入口:撤单改单

2026-06-04

新增:下单与查询订单客户自定义订单 ID 支持

  • 类型:新增
  • 影响范围:交易
  • 变化说明:POST /deepcoin/trade/order 现支持传入 clOrdId 作为客户自定义订单 ID,并在订单响应中返回。GET /deepcoin/trade/order 现支持通过 clOrdId 查询单笔订单信息。
  • 用户影响:现有下单和按 ordId 查询方式不受影响。用户可在下单时传入 clOrdId,并在后续查单时使用;若同时传入 ordIdclOrdId,优先使用 ordId
  • 相关入口:下单与查询订单

2026-06-03

新增:统一账户余额查询

  • 类型:新增
  • 影响范围:账户
  • 变化说明:新增 GET /deepcoin/account/all-balances,支持查询资金账户、现货账户、USDT 合约账户、币本位合约账户、体验金账户、返佣账户、事件合约账户、跟单账户和机器人账户等多账户余额。响应包含账户余额明细、可用余额、冻结余额、未实现盈亏、总权益、USD 计价权益和汇总信息。
  • 用户影响:现有 GET /deepcoin/account/balances 不受影响。需要按 Deepcoin 产品侧实际账户体系展示或核对余额的用户,可接入该统一账户余额接口,而不是只按交易产品类型查询。
  • 相关入口:统一账户余额限频默认规则

2026-06-02

新增:查询订单

  • 类型:新增
  • 影响范围:交易
  • 变化说明:新增 GET /deepcoin/trade/order,支持按订单 ID 查询单笔订单信息。接口会优先查询历史订单,未命中时再查询当前未成交订单。
  • 用户影响:现有订单查询接口不受影响。需要用单一入口查询订单状态的用户可接入该接口。
  • 相关入口:查询订单

2026-05-28

新增:账户交易手续费率查询

  • 类型:新增
  • 影响范围:账户
  • 变化说明:新增 GET /deepcoin/account/trade-fee,支持按产品类型、产品 ID 或交易品种查询当前账户交易手续费率。
  • 用户影响:现有账户和交易接口不受影响;需要展示手续费率、做账务核对或交易路由判断的用户可接入该接口。
  • 相关入口:获取交易手续费率

2026-05-20

新增:账户杠杆和历史持仓查询接口

  • 类型:新增
  • 影响范围:账户
  • 变化说明:新增 GET /deepcoin/account/leverage-info 查询杠杆配置,新增 GET /deepcoin/account/positions-history 查询合约历史持仓。
  • 用户影响:现有持仓和杠杆相关接口不受影响;需要校验杠杆配置或回补已平仓持仓数据的用户可接入这些接口。
  • 相关入口:查询杠杆倍数获取历史持仓

新增:分仓加仓与合并仓位接口

  • 类型:新增
  • 影响范围:交易
  • 变化说明:新增分仓仓位管理接口:POST /deepcoin/trade/increase-position 用于对指定分仓仓位加仓,POST /deepcoin/trade/merge-positions 用于合并同一产品、同一方向且满足条件的分仓仓位。
  • 用户影响:现有下单和持仓接口不受影响。这两个接口仅适用于合约分仓仓位,接入时需使用持仓接口返回的有效 posId
  • 相关入口:分仓加仓合并仓位

新增:REST API 限频默认规则页面

  • 类型:文档更新
  • 影响范围:REST API
  • 变化说明:新增限频默认规则页面,覆盖账户、行情、交易、跟单、内部划转、子母账号、返佣和资产等接口的默认请求频率。
  • 用户影响:API 行为不变。用户可根据该页面规划请求节奏,降低触发限频错误的概率。
  • 相关入口:限频默认规则