跳到主要内容

更新日志

最后更新：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 的每条持仓数据新增返回 isLeading 和 isFollow，用于标识带单仓位和跟单仓位。
  • 用户影响：现有持仓字段不变。用户可直接通过新增布尔字段区分普通仓、带单仓和跟单仓，无需自行解析内部跟单标识。
  • 相关入口：获取持仓列表

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-volume、GET /deepcoin/market/long-short-ratio 和 GET /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 查询；两者都不传时返回全部支持的合约标记价格。若 instId 和 uly 同时传入，优先使用 instId。
  • 用户影响：现有行情 ticker 和标记价 K 线接口不受影响。只需要当前标记价格的用户可直接接入该接口，不必从 ticker 或 K 线数据中推导。
  • 相关入口：获取标记价格

2026-06-10​

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

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

2026-06-04​

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

  • 类型：新增
  • 影响范围：交易
  • 变化说明：POST /deepcoin/trade/order 现支持传入 clOrdId 作为客户自定义订单 ID，并在订单响应中返回。GET /deepcoin/trade/order 现支持通过 clOrdId 查询单笔订单信息。
  • 用户影响：现有下单和按 ordId 查询方式不受影响。用户可在下单时传入 clOrdId，并在后续查单时使用；若同时传入 ordId 和 clOrdId，优先使用 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 行为不变。用户可根据该页面规划请求节奏，降低触发限频错误的概率。
  • 相关入口：限频默认规则