Sign in
Orders

Get a order by ID

Returns order details. Use ?expand=fills to inline fills.

get/v1/orders/{node_order_id}

Path parameters

node_order_idstring required

Order ID

Query parameters

expandstring

Comma-separated expansions: fills

Response

Order details

lineage_deployment_idstring nullable
client_idstring required
client_order_idstring required
created_unix_nsinteger required

Order creation timestamp (nanoseconds since epoch)

engine_phase'gated' | 'sent' | 'working' | 'cancelling' | 'filled' | 'partial' | 'cancelled' | 'cancel_unconfirmed' | 'submit_unconfirmed' | 'rejected' | 'expired' | 'unresolved'

Lifecycle of a single node.

execution_type'graph' | 'armed' | 'adopted' required
expected_fee_1e9integer nullable

Pre-trade fee estimate in 1e9 USD units.

expected_fee_bpsinteger nullable

Pre-trade fee estimate (bps) from FeeModel::worst_case_bps at routing time. Fee-prediction error vs realized surfaces as fee_cost_bps - expected_fee_bps.

failure_classstring nullable
failure_reasonstring nullable
filled_qty_1e8integer required

Filled quantity so far in 1e8 format

first_fill_ts_nsinteger nullable

Exchange timestamp of the first fill in ns.

graph_idstring nullable

Owning execution-graph id. Present for graph rows (incl. ARMED submit-and-hold) — the handle to activate (POST /v1/execution_graphs/:id/activate) or cancel the whole graph. None for venue-only rows.

graph_namestring nullable

Optional human tag on the owning graph (set at submit). Lets a dashboard label a parked/active strategy.

home_regionstring nullable

Graph home region. Null only for a manually adopted venue order.

node_idstring nullable

Engine node id. Null only for a manually adopted venue order.

node_order_idstring required
placed_price_1e9integer nullable

Limit / max price submitted to the venue (1e9 fixed-point). None for market orders with no explicit cap.

pool_idstring nullable

Pool-targeted execution: full PoolId string ("{chain}:{address}" or "{chain}:{address}:{pair_index}")

qty_1e8integer required

Requested quantity in 1e8 format

reconciliation_state'in_sync' | 'reconciling' | 'missing_graph' required
sidestring required

"buy" or "sell"

statusstring required

Canonical lifecycle status: ACCEPTED, RUNNING, PARTIAL, ACTIVE, COMPLETED, CANCELLED, REJECTED, UNCONFIRMED (in doubt — reconciling), UNRESOLVED, WAITING. Venue-merged rows (execution_type:"adopted") carry the venue's own reported status. ARMED rows (execution_type:"armed") are parked submit-and-hold graphs with zero venue footprint — activate them via POST /v1/execution_graphs/:graph_id/activate.

symbolstring required

Trading pair, e.g. "ETH-USD"

time_to_first_fill_msinteger nullable

Latency (ms) from parent arrival to the first fill. Distinct from TCA's execution_time_ms which measures to the last fill.

updated_unix_nsinteger required

Last update timestamp (nanoseconds since epoch)

venue_state'none' | 'in_flight' | 'resting' | 'unknown' required

Changes

No recorded changes to this endpoint across all 1 revision of this API.