Developer Portal
Trader APIsHTTP APIConfiguration

Symbols (Compact)GET

Returns a compact projection of trading symbols for an account group, intended for list views and search. Excludes template-derived and real-time pricing fields.

View as Markdown
GET
/accounts/{account_id}/symbols/compact

Authorization

AuthorizationRequiredBearer <token>

JWT token obtained from the login endpoint

In: header

Path Parameters

account_idRequiredstring

Account ID to fetch symbols for

curl -X GET "http://localhost:8081/api/v1/accounts/acc_123456/symbols/compact" \
  -H "Authorization: Bearer <token>"

Successfully retrieved compact symbols

{
  "symbols": [
    {
      "id": "EURUSD",
      "name": "EURUSD",
      "description": "Euro vs US Dollar",
      "group_id": "retail_group_1",
      "group_name": "Forex Majors",
      "asset_class": "ASSET_CLASS_FOREX_CFD",
      "instrument_type": "INSTRUMENT_TYPE_CFD",
      "status": "TRADE_STATUS_FULL",
      "digits": 5,
      "tick_size": 0.00001,
      "contract_size": 100000,
      "base_asset": "EUR",
      "quote_asset": "USD",
      "lot_name": "Lot",
      "timezone": "America/New_York",
      "volume_min": 0.01,
      "volume_max": 100,
      "volume_step": 0.01,
      "stop_loss_min_distance": 50,
      "take_profit_min_distance": 50,
      "margin_rate": 0.01,
      "trade_sessions": [
        {
          "from": 28800,
          "to": 61200
        }
      ],
      "bid": 1.08525,
      "ask": 1.08535,
      "change": 0.12,
      "timestamp": 1754766471
    }
  ]
}

Symbol by ID

Returns the full details of a single symbol for the authenticated account's group. Supports HTTP ETag revalidation; the response includes a strong `ETag` header derived from the symbol's last update time, and clients (browsers) sending `If-None-Match` will receive `304 Not Modified` when the cached representation is still fresh.

Symbols

Returns a list of trading symbols for a specific account group, enriched with template data. Optionally filterable by a list of symbol IDs.