Skip to main content
GET
List Tokens

Authorizations

X-Blockworks-API-Key
string
header
required

API key sent in the X-Blockworks-API-Key header; x-messari-api-key is accepted for existing integrations. The catalog endpoints and models open to everyone need no key.

Query Parameters

idEq
string

Token ID equals.

idIsOneOf
string[]

Token ID is one of (comma-separated).

nameEq
string

Name equals.

nameIsOneOf
string[]

Name is one of (comma-separated).

nameContains
string

Name contains (case-insensitive substring).

slugEq
string

Slug equals.

slugIsOneOf
string[]

Slug is one of (comma-separated).

chainEq
string

Chain equals.

chainIsOneOf
string[]

Chain is one of (comma-separated).

tokenAddressEq
string

Token Address equals.

tokenAddressIsOneOf
string[]

Token Address is one of (comma-separated).

symbolEq
string

Symbol equals.

symbolIsOneOf
string[]

Symbol is one of (comma-separated).

symbolContains
string

Symbol contains (case-insensitive substring).

categoryEq
string

Category equals.

categoryIsOneOf
string[]

Category is one of (comma-separated).

sectorEq
string

Sector equals.

sectorIsOneOf
string[]

Sector is one of (comma-separated).

subsectorEq
string

Subsector equals.

subsectorIsOneOf
string[]

Subsector is one of (comma-separated).

issuerIDEq
string

Issuer ID equals.

issuerIDIsOneOf
string[]

Issuer ID is one of (comma-separated).

underlyingTokenSlugEq
string

Underlying Token Slug equals.

underlyingTokenSlugIsOneOf
string[]

Underlying Token Slug is one of (comma-separated).

underlyingAssetIDEq
string

Underlying Asset ID equals.

underlyingAssetIDIsOneOf
string[]

Underlying Asset ID is one of (comma-separated).

bridgeIDEq
string

Bridge ID equals.

bridgeIDIsOneOf
string[]

Bridge ID is one of (comma-separated).

tokenVersionEq
string

Token Version equals.

tokenVersionIsOneOf
string[]

Token Version is one of (comma-separated).

launchpadIDEq
string

Launchpad ID equals.

launchpadIDIsOneOf
string[]

Launchpad ID is one of (comma-separated).

networkIDEq
string

Network ID equals.

networkIDIsOneOf
string[]

Network ID is one of (comma-separated).

networkSlugEq
string

Network Slug equals.

networkSlugIsOneOf
string[]

Network Slug is one of (comma-separated).

sortBy
enum<string>
default:name

Field to sort by; defaults to the model's default sort column.

Available options:
name,
slug,
chain,
symbol
sortDirection
enum<string>
default:asc

Sort direction.

Available options:
asc,
desc
page
integer

1-based page number.

pageSize
integer

Rows per page (max 1000, default 100).

selections
enum<string>[]

Comma-separated fields to return; defaults to all fields.

Available options:
id,
name,
slug,
chain,
tokenAddress,
symbol,
category,
sector,
subsector,
issuerID,
underlyingTokenSlug,
underlyingAssetID,
bridgeID,
tokenVersion,
launchpadID,
networkID,
networkSlug
acceptFormat
enum<string>
default:json

Response format, overriding the Accept header: json (default), csv, or jsonl (NDJSON). csv and jsonl return the rows as a downloadable file.

Available options:
json,
csv,
jsonl

Response

One page of matching rows, with the totals for the whole filtered set.

data
object[]
required
metadata
object
required

Pagination totals for the full filtered result set, independent of the current page.

error
string | null