# Every symbol

> Every symbol the levels API answers for: class, cadence, whether it has an open-interest book, the unit and the trust grade. No key needed.

Source: https://firmtape.com/docs/developers/live/symbols

Every symbol the levels API answers for: class, cadence, whether it has an open-interest book, the unit and the trust grade. No key needed.

`GET /api/v1/symbols`

Plan Free · No key · Limit 120 a minute per address · Version 1.0.0 · Since 2026-09-30

**This endpoint serves:** [LIVE: Levels API](https://firmtape.com/docs/live#levels-api), [REPLAY: Gamma by symbol](https://firmtape.com/docs/replay#symbols-on-the-site). **Plan:** [Free](https://firmtape.com/features/replay). Free, no account

## Response

The list.

| Field | Meaning | Unit |
| --- | --- | --- |
| `count` (integer) | How many symbols. |  |
| `book` ("volume") | Always `volume`. |  |
| `symbols` (array) | One entry per symbol. |  |
| `symbols[].sym` (string) | The symbol. |  |
| `symbols[].aliases` (array) | Futures: the micro that answers as it. |  |
| `symbols[].name` (string) | Its name. |  |
| `symbols[].class` (string) | `index`, `future`, `etf` or `stock`. |  |
| `symbols[].cadence` (object) | How often its book and price are rebuilt. |  |
| `symbols[].cadence.book` (string) | `1s` or `5m`. |  |
| `symbols[].cadence.price` (string) | `1s`. |  |
| `symbols[].has_oi` (boolean) | Whether it has an open-interest book. |  |
| `symbols[].grade` (string \| null) | The chain's trust grade. |  |
| `symbols[].unit` (string) | Net gamma's unit. |  |
| `symbols[].source` (string) | Where its book comes from. |  |

## Request

```sh
curl \
  "https://firmtape.com/api/v1/symbols"
```

```python
import os, requests

H = {}
r = requests.get("https://firmtape.com/api/v1/symbols", headers=H)
print(r.status_code, r.text[:500])
```

```js
const r = await fetch("https://firmtape.com/api/v1/symbols", {
  method: "GET",
  headers: {  },
});
console.log(r.status, await r.text());
```

## Example response

```json
{
  "count": 2,
  "book": "volume",
  "symbols": [
    {
      "sym": "SPX",
      "name": "S&P 500 Index",
      "class": "index",
      "cadence": {
        "book": "1s",
        "price": "1s"
      },
      "has_oi": true,
      "grade": null,
      "unit": "usd_m_per_point",
      "source": "FirmTape SPX engine, from the full options tape"
    },
    {
      "sym": "QQQ",
      "name": "Invesco QQQ Trust",
      "class": "etf",
      "cadence": {
        "book": "5m",
        "price": "1s"
      },
      "has_oi": true,
      "grade": "A",
      "unit": "usd_per_1pct"
    }
  ]
}
```

## Changes

- 2026-09-30: Added.