撤销订单(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)。
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
symbol | string | 是 | standard pair(校验存在性)。 |
orderId | UUID string | 是 | 创建时返回的订单 ID。必须属于调用 key 对应的用户,且在 symbol 上处于未成交状态。 |
响应 — 200
{
"symbol": "BTCUSDT",
"orderId": "8a3f5b2c-4d1e-6f7a-8b9c-0d1e2f3a4b5c",
"status": "CANCELED"
}
symbol、orderId 原样回显请求;status 恒为 CANCELED。撮合引擎移除该订单、且撤单前已产生的成交全部落账后,本调用才返回。
错误
| HTTP | code | msg |
|---|---|---|
400 | -1100 | orderId 不是合法 UUID 或 symbol 未知。 |
422 | -2011 | 订单不存在——从未下过、已完全成交或已撤销,或挂在与所传 symbol 不同的 symbol 上。 |
401 | -2015 | orderId 属于其他用户(ledger 的 PermissionDenied 映射为 -2015)。 |
500 | -1000 | 撮合引擎撤单屏障不可用,或其他下游故障。 |
签名 / API key 错误(-1021、-1022、-1102、-2014、-2015)及限流(-1003,HTTP 429)适用于所有签名接口;见 错误码。
按
origClientOrderId(而非orderId)撤单 暂未支持。