Holder distribution
get_holdersRead-onlyIdempotent
Holder distribution for one token, with liquidity pools, burn addresses, lockers, exchange wallets and contracts classified out, so the top-holder list reflects actual holders. Returns the classified top holders with each wallet's supply share in a single response — no pagination. Use it to answer how concentrated the supply is and whether a few wallets could collapse the chart. Not for what large holders are doing right now (get_whales), whether holders are secretly one actor (get_wallet_links or get_lookalike_clusters), or pool depth and locks (get_liquidity). Arguments: address and chain; one API unit on any chain.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| chain | No | Chain the token is deployed on: solana (default), ethereum, base, bsc, robinhood, arc, hyperevm, monad. Required for any 0x address, because the same contract address can exist on several EVM chains. Omit it for Solana. An unsupported value is rejected before any request is spent; EVM chains need a key on an All-Chains plan. | solana |
| address | Yes | The token's own contract address, exactly as an explorer shows it. Solana: the base58 mint, 32-44 characters (e.g. 6p6xgHyF7AeE6TZkSmFsko444wqoP15icUSqi2jfGiPN). EVM: 0x followed by 40 hex characters, case-insensitive (e.g. 0x6982508145454ce325ddbe47a25d4ec3d2311933). Never a pool, pair, wallet or deployer address — those come back as not found. Set `chain` to match the address: a 0x address alone cannot say which EVM chain it lives on, and a Solana mint sent with an EVM chain is rejected. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| token | No | The address that was scanned (on get_token_scan, the full token metadata object instead). | |
| bundles | No | Always { detected: false, bundlePct: "0.00", groups: [] }, kept for older readers: similar balances are not a cluster. Launch bundles are get_launch_bundles. | |
| vesting | No | Solana: vesting a launch program holds (Jupiter Lock, LaunchLab, Meteora DBC): lockedPct, claimablePct, reclaimablePct, unlocking30dPct, nextUnlock, fullyUnlockedAt, recipients, schedules, summary. Null when none. EVM (a Virtuals token on Base or Robinhood): its TokenTable vesting read on chain: available, protocol, unlockers, lockedPct, unlockedPct, claimedPct, claimablePct, unlock30dPct, unlock90dPct, nextUnlock, lockedUntil, claimers, revocable, line; { available: false, reason } while the read is pending, incomplete or failed, or the token has no unlocker; absent on other tokens. | |
| leftover | No | Solana: a Meteora DBC fixed supply leftover: pct, receiver (the config's leftover receiver: the burn address 1nc1nerator11111111111111111111111111111111 when it can only be paid there), role, platform, withdrawable (now, at graduation, or null when only the burn address can receive it or it was withdrawn), withdrawn, recipients, summary, and how it scores: counted (in concentration as the receiver's: the creator or one wallet can withdraw it now), overhang (a platform's wallet can withdraw it now, or withdrew it and still holds it: its own line, not counted) or burned. Null when none. | |
| poweredBy | No | Always "DeFade.org". | |
| timestamp | No | ISO time the response was assembled. | |
| topHolders | No | Top 20 accounts: rank, address, walletAddress, amount, percentage, solBalance, isProtocol, protocolLabel. A launch vault or escrow is split into parts (partOf); a part one wallet can take now has heldBy, and vesting, leftover, launchLeftover and supplyDetail say what it is. | |
| mayhemAgent | No | Solana: what pump.fun's Mayhem agent wallet holds of the token: address, pct (of supply), amount. On a coin launched in Mayhem mode (get_token_scan token.timeline.mayhem) the create minted it 1B beside the curve's 1B; it can sell into the curve (the pool once graduated) until timeline.mayhem.endsAt, 24 hours from launch, and what it holds then is burned. Out of concentration like a pool; the rug score charges +4 while it can trade and holds 1% or more. On any other coin it is only what the wallet was sent, such as an airdrop, and nothing scores it. Null when it holds none. | |
| lockedSupply | No | pct plus a lockers array naming each escrow; a vesting lock counts what is not claimable yet and adds unlocksTo, nextUnlock, fullyUnlockedAt. | |
| totalHolders | No | How many of the largest accounts were read, at most 20. Not the holder count: that is totalHolderCount. | |
| concentration | No | top5, top10, top20 as percent of supply, counting real wallets only, plus the parts one wallet can take now (heldBy). | |
| deferredUnlock | No | Supply that unlocks back to the deployer later: pct, unlockDate, cancelablePct. Null when none. | |
| protocolHoldings | No | What was excluded: count and totalPct. | |
| totalHolderCount | No | Solana: every holder of the token, counted. 10,000 with holderCountCapped true when there are more. Null when the count was not in yet; ask again a few seconds later. | |
| holderCountCapped | No | True when the count stopped at 10,000: the token has at least that many holders. |