撤销全部挂单
类型：TRADE · 权重：1 · 不计入订单计数桶
状态：已上线。
DELETE /api/v3/openOrders
一次调用撤销某个交易对上你的全部挂单。为做市商的 kill switch 而设：撤单永远不消耗订单计数配额，因此即使 key 在下单上被限流，也能整梯子撤回报价。
请求 —— 参数放在 query string 中，signature 最后
DELETE /api/v3/openOrders?symbol=CBTC-USDCB×tamp=1756600000000&signature=...
参数
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
symbol | string | 是 | 只撤销该交易对的订单。不带 symbol 的调用会被拒绝，绝不会变成"撤销全部交易对"。 |
响应 — 200 —— 每个被撤销的订单一个元素，按创建时间从早到晚
[
{ "symbol": "CBTC-USDCB", "orderId": "019910a4-9f21-7b34-8c56-1d2e3f4a5b6c", "origClientOrderId": null, "status": "CANCELED" },
{ "symbol": "CBTC-USDCB", "orderId": "019910a4-a1c2-7d3e-9f40-5a6b7c8d9e0f", "origClientOrderId": null, "status": "CANCELED" }
]
空数组表示没有挂单。在列出与撤销之间已成交或已撤销的订单会被省略，而不是报错：两种情况下的最终状态是一样的。
错误
| HTTP | code | 原因 |
|---|---|---|
400 | -1102 | 缺少 symbol。 |
400 | -1100 | 交易服务拒绝了某笔撤单。 |
429 | -1003 | 权重桶耗尽。 |
500 | -1000 | 交易服务或数据库不可用。 |
遇到 -1102 以外的错误时，部分订单可能已经被撤销；请调用 GET /api/v3/openOrders 读取剩余挂单。
与 Binance 的差异
- 每个订单只返回简短的撤单元素，不是完整订单对象。
- 不支持不带
symbol的DELETE /api/v3/openOrders。