查询订单

类型：USER_DATA · 权重：1

状态：已上线。 终态订单（FILLED / CANCELED）会从订单历史中查询；仅当订单不存在或不属于当前账户时才返回 -2011。

GET /api/v3/order

按 id 查询你的一笔订单。挂单（NEW 或 PARTIALLY_FILLED）实时读取；已完全成交或已撤销的订单从订单历史读取，返回最终 status、executedQty 和完结时间。历史只向前覆盖：2026-07-22 之前完结的订单不在其中，返回 -2011；allOrders 的覆盖范围相同。

响应中的 clientOrderId 始终等于 orderId：网关目前不存储你下单时提供的 newClientOrderId，因此客户端 id 不能用于查询订单。

请求

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

参数

字段	类型	必填	说明
`symbol`	string	是
`orderId`	string	是	订单 UUID。非 UUID → `-1100`。
`origClientOrderId`	string	否	忽略。

响应 — 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.0003",
  "cummulativeQuoteQty": "15.0000",
  "status": "PARTIALLY_FILLED",
  "timeInForce": "GTC",
  "type": "LIMIT",
  "side": "BUY",
  "time": 1756600000123,
  "updateTime": 1756600000123,
  "isWorking": true
}

字段	说明
`clientOrderId`	等于 `orderId`。你发送的 `newClientOrderId` 在下单时用于幂等，但不会存储在订单上。
`executedQty`	`origQty − 剩余数量`。
`cummulativeQuoteQty`	`executedQty × price`（限价——尚未终结的 MARKET 单则为其保护价——不是成交 VWAP）。
`status`	挂单为 `NEW` 或 `PARTIALLY_FILLED`；已完结订单为 `FILLED` 或 `CANCELED`。
`timeInForce`	LIMIT 为 `GTC`，MARKET 为 `IOC`。
`time`、`updateTime`	挂单：均为创建时间。已完结订单：均为完结时间。Unix 毫秒。
`isWorking`	挂单为 `true`，完结后为 `false`。

错误

HTTP	code	原因
`400`	`-1102`	缺少 `symbol` 或 `orderId`。
`400`	`-1100`	`orderId` 不是 UUID。
`422`	`-2011`	该 key 与交易对下没有此 id 的订单（或在历史记录开始前已完结）。
`429`	`-1003`	权重桶耗尽。

与 Binance 的差异

订单历史上线（2026-07-22）之前完结的订单返回 -2011。
clientOrderId 镜像 orderId；不支持按 origClientOrderId 查询。
cummulativeQuoteQty 按限价计算。
没有 stopPrice、icebergQty、origQuoteOrderQty、workingTime、selfTradePreventionMode 字段。