(V0.1) 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.

V0/V0.1 reference: market_maker/PLAN.md §16.2 item 3. 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

Order found; full lifecycle state returned.

401

Missing or invalid Authorization header.

403

Order belongs to a different account.

404

Order ID not known to either the engine or the audit indexer.

503

A required downstream (matching engine, ClickHouse, custody, instrument service) is unreachable. The request was not processed; retry with backoff.