Skip to main content
GET
Token Holders
Coverage is limited to the top-1000 coins by market cap and EVM networks only. Coins outside coverage return an empty array, not an error.
Data is a daily snapshot; meta.snapshotDate returns its collection time. Holder metrics are per-network and are never summed across networks.
Resolve available networks for a coin via /currencies//contracts and network ids via /blockchains/map.

Authorizations

X-Api-Key
string
header
required

Path Parameters

id
integer
required

Coin ID. See: GET /v3/currencies/map.

Example:

1

Query Parameters

page
number
default:1

Page number (1-based). Returns up to 100 items per page.

Required range: 1 <= x <= 1000
blockchainId
number

Network to return holders for. Defaults to the coin's primary network — the one the website opens first. Unknown id → 400. See: GET /v3/blockchains/map.

Example:

1

excludeContracts
boolean
default:false

Exclude contract addresses from the list. rank and percentOfSupply keep their original values — they are not recalculated over the filtered set.

sortOrder
enum<string>
default:asc

Sort direction by rank. desc returns the same top holders starting from the lowest rank.

Available options:
asc,
desc

Response

data
object[]
required
meta
object
required
status
object
required