API Endpoints

Token - Holder Distribution

get
https://public-api.birdeye.so/holder/v1/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.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Query Params
string
required

Token contract address.

string
enum
Defaults to wallet

Return holder distribution by wallet or token account address.

Allowed:
string
enum
Defaults to top

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

Allowed:
integer
1 to 10000
Defaults to 10

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

number
0 to 100

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

number
0 to 100

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

boolean
Defaults to true

Return holder list (true / false).

integer
0 to 10000
Defaults to 0

Pagination start position. offset + limit <= 10000

integer
1 to 50
Defaults to 50

Number of items per page.

Headers
string
enum
Defaults to solana

Solana network only.

Allowed:
Responses

Updated 3 months ago

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json

Updated 3 months ago