# Guest Symbols

> Returns every tradable symbol with its contract specification — identifiers, asset class, price precision, contract size and tick size. Trading terms that vary by account (volume limits, stop distances, commissions) and live prices are not included; authenticated clients get those from `/accounts/{account_id}/symbols`. No authentication required.

Source: /trader/api/public-endpoints/get-public-symbols

## `GET /public/symbols`

**Guest Symbols**

Returns every tradable symbol with its contract specification — identifiers, asset class, price precision, contract size and tick size. Trading terms that vary by account (volume limits, stop distances, commissions) and live prices are not included; authenticated clients get those from `/accounts/{account_id}/symbols`. No authentication required.

Tags: `Public Endpoints`

#### Query parameters

- `ids` (string) — Comma-separated list of symbol IDs (max 100). Unknown or inactive IDs are omitted.


### Responses

#### `200` — Active symbols

**Content-Type:** `application/json`

Contract specifications for all tradable symbols.
- `symbols` (array) (required)
  - items:
    Contract specification for a tradable symbol. Excludes account-dependent trading terms and live prices.
    - `id` (string) (required) — Symbol identifier
    - `name` (string) (required) — Symbol display name
    - `description` (string)
    - `asset_class` (string) (required)
      - enum: `ASSET_CLASS_UNSPECIFIED`, `ASSET_CLASS_FOREX_CFD`, `ASSET_CLASS_CFD`, `ASSET_CLASS_STOCK_CFD`, `ASSET_CLASS_ETF_CFD`, `ASSET_CLASS_INDEX_CFD`, `ASSET_CLASS_CRYPTO_CFD`, `ASSET_CLASS_COMMODITY_CFD`
    - `instrument_type` (string)
      - enum: `INSTRUMENT_TYPE_UNSPECIFIED`, `INSTRUMENT_TYPE_CFD`, `INSTRUMENT_TYPE_SPOT`, `INSTRUMENT_TYPE_PERPETUAL`, `INSTRUMENT_TYPE_FUTURE`
    - `status` (string) (required)
      - enum: `TRADE_STATUS_UNSPECIFIED`, `TRADE_STATUS_FULL`, `TRADE_STATUS_CLOSE_ONLY`, `TRADE_STATUS_DISABLED`, `TRADE_STATUS_LONG_ONLY`
    - `digits` (integer) (required) — Number of decimal places for price display
    - `contract_size` (integer) (required) — Contract size in base currency units
    - `tick_size` (number) (required) — Minimum price movement
    - `base_asset` (string)
    - `quote_asset` (string)
    - `lot_name` (string)
    - `timezone` (string)

#### `304` — Not modified

#### `400` — Invalid ID filter

**Content-Type:** `application/json`

- `error` (object) (required)
  - `type` (string) (required) — Error type code
  - `message` (string) (required) — Human-readable error message
  - `field` (string) — Field name if error is field-specific

#### `429` — The per-client-IP rate limit for this request's class was exceeded, or the service is at capacity for
distinct clients. Retry after the `Retry-After` interval.


**Content-Type:** `application/json`