撤销订单

类型：TRADE · 权重：1 · 不计入订单计数桶

状态：已实现。

DELETE /api/v3/order

按 orderId 撤销一笔挂单。撤单永远不消耗订单计数配额，因此在下单被限流时依然可以随时撤回报价。

请求 —— 参数放在 query string 中（与所有方法一样），signature 最后

DELETE /api/v3/order?symbol=CBTC-USDCB&orderId=019910a4-9f21-7b34-8c56-1d2e3f4a5b6c&timestamp=1756600000000&signature=...

参数

字段	类型	必填	说明
symbol	string	是	必须与订单的交易对一致。
orderId	string	是	订单 UUID。非 UUID 值 → -1100。
origClientOrderId	string	否	仅回显；不用于查找。不支持按客户端订单 id 撤单。

响应 — 200

{
  "symbol": "CBTC-USDCB",
  "orderId": "019910a4-9f21-7b34-8c56-1d2e3f4a5b6c",
  "origClientOrderId": null,
  "status": "CANCELED"
}

未传该参数时 origClientOrderId 为 null。不返回其他订单字段（price、origQty、executedQty）；最终状态请从 allOrders 读取。

错误

HTTP	code	原因
400	-1102	缺少 symbol 或 orderId。
400	-1100	orderId 不是 UUID，或交易服务拒绝了请求。
422	-2011	订单不存在——id 未知、已成交、已撤销，或不属于你。
429	-1003	权重桶耗尽。
500	-1000	交易服务不可用。

撤单时收到 -2011 通常意味着订单在你上次查看与撤单之间已经完成；请视为终态并查看 allOrders。

与 Binance 的差异

• 所有方法的参数都只从 query string 读取。
• origClientOrderId 不能用于标识订单；orderId 为必填。
• 响应为上面的简短形式，不是完整订单对象。
• 没有 cancelReplace。全部撤销见 DELETE /api/v3/openOrders，symbol 必填。