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

Authorizations

Authorization
string
header
required

Send an API key, or a session token a key minted, as Authorization: Bearer <credential>. A browser opening /v1/stream offers its session token in Sec-WebSocket-Protocol instead.

Query Parameters

tokens
string
required

Token addresses, CSV; one to 10. Each reads on every chain in scope of its address family.

chains
string

Chains to scope to, CSV of the chain slugs. Absent means every spot chain.

limit
integer<int32>

Holders per token, clamped to 1-150; 30 when absent.

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

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

period
enum<string>

Span the trading figures cover; 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
cursor
string

A series' nextCursor, to read its next page. The request names that series' token in tokens, and its chain in chains when the token's address family spans several.

Response

One series per chain each named token trades on, in the order the request named them, each with one page of its current holders, largest balance first.

address
string
required

Token address.

chain
enum<string>
required

Chain the token trades on.

Available options:
solana,
bsc,
robinhood,
elysium,
ethereum
hasMore
boolean
required

Whether this series has another page.

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 on this page, largest balance first.

nextCursor
string | null

The cursor of this series' next page when hasMore is true; null on its last page.

top10
null | object

Balance-weighted entry and exit prices across the first 10 holders; the filtered cohort under flags. null on every page after the first.