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…

  • Lite
    • Starter
    • Premium
    • Business
    • Enterprise
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 about 1 month 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 about 1 month ago