Developers menu

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.

GET/api/v1/symbols

Plan FreeNo keyLimit 120 a minute per addressVersion 1.0.0Since 2026-09-30

This endpoint serves

Plan: Free. Free, no account Pricing.

Response

The list.

Field	Meaning	Unit
countinteger	How many symbols.
book"volume"	Always `volume`.
symbolsarray	One entry per symbol.
symbols[].symstring	The symbol.
symbols[].aliasesarray	Futures: the micro that answers as it.
symbols[].namestring	Its name.
symbols[].classstring	`index`, `future`, `etf` or `stock`.
symbols[].cadenceobject	How often its book and price are rebuilt.
symbols[].cadence.bookstring	`1s` or `5m`.
symbols[].cadence.pricestring	`1s`.
symbols[].has_oiboolean	Whether it has an open-interest book.
symbols[].gradestring \| null	The chain's trust grade.
symbols[].unitstring	Net gamma's unit.
symbols[].sourcestring	Where its book comes from.

Changes

2026-09-30 Added.

OpenAPI operation listSymbols in /docs/developers/openapi.json.

Request

curlPythonNode

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

import os, requests

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

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

Response

{
  "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"
    }
  ]
}

Measurements of dealer positioning, never a forecast or a trade call. This page is built from FirmTape's public contract, the same files the OpenAPI document is built from; the tests hold them against the route code. Markdown: /docs/developers/live/symbols.md.