Orders
Get order history (append-only lifecycle events)
Returns order lifecycle events. Every status transition (submitted → working → filled, or submitted → cancelled) is recorded as a separate entry.
Filters: account_id, symbol, side, status, from/to date range.
Pagination: limit (default 100, max 500) and offset.
Unlike /trade/orders, which shows current orders, this endpoint returns the full audit trail.
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
}Authorizations
Query Parameters
⌘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
}