Look up an order by ID — including terminal state.
GET/v1/orders/:order_id
Returns the order's full lifecycle state regardless of whether it is still resting, has been filled, cancelled, rejected, or partially filled. The order must belong to the calling account; foreign accounts return 403.
Terminal orders are served from the
Audit Indexer (ClickHouse orders table); resting orders are served from the
Trading Engine's live view.
Request
Responses
- 200
- 401
- 403
- 404
- 503
Order found; full lifecycle state returned.
Missing or invalid Authorization header.
Order belongs to a different account.
Order ID not known to either the engine or the audit indexer.
A required downstream (matching engine, ClickHouse, custody, instrument service) is unreachable. The request was not processed; retry with backoff.