---
title: "Symbol catalog"
method: GET
path: "/v1/symbols"
tags: ["Meta"]
---

# Symbol catalog

`GET /v1/symbols`

## Request

- Base URL: `https://api.skylit.ai`
- URL: `https://api.skylit.ai/v1/symbols`
- Auth: HTTP bearer

Every symbol the API serves: whether it is an index, previous tickers
after a rename (still accepted as input), the metrics available, and
the UTC dates its history covers (`null` when coverage could not be
read). History dates are refreshed every few hours. Free.

## Response `200`

Symbol catalog.

- object
  - `data` object, required
    - `symbols` object[], required
      - `history` object, nullable, required
        - `from` string, date, required
        - `to` string, date, required
      - `isIndex` boolean, required
      - `metrics` string[], required
      - `previousNames` string[]
      - `symbol` string, required

## Other responses

- `401`: Missing API key (`unauthorized`), sent by the gateway.
- `429`: Per-minute rate limit exceeded.
- `503`: Heatmap data is temporarily unavailable.

---

[API](https://skmtc.dev/skylit/apis/skylit-public-api.md) · [All operations](https://skmtc.dev/skylit/apis/skylit-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/skylit/apis/skylit-public-api/revisions/890b0ea4e6f5?raw)