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

# Project Tokens

> One row per token contract per chain with daily token metrics: chain and contract address, symbol, category, sector, subsector and issuer. The id is the series key of the project-tokens timeseries model and matches the id in tokens.

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

## Endpoints

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

  <Card title="Get Project Token" icon="arrow-right" href="/api-reference/data-api/projects/tabular-project-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 series key of the project-tokens timeseries model, the token's chain and contract address joined with an underscore; the same id as in tokens. (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. |
| `networkID` | string | `Eq`, `IsOneOf` | | The chain's networkID in the blockchains model; null when unmapped. |

## Example

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

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


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