Developer Portal
Trader APIsHTTP APIHistory

List OrdersGET

Returns one page of order history for the authenticated user, newest creation time first. There is no maximum date range. When more orders match, the response carries `next_token`; pass it back to fetch the next page. An absent `next_token` means this is the last page.

View as Markdown
GET
/accounts/{account_id}/history/orders

Authorization

AuthorizationRequiredBearer <token>

JWT token obtained from the login endpoint

In: header

Path Parameters

account_idRequiredstring

Account ID to fetch order history for

Query Parameters

fromstring

Inclusive start date (YYYY-MM-DD, UTC). Omit for all history.

toRequiredstring

Inclusive end date (YYYY-MM-DD, UTC).

limitinteger

Maximum number of orders to return in one page (default 25, max 500)

Default: 25Minimum: 1Maximum: 500
next_tokenstring

Opaque cursor from the previous page's next_token. Send it unchanged, with the same from/to; omit it for the first page.

curl -X GET "http://localhost:8081/api/v1/accounts/acc_123456/history/orders?from=2025-08-03&to=2025-08-03&limit=25&next_token=%3Cstring%3E" \
  -H "Authorization: Bearer <token>"

Successfully retrieved order history

{
  "orders": [
    {
      "id": "ord_123456",
      "account_id": "acc_123456",
      "symbol_id": "EURUSD",
      "symbol_name": "EURUSD",
      "position_id": "pos_123456",
      "client_order_id": "client_123",
      "parent_order_id": "ord_parent_123",
      "cancels_order_id": "ord_cancel_123",
      "created_at": "2025-01-01T12:00:00Z",
      "updated_at": "2025-01-01T12:30:00Z",
      "expiration_date": "2025-01-02T12:00:00Z",
      "qty_original": 1,
      "qty_filled": 0.5,
      "qty_remaining": 0.5,
      "limit_price": 1.085,
      "stop_price": 1.084,
      "fill_price": 1.0851,
      "side": "TRADE_SIDE_BUY",
      "type": "ORDER_TYPE_LIMIT",
      "status": "ORDER_STATUS_WORKING",
      "time_in_force": "TIF_GTC",
      "comment": "Manual order"
    }
  ],
  "next_token": "string"
}

Balance History

Returns the most recent balance changes for the account, oldest first, up to `points` items. Each item is the balance right after the change and the `reason` for it. Credit and the P&L of open positions are not included. An account with no history returns an empty `data` array.

List Positions

Returns one page of closed-position history for the authenticated user, newest creation time first. There is no maximum date range. When more positions match, the response carries `next_token`; pass it back to fetch the next page. An absent `next_token` means this is the last page.