Orders

Get order history from database (append-only lifecycle events)

Fetches order lifecycle events from the persistent database. Every status transition (submitted → working → filled, or submitted → cancelled) is recorded as a separate row.

Filters: account_id, symbol, side, status, from/to date range. Pagination: limit (default 100, max 500) and offset.

Unlike /trade/orders which shows current in-memory state, this endpoint returns the full audit trail from the database and survives engine restarts.

GET

trade

orders

history

// Get all filled ES orders this month
const params = new URLSearchParams({
  symbol: 'ES',
  status: 'filled',
  from: '2026-01-01',
  limit: '50'
});

const response = await fetch(`/trade/orders/history?${params}`, {
  headers: { 'Authorization': `Bearer ${token}` }
});

const { data } = await response.json();
console.log(`Found ${data.total} orders (showing ${data.orders.length})`);
data.orders.forEach(o => {
  console.log(`${o.side} ${o.quantity} ${o.contract} @ ${o.filled_price}`);
});

if (data.has_more) {
  console.log('Fetch next page with offset:', data.offset + data.limit);
}

{
  "code": null,
  "data": [
    {
      "contract": "MNQU6",
      "filled_at": "2026-08-08T14:31:40Z",
      "filled_price": 29510.25,
      "id": "7f3a2b1c-9d4e-4f6a-8b2c-1e5d7a9c3b60",
      "limit_price": 29510.25,
      "order_type": "limit",
      "quantity": 2,
      "realized_pnl": 0,
      "side": "buy",
      "status": "filled"
    }
  ],
  "error": null,
  "success": true
}

{
  "code": "ERROR_CODE",
  "data": null,
  "error": "Error message describing what went wrong",
  "success": false
}

{
  "code": "ERROR_CODE",
  "data": null,
  "error": "Error message describing what went wrong",
  "success": false
}

Query Parameters

account_id

string<uuid> | null

Filter by trading account ID

contract

string | null

Filter by contract (full symbol like ESH6, NQH6)

product

string | null

Filter by product (CME, CBOT, NYMEX, COMEX)

symbol

string | null

Filter by symbol (ES, NQ, YM, RTY, CL, GC, etc.)

side

string | null

Filter by order side (buy, sell)

order_type

string | null

Filter by order type (market, limit, stop)

status

string | null

Filter by order status (e.g. pending_submit, new, working, pending, filled, cancelled, rejected)

from

string | null

Start date (inclusive, ISO 8601 format)

string | null

End date (inclusive, ISO 8601 format)

before

string | null

Keyset cursor: return rows older than this processed_at timestamp.

limit

integer<int32> | null

Maximum number of results (default: 100, max: 1000)

offset

integer<int32> | null

Number of results to skip for pagination (default: 0)

Response

Paginated append-only order lifecycle events

Paginated order history response

success

boolean

required

code

string | null

data

object | null

Show child attributes

error

string | null

⌘I

// Get all filled ES orders this month
const params = new URLSearchParams({
  symbol: 'ES',
  status: 'filled',
  from: '2026-01-01',
  limit: '50'
});

const response = await fetch(`/trade/orders/history?${params}`, {
  headers: { 'Authorization': `Bearer ${token}` }
});

const { data } = await response.json();
console.log(`Found ${data.total} orders (showing ${data.orders.length})`);
data.orders.forEach(o => {
  console.log(`${o.side} ${o.quantity} ${o.contract} @ ${o.filled_price}`);
});

if (data.has_more) {
  console.log('Fetch next page with offset:', data.offset + data.limit);
}

{
  "code": null,
  "data": [
    {
      "contract": "MNQU6",
      "filled_at": "2026-08-08T14:31:40Z",
      "filled_price": 29510.25,
      "id": "7f3a2b1c-9d4e-4f6a-8b2c-1e5d7a9c3b60",
      "limit_price": 29510.25,
      "order_type": "limit",
      "quantity": 2,
      "realized_pnl": 0,
      "side": "buy",
      "status": "filled"
    }
  ],
  "error": null,
  "success": true
}

{
  "code": "ERROR_CODE",
  "data": null,
  "error": "Error message describing what went wrong",
  "success": false
}

{
  "code": "ERROR_CODE",
  "data": null,
  "error": "Error message describing what went wrong",
  "success": false
}

Platform API

Trade API

Market Data API

Get order history from database (append-only lifecycle events)

Query Parameters

Response