跳到主要内容

查询所有订单

类型:USER_DATA · 权重:10

状态:已实现。

GET /api/v3/allOrders

该 key 的挂单与已完成订单,最新在前。挂单来自实时订单集合;FILLED 与 CANCELED 订单来自订单历史表。

请求

GET /api/v3/allOrders?symbol=CBTC-USDCB&limit=100&timestamp=1756600000000&signature=...

参数

字段类型必填默认值说明
symbolstring否—省略则返回所有交易对。
limitinteger否500非正数 → 默认值;钳制到 1000。

orderId、startTime、endTime 会被忽略;没有游标分页。

响应 — 200(值仅为示意)

[
{
"symbol": "CBTC-USDCB",
"orderId": "019910a4-9f21-7b34-8c56-1d2e3f4a5b6c",
"orderListId": -1,
"clientOrderId": "019910a4-9f21-7b34-8c56-1d2e3f4a5b6c",
"price": "50000",
"origQty": "0.001",
"executedQty": "0.001",
"cummulativeQuoteQty": "50.000",
"status": "FILLED",
"timeInForce": "GTC",
"type": "LIMIT",
"side": "BUY",
"time": 1756600000123,
"updateTime": 1756600000123,
"isWorking": false
},
{
"symbol": "CBTC-USDCB",
"orderId": "019910a3-1111-7b34-8c56-1d2e3f4a5b6c",
"orderListId": -1,
"clientOrderId": "019910a3-1111-7b34-8c56-1d2e3f4a5b6c",
"price": "56905.00",
"origQty": "0.5",
"executedQty": "0.2",
"cummulativeQuoteQty": "11381.000",
"status": "CANCELED",
"timeInForce": "IOC",
"type": "MARKET",
"side": "SELL",
"time": 1756599990000,
"updateTime": 1756599990000,
"isWorking": false
}
]
字段说明
statusNEW、PARTIALLY_FILLED(挂单)或 FILLED、CANCELED(历史)。剩余部分被撤销的 MARKET 单报告为 CANCELED,且 executedQty 非零。
time、updateTime挂单为创建时间;历史行为终结时间。两个字段值相同。
cummulativeQuoteQtyexecutedQty × price;MARKET 单的 price 是下单时记录的保护价(bestAsk × 1.05 / bestBid × 0.95),不是成交 VWAP——实际名义金额请用 myTrades。
isWorkingNEW / PARTIALLY_FILLED 为 true,否则为 false。
clientOrderId等于 orderId(见 查询订单)。

历史仅向前记录:只有在订单历史表上线(2026-07-22)之后终结的订单才会以 FILLED / CANCELED 出现。更早完成的订单无法重建;它们的成交仍可在 myTrades 中看到。

错误

HTTPcode原因
429-1003权重桶耗尽。
500-1000数据库不可用。

与 Binance 的差异

  • 没有 orderId / startTime / endTime 过滤;最新在前。
  • 不会出现 EXPIRED、REJECTED、EXPIRED_IN_MATCH 状态;IOC 的剩余部分为 CANCELED。
  • time 与 updateTime 相同,历史行中为终结时间而非创建时间。