> ## 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

> One row per token contract per chain from the Blockworks Research token classification: chain and contract address, symbol, category, sector and subsector, the issuer, and for bridged or wrapped tokens the token and asset they represent. Deployments of one token on several chains share a slug.

| | |
| - | - |
| Access | Assets-dataset |
| Tabular model | `tokens`: primary key `id` |

## Endpoints

<CardGroup cols={2}>
  <Card title="List Tokens" icon="arrow-right" href="/api-reference/data-api/assets/tabular-tokens">
    One page of rows with per-column filters, sorting and pagination.
  </Card>

  <Card title="Get Token" icon="arrow-right" href="/api-reference/data-api/assets/tabular-tokens-by-id">
    One row by `id`.
  </Card>
</CardGroup>

## Columns

Use the `Field` value in `selections`, `sortBy`, and as the base of a filter parameter (`Field` plus one of its `Filters` suffixes).

| Field | Type | Filters | Sort | Description |
| - | - | - | - | - |
| `id` | string | `Eq`, `IsOneOf` | | The token's chain and contract address, joined with an underscore (ethereum\_0xa0b8...eb48). (primary key) |
| `name` | string | `Eq`, `IsOneOf`, `Contains` | default | The token's display name, its symbol, falling back to its slug. |
| `slug` | string | `Eq`, `IsOneOf` | yes | The token's identifier, shared by every chain's deployment of the same token (circle-usdc); null when unclassified, and not unique across chains. |
| `chain` | string | `Eq`, `IsOneOf` | yes | The short name of the chain the token is deployed on (ethereum, base, solana). |
| `tokenAddress` | string | `Eq`, `IsOneOf` | | The token contract address (the mint address on Solana). |
| `symbol` | string | `Eq`, `IsOneOf`, `Contains` | yes | The token's ticker symbol. |
| `category` | string | `Eq`, `IsOneOf` | | The token's category (for example stablecoins or blockchains). |
| `sector` | string | `Eq`, `IsOneOf` | | The token's sector within its category (for example usd or l1). |
| `subsector` | string | `Eq`, `IsOneOf` | | The token's subsector within its sector (for example fiat or bitcoin). |
| `issuerID` | string | `Eq`, `IsOneOf` | | The identifier of the token's issuer (for example circle or tether); null when unclassified. |
| `underlyingTokenSlug` | string | `Eq`, `IsOneOf` | | The slug of the token a bridged or wrapped token represents; null otherwise. |
| `underlyingAssetID` | string | `Eq`, `IsOneOf` | | The asset the token tracks (for example usd or bitcoin); null when unclassified. |
| `bridgeID` | string | `Eq`, `IsOneOf` | | The bridge a bridged token was issued through (for example stargate or layerzero); null otherwise. |
| `tokenVersion` | string | `Eq`, `IsOneOf` | | The token standard or version (for example erc20). |
| `launchpadID` | string | `Eq`, `IsOneOf` | | The launchpad the token was launched on; null otherwise. |
| `networkID` | string | `Eq`, `IsOneOf` | | The chain's networkID in the blockchains model; null when unmapped. |
| `networkSlug` | string | `Eq`, `IsOneOf` | | The chain's slug in the blockchains model; null when unmapped. |

## Example

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

See [List Tokens](/api-reference/data-api/assets/tabular-tokens) for the response and the errors.


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