Developer Portal
Trader APIsHTTP APIConfiguration

Symbol by IDGET

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.

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

Authorization

AuthorizationRequiredBearer <token>

JWT token obtained from the login endpoint

In: header

Path Parameters

account_idRequiredstring

Account ID to fetch the symbol for

symbol_idRequiredstring

Symbol identifier

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

Successfully retrieved symbol

{
  "id": "EURUSD",
  "name": "EURUSD",
  "group_id": "retail_group_1",
  "group_name": "Forex Majors",
  "description": "Euro vs US Dollar",
  "asset_class": "ASSET_CLASS_FOREX_CFD",
  "instrument_type": "INSTRUMENT_TYPE_CFD",
  "status": "TRADE_STATUS_FULL",
  "digits": 5,
  "contract_size": 100000,
  "tick_size": 0.00001,
  "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,
  "limit_min_distance": 10,
  "stop_min_distance": 10,
  "margin_rate": 0.01,
  "leverage_tiers": [
    {
      "leverage": 100,
      "exposure_level_usd": 50000
    }
  ],
  "commission_rate": 2.5,
  "commission_mode": "COMMISSION_MODE_USD_PER_MILLION",
  "min_commission": 1,
  "trade_sessions": [
    {
      "from": 28800,
      "to": 61200
    }
  ],
  "quote_sessions": [
    {
      "from": 28800,
      "to": 61200
    }
  ],
  "bid": 1.08525,
  "ask": 1.08535,
  "change": 0.12,
  "timestamp": 1754766471
}