| Access | Assets-dataset |
| Tabular model | tokens: primary key id |
Endpoints
List Tokens
One page of rows with per-column filters, sorting and pagination.
Get Token
One row by
id.Columns
Use theField 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
curl
curl "https://api.blockworks.com/query/tabular/tokens?pageSize=3&selections=id,name,slug,chain" \
-H "X-Blockworks-API-Key: $BLOCKWORKS_API_KEY"