Get Order
GET /orders/{orderId}
Auth: Authorization: Bearer <access_token>.
This route does not return a plaintext order. Use the Orders Channel WebSocket for status, price, and size.
Path Parameters
| Parameter | Description |
|---|---|
orderId | Order id returned on place |
Query Parameters (alternative)
GET /orders?client_order_id={client_order_id}
Exactly one of {orderId} or client_order_id must be supplied.
Example
curl the REST origin/api/v1/orders/1875340519620476928 \
-H "Authorization: Bearer $TOKEN"
Response
{
"code": 0,
"data": {
"encrypted": true,
"order_id": "1875340519620476928",
"hint": "subscribe to the WS Orders channel and decrypt locally for live order state"
},
"timestamp": "2026-04-20T10:30:00.123Z",
"request_id": "req_..."
}
| Field | Type | Description |
|---|---|---|
encrypted | boolean | Always true — the order body is not on this route |
order_id | string | Venue id |
hint | string | Pointer to the orders WebSocket |
Errors
| HTTP / code | Meaning |
|---|---|
400 / 1400 | Invalid order_id, or missing client_order_id on the query route |
404 / 1404 | Unknown client_order_id |
403 / 1403 | Numeric id is unknown, terminal, or not owned by the authenticated user |
503 / 1503 | Sequencer unavailable or returned an unexpected reply |