order_id saved after Create order. For asset-level queries, use the asset_id selected before trading.
1. Retrieve or find the order
Withorder_id, call Retrieve order (GET /order/{order_id}). If the create-order response was lost, call List orders (GET /order) with the client_reference you submitted.
For order history, filter the list by asset_id, symbol, order_status, or from / to. The time window applies to order creation, includes from, and excludes to. Recover the original result before placing another order.
2. Query the holding
After the trade succeeds, call List positions (GET /position) with asset_id.
3. Match the position change
Call List position events (GET /position/event) with order_id to locate the trade’s position changes. Read quantity_delta, quantity_after, and created_at alongside the order’s executed_quantity.
For an asset’s change history, filter by asset_id or symbol, and optionally from / to. Here the time window applies to the event time, includes from, and excludes to.
If a change is an ADJUSTMENT, call List corporate actions (GET /asset/{asset_id}/corporate-action) for that asset. Read old_multiplier, new_multiplier, effective_at, and applied_at to understand applied adjustments; a position event need not be associated with an order.
Order history can also contain DEPOSIT and WITHDRAWAL records. Use transfer_quantity for those records; the quote-and-order flow above creates BUY or SELL trades.
Read all pages
For list queries, passpage_number and page_size. Read data, then increase page_number until you have read total_pages. The default page size is 10 and the maximum is 100.