> From TickerLayer docs, Symbols: https://tickerlayer.com/docs/rest/symbols#perpetuals-symbols
> REST base URL https://api.tickerlayer.com, API key in the `x-api-key` header. WebSocket wss://stream.tickerlayer.com?apiKey=YOUR_API_KEY. Full API reference: https://tickerlayer.com/llms-full.txt

## Perpetuals symbol list

**Endpoint:** `GET /perpetuals/symbols`

Every perpetual contract with its name, underlying class and how many sources list it. Open to any valid key, with or without Perpetuals on the account.

### Query parameters

| Parameter | Type | Description |
| --- | --- | --- |
| `underlying` | string | Filter by the class of the underlying; an unknown value is ignored. Values: `equity`, `etf`, `commodity`, `index`, `forex`, `pre_ipo`, `crypto`. |

### Request

```bash
curl -sS "https://api.tickerlayer.com/perpetuals/symbols?underlying=commodity" \
  -H "x-api-key: <YOUR_API_KEY>"
```

### Response

```json
{
  "symbols": [
    {
      "symbol": "XAUUSDT",
      "name": "Gold",
      "instrument_type": "perpetual",
      "underlying_asset_class": "commodity",
      "base": "XAU",
      "source_count": 6
    }
  ],
  "count": 8
}
```

### Notes

Source-level accounts can add `?sources=true` for the per-source universe; see [Perpetuals](https://tickerlayer.com/docs/products/perpetuals#perpetuals-symbols-sources).