Symbols

Discover which symbols are enabled for your key. Response shapes differ slightly by route prefix.

All routes require authentication via x-api-key. Stocks, forex, indices, ETFs, and commodities return a symbols array (no top-level count). Crypto returns items under data with a type: "crypto" discriminator and a top-level count. Use these discovery routes to stay in sync with the symbols enabled for your key — the same codes appear on the public Symbols directory.

GET/stocks/symbols

Stocks symbol list (global)

Returns enabled stocks with market-qualified symbols (CC:SYMBOL), sorted by market then base symbol. Optional query market=CC filters to one market (e.g. market=US). Omit market to list all enabled markets for this deployment.

Request

curl -sS "https://api.tickerlayer.com/stocks/symbols?market=US" \
  -H "x-api-key: <YOUR_API_KEY>"

Response 200 OK

{
  "symbols": [
    {
      "symbol": "US:AAPL",
      "base_symbol": "AAPL",
      "market": "US",
      "name": "Apple Inc."
    },
    {
      "symbol": "US:TSLA",
      "base_symbol": "TSLA",
      "market": "US",
      "name": "Tesla, Inc."
    }
  ]
}

GET/forex/symbols

Forex symbol list

Returns enabled FX pairs and crosses, sorted by symbol ascending.

Request

curl -sS "https://api.tickerlayer.com/forex/symbols" \
  -H "x-api-key: <YOUR_API_KEY>"

Response 200 OK

{
  "symbols": [
    { "symbol": "EURUSD", "name": "Euro / United States Dollar" },
    { "symbol": "GBPUSD", "name": "British Pound / United States Dollar" }
  ]
}

GET/crypto/symbols

Crypto symbol list

Returns enabled crypto spot symbols with display names and a "crypto" type discriminator.

Request

curl -sS "https://api.tickerlayer.com/crypto/symbols" \
  -H "x-api-key: <YOUR_API_KEY>"

Response 200 OK

{
  "data": [
    { "symbol": "BTCUSD", "name": "Bitcoin / USD", "type": "crypto" },
    { "symbol": "ETHUSD", "name": "Ethereum / USD", "type": "crypto" }
  ],
  "count": 2
}

Prefer GET /crypto/symbols for consistency with other asset-class list routes. The legacy GET /symbols route merges crypto, forex, commodities, ETFs, and indices only — it does not include stocks. Stocks stay on GET /stocks/symbols. Bonds have no list route (REST yield only).

GET/indices/symbols

Indices symbol list

Returns curated index symbols available on the REST API (generic regional codes), sorted by symbol ascending.

Request

curl -sS "https://api.tickerlayer.com/indices/symbols" \
  -H "x-api-key: <YOUR_API_KEY>"

Response 200 OK

{
  "symbols": [
    { "symbol": "DE40", "name": "Germany 40" },
    { "symbol": "EU50", "name": "Europe 50" },
    { "symbol": "JP225", "name": "Japan 225" },
    { "symbol": "US500", "name": "US 500" }
  ]
}

Public codes are source-neutral (for example US500, JP225, HK50). See also the Indices REST reference.

GET/etfs/symbols

ETFs symbol list

Returns ETF-style symbols available on the REST API (curated codes plus enabled long-tail / regional rows for your key), sorted by symbol ascending.

Request

curl -sS "https://api.tickerlayer.com/etfs/symbols" \
  -H "x-api-key: <YOUR_API_KEY>"

Response 200 OK

{
  "symbols": [
    { "symbol": "US100ETF", "name": "US growth 100" },
    { "symbol": "US500ETF", "name": "US 500" }
  ]
}

Display names are product-generic (no issuer or licensed benchmark branding). See also the ETFs REST reference.

GET/commodities/symbols

Commodity symbol list

Returns enabled commodity reference symbols (metals, energy, agriculture), sorted by symbol ascending. Aliases may be accepted on quote routes but are not repeated in this list.

Request

curl -sS "https://api.tickerlayer.com/commodities/symbols" \
  -H "x-api-key: <YOUR_API_KEY>"

Response 200 OK

{
  "symbols": [
    { "symbol": "BRENTUSD", "name": "Brent crude oil" },
    { "symbol": "XAUUSD", "name": "Gold" },
    { "symbol": "WTIUSD", "name": "WTI crude oil" }
  ]
}