Query Order

Type: USER_DATA · Weight: 1

Status: Live in production. Terminal orders (FILLED / CANCELED) are looked up from order history; -2011 is returned only when the order does not exist or belongs to another account.

GET /api/v3/order

Look up one of your orders by id. Open orders (NEW or PARTIALLY_FILLED) are read live; orders that have fully filled or been cancelled are read from order history and returned with their final status, executedQty and finalization time. History is prospective: an order finalized before 2026-07-22 is not there and answers -2011; allOrders has the same coverage.

The response's clientOrderId is always equal to orderId: the gateway does not yet store the newClientOrderId you supplied at placement, so client ids cannot be used to look orders up.

Request

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

Parameters

Name	Type	Required	Notes
`symbol`	string	yes
`orderId`	string	yes	Order UUID. Non-UUID → `-1100`.
`origClientOrderId`	string	no	Ignored.

Response — 200 (values illustrative)

{
  "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
}

Field	Notes
`clientOrderId`	Equals `orderId`. The `newClientOrderId` you sent is used for idempotency at placement but is not stored on the order.
`executedQty`	`origQty − remaining`.
`cummulativeQuoteQty`	`executedQty × price` (the limit price — or, for a MARKET order still open, its protective band price — not the fill VWAP).
`status`	`NEW` or `PARTIALLY_FILLED` for an open order; `FILLED` or `CANCELED` for a finalized one.
`timeInForce`	`GTC` for LIMIT, `IOC` for MARKET.
`time`, `updateTime`	Open order: both the creation time. Finalized order: both the finalization time. Unix ms.
`isWorking`	`true` for an open order, `false` once finalized.

Errors

HTTP	code	cause
`400`	`-1102`	`symbol` or `orderId` missing.
`400`	`-1100`	`orderId` not a UUID.
`422`	`-2011`	No order with that id for this key and symbol (or finalized before history began).
`429`	`-1003`	Weight bucket exhausted.

Differences from Binance

Orders finalized before order history shipped (2026-07-22) return -2011.
clientOrderId mirrors orderId; origClientOrderId lookups are not supported.
cummulativeQuoteQty is computed at the limit price.
No stopPrice, icebergQty, origQuoteOrderQty, workingTime, selfTradePreventionMode fields.