Managing Orders
resource: order — getOrder, cancelOrder, getOpenOrders, getOrderHistory
getOrder (ORD03)
Looks up a single order's current state.
| Field | Required | Description |
|---|---|---|
symbol | ✓ Yes | Trading pair the order belongs to. |
orderId | At least one of these two | Binance's numeric order id. |
origClientOrderId | At least one of these two | The newClientOrderId you supplied when placing the order. |
Output: single order record (symbol, orderId, clientOrderId, orderStatus, price, origQty, executedQty).
cancelOrder (ORD04)
Cancels an open order.
| Field | Required | Description |
|---|---|---|
symbol | ✓ Yes | Trading pair the order belongs to. |
orderId | At least one of these two | Binance's numeric order id. |
origClientOrderId | At least one of these two | The client order id used when placing the order. |
newClientOrderId | No | A new identifier for the cancellation itself. |
cancelRestrictions | No | Optional Binance cancel-restriction flag. |
Output: single order record (symbol, orderId, clientOrderId, orderStatus).
getOpenOrders (ORD05)
Lists currently open orders.
| Field | Required | Description |
|---|---|---|
symbol | No | Omit to return open orders across all symbols. |
Output: items[], count — one entry per open order (symbol, orderId, side, type, price, origQty, executedQty, orderStatus).
getOrderHistory (ORD06)
Lists past orders (any status) for a symbol.
| Field | Required | Description |
|---|---|---|
symbol | ✓ Yes — unlike getOpenOrders | Trading pair to list history for. |
orderId | No | Return orders starting from this id. |
startTime / endTime | No | Time-range filter. |
limit | No | Page size. |
Output: items[], count — same row shape as getOpenOrders.
getOpenOrders vs. getOrderHistory:
getOpenOrders only shows what's
currently resting on the book and lets you omit symbol for a cross-symbol view.
getOrderHistory requires a symbol but returns every order regardless of
status (filled, cancelled, expired, etc.), with pagination fields for scanning further back.