跳到主要内容

撤销订单(TRADE)

类型:TRADE

DELETE /fapi/v1/order

按 orderId 撤销未成交订单。

请求

DELETE /fapi/v1/order?symbol=BTCUSDT&orderId=<uuid>

Query 参数

参数仅从 URL query string 读取(body 仅参与签名载荷);query string 缺少必填参数时返回 HTTP 400(axum 的纯文本拒绝,而非 {code, msg} JSON)。

字段类型必填说明
symbolstring是standard pair(校验存在性)。
orderIdUUID string是创建时返回的订单 ID。必须属于调用 key 对应的用户,且在 symbol 上处于未成交状态。

响应 — 200

{
"symbol": "BTCUSDT",
"orderId": "8a3f5b2c-4d1e-6f7a-8b9c-0d1e2f3a4b5c",
"status": "CANCELED"
}

symbol、orderId 原样回显请求;status 恒为 CANCELED。撮合引擎移除该订单、且撤单前已产生的成交全部落账后,本调用才返回。

错误

HTTPcodemsg
400-1100orderId 不是合法 UUID 或 symbol 未知。
422-2011订单不存在——从未下过、已完全成交或已撤销,或挂在与所传 symbol 不同的 symbol 上。
401-2015orderId 属于其他用户(ledger 的 PermissionDenied 映射为 -2015)。
500-1000撮合引擎撤单屏障不可用,或其他下游故障。

签名 / API key 错误(-1021、-1022、-1102、-2014、-2015)及限流(-1003,HTTP 429)适用于所有签名接口;见 错误码。

按 origClientOrderId(而非 orderId)撤单 暂未支持。