Bitget APIBitget API
统一账户经典账户
旧文档
  • 概览
  • API 文档
  • WebSocket
  • Agent Hub
  • SDK
  • 更新日志
Copied to clipboard
Websocket
公共频道
私有频道
    下单撤单修改订单订单成交快速成交批量下单批量撤单批量修改订单账户持仓ADL通知策略订单频道
Reality
SBE
私有频道

批量撤单

描述

ACK 响应仅代表请求已被成功接收,请通过 WebSocket 订单频道 推送确认每笔撤单的实际状态。

  • 该接口支持通过 WebSocket 批量取消现货、合约、杠杆的未成交以及部分成交订单
  • 每次请求最多支持撤销 20 笔
  • 批量撤单允许部分成功。每笔订单独立处理——若某笔撤单失败,不影响同批次其他订单的撤销
  • 在批量撤单操作中,请确保每次调用仅使用orderId或clientOid进行标识,避免混用。如果在一次调用中混合使用orderId和clientOid,则clientOid将失效
  • 订单标识:可通过 orderId 或 clientOid 识别订单。若两者同时传入,以 orderId 为准

注意:请检查响应 args 列表中每笔订单对应的 code 和 msg 字段,以确认每笔撤单的结果。若结果不明确,请使用 clientOid 或 orderId 查询订单详情。

Code
{ "args": [ { "orderId": "xxxxxxxx" }, { "orderId": "xxxxxxxx" } ], "id": "xxxxx-xxx-xxx-xxxx-xxxxxx", "op": "trade", "topic": "batch-cancel" }

请求参数

参数名参数类型是否必须描述
opString是操作:
trade 交易
idString是请求标识
topicString是频道名:
batch-cancel 批量撤单
argsList<Object>是请求订阅的频道列表
> orderIdString否订单ID
orderId及clientOid二者必传其一
如果两者都传,则orderId优先级更高,忽略clientOid
> clientOidString否自定义订单ID
输入规则:^[0-9A-Za-z_:#\-+\s]{1,32}$,即 1 到 32 个字符,由大小写字母、数字、下划线(_)、连字符(-)、加号(+)、冒号(:)、井号(#)和空格组成
orderId及clientOid二者必传其一
如果两者都传,则orderId优先级更高,忽略clientOid
Code
{ "event": "trade", "id": "bb553cc0-c1fa-454e-956d-c96c8d715760", "topic": "batch-cancel", "args": [ { "code": "0", "msg": "Success", "orderId": "xxxxxxxxxxxxx", "clientOid": "xxxxxxxxxxxxx", "receiveTime": "1750034396998123", "pushTime": "1750034397076456" }, { "code": "25204", "msg": "Order does not exist", "orderId": "xxxxxxxxxxxxx", "clientOid": "xxxxxxxxxxxxx", "receiveTime": "1750034396999456", "pushTime": "1750034397077789" } ], "code": "0", "msg": "Success", "connId": "xxxxxxxxxx", "rateLimit": [ { "limit": "10", "remaining": "9" } ], "ts": "1751980011084" }

响应参数说明

返回字段参数类型字段说明
eventString事件
trade 交易
error参数错误
idString请求标识
topicString频道名
batch-cancel 批量撤单
argsList<Object>订单列表
> codeString状态码
> msgString状态消息
> orderIdString订单ID
> clientOidString自定义订单ID
> receiveTimeString网关接收时间
Unix微秒时间戳
> pushTimeString网关推送时间
Unix微秒时间戳
codeString状态码
msgString状态消息
connIdString连接ID
rateLimitArray限频余额数组
> limitString该维度限额
> remainingString剩余可用次数
tsString时间戳
批量下单批量修改订单
JSON
JSON