Skip to main content
GET
A token's current holders, largest balance first, optionally narrowed to wallet classifications.

Authorizations

Authorization
string
header
required

Send the API key as Authorization: Bearer <key>.

Path Parameters

chain
enum<string>
required

Chain the resource lives on. Chain slug. One spelling per chain, in paths and bodies alike. Only a chain with spot data is published.

Available options:
solana,
base,
bsc,
robinhood,
arc
address
string
required

Token mint or contract address.

Query Parameters

limit
integer<int32>

Rows to return, clamped to 1-150; 30 when absent.

Required range: 1 <= x <= 150
trader
string

Restrict to one holder wallet.

flags
string

Wallet classifications to keep, comma-separated. Absent or empty keeps every holder.

period
enum<string>

Span the trading figures cover: cycle, the open round trip, or lifetime, every round trip. lifetime when absent. The span a holder row's trading figures cover: lifetime, every round trip, or cycle, the open one. lifetime when absent.

Available options:
cycle,
lifetime

Response

Current holders, largest balance first; an unknown token answers an empty list.

GET /v1/tokens/{chain}/{address}/holders response: current holders, largest balance first.

holderCount
integer<int64>
required

The token's own holder total, whatever the limit and any flags filter. It counts trading wallets only, so it can run below a full listing that includes pool vaults.

Required range: x >= 0
holders
object[]
required

Holders the read returned, largest balance first.

top10
object
required

Balance-weighted entry and exit prices across the first 10 holders; the filtered cohort under flags.