> ## Documentation Index
> Fetch the complete documentation index at: https://docs.blockworks.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Tokens

> The token classification table and the per-deployment token series.

Token Labels names every token contract on every chain with its category, sector, subsector and issuer; Token Metrics carries price, total, issued, circulating and adjusted supply, mints and burns, and the balance held in each venue type -- bridges, CEXes, spot and perp DEXes, CDPs, staking, treasuries and the rest. Both are keyed by chain and contract address, and share an id.

## Endpoints

| Model | Access | Table | Timeseries |
| - | - | - | - |
| [Token Metrics](https://docs.blockworks.com/api-reference/data-api/tokens/token-metrics) | Assets-dataset | [List rows](https://docs.blockworks.com/api-reference/data-api/tokens/tabular-token-metrics.md) | [Batch](https://docs.blockworks.com/api-reference/data-api/tokens/timeseries-token-metrics.md), [One series](https://docs.blockworks.com/api-reference/data-api/tokens/timeseries-token-metrics-by-id.md) |
| [Token Labels](https://docs.blockworks.com/api-reference/data-api/tokens/token-labels) | Assets-dataset | [List rows](https://docs.blockworks.com/api-reference/data-api/tokens/tabular-token-labels.md), [One row](https://docs.blockworks.com/api-reference/data-api/tokens/tabular-token-labels-by-id.md) | |

## Example

```bash curl theme={null}
curl "https://api.blockworks.com/query/tabular/token-metrics?pageSize=3&selections=id,name,slug,chain" \
  -H "X-Blockworks-API-Key: $BLOCKWORKS_API_KEY"
```

See [List Token Metrics](https://docs.blockworks.com/api-reference/data-api/tokens/tabular-token-metrics.md) for the response and the errors.

## Guides

> [card] [Finding an id](https://docs.blockworks.com/api-reference/data-api/discovery/finding-an-id.md)
>
> Every series key, the table it comes from and the identifiers that resolve to it.

> [card] [Granularity](https://docs.blockworks.com/getting-started/concepts/granularity.md)
>
> Choosing an interval and bounding a time window.

> [card] [Filtering and pagination](https://docs.blockworks.com/getting-started/filtering-pagination.md)
>
> Filter suffixes, sorting, column selection and paging.

> [card] [Tabular vs timeseries](https://docs.blockworks.com/getting-started/concepts/tabular-vs-timeseries.md)
>
> The two model kinds, their URL shapes, and when to reach for each.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.