Developer Portal
Trader APIsHTTP APIHistory

List OrdersGET

Returns order history for the authenticated user

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

From date created to fetch order history for

toRequiredstring

To date created to fetch order history for

curl -X GET "http://localhost:8081/api/v1/accounts/acc_123456/history/orders?from=2025-08-03&to=2025-08-03" \
  -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"
    }
  ]
}

List Deals

Returns deal history for the authenticated user

List Positions

Returns position history for the authenticated user