v1

latestOpenAPI 3.1.02026-07-2410781551.8 KB
Holder

Token - Holder Distribution

Retrieve distribution statistics for token holders based on their share of the total supply. Set include_list=true to return the wallet list for the specified range.

get/holder/v1/distribution

Query parameters

token_addressstring required

Token contract address.

address_type'wallet' | 'token_account'

Return holder distribution by wallet or token account address.

mode'percent' | 'top'

Holder filter mode (percent = by supply % range, top = top holders by supply %).

top_ninteger

Number of top holders to return (used only when mode = top).

min_percentnumber

Minimum % of total supply a holder must have (used only when mode = percent).

max_percentnumber

Maximum % of total supply a holder can have (used only when mode = percent).

include_listboolean

Return holder list (true / false).

offsetinteger

Pagination start position. offset + limit <= 10000

limitinteger

Number of items per page.

Headers

x-chain'solana'

Solana network only.

Response

JSON object containing token holder distribution details

successboolean required

Whether the request succeeded.