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
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
Loading…
Two distribution modes. Pick one mode and only use filters for that mode.
mode=top— returns the top holders by supply share. Usetop_nto control how many top holders to inspect.mode=percent— returns holders inside a supply-share range. Usemin_percentandmax_percentto define the range.address_type=walletreturns holder wallets.address_type=token_accountreturns token-account level ownership.include_list=truereturns the holder list. Setinclude_list=falsewhen you only need the summary.
Reading the numbers. summary.wallet_count is the number of holders in the selected range. summary.total_holding is the total token amount held by that segment, and summary.percent_of_supply is that segment's share of total supply.
- Lite
- Starter
- Premium
- Business
- Enterprise
Solana
Use Cases 💡
- Map the ownership shape of a token before trusting the market: see whether supply is spread across many wallets or concentrated in a few dominant hands.
- Build concentration-risk dashboards that flag tokens where the top holders control a dangerous share of supply.
- Segment holders by supply percentage to identify whales, mid-size holders, and long-tail retail distribution.
- Compare wallet-level and token-account-level views to understand whether apparent distribution is real or fragmented across accounts.
- Feed token safety scores, listing reviews, and pre-trade checks with holder concentration signals.
How to Use 🛠️
- Provide a Solana
token_address. - Use
mode=top&top_n=10for the largest holders, ormode=percent&min_percent=1&max_percent=5for a supply-share bucket. - Set
address_type=walletfor owner-level analysis, oraddress_type=token_accountfor token-account level inspection. - Set
include_list=falsefor a lightweight summary, or keep ittruewhen you need the actual holder rows. - Use
offsetandlimitto page through the holder list wheninclude_list=true.
Best Practices ✅
- Start with
mode=topto identify concentration risk, then usemode=percentto inspect the middle and long-tail ownership bands. - Do not mix top-holder filters with percent-range filters; each mode has its own filter set.
- Use wallet-level distribution for product and risk summaries, and token-account level distribution when investigating account fragmentation.
- Pair distribution with holder-profile, first-buyers, and token overview data to understand who owns supply and whether ownership looks healthy.
Limitations ⚠️
- Solana only.
mode=topcannot be combined withmin_percentormax_percent.mode=percentcannot be combined withtop_n.top_nsupports up to 10,000 holders.- Pagination supports offset up to 10,000 and limit up to 50.