Token Holder Analysis - Whale Tracking & Distribution

Analyze any token's holder distribution, whale concentration, and decentralization health across Ethereum, BNB Chain, Polygon, Arbitrum, Base, and Solana. Built for investors, researchers, and DeFi analysts who need to assess token ownership risk without setting up blockchain infrastructure. No API key required.

What does Token Holder Analysis do?

Token Holder Analysis fetches live on-chain holder data and delivers structured concentration metrics, whale alerts, and risk assessments for any ERC-20 or Solana token. Instead of manually querying block explorers and piecing together spreadsheets, you get a single JSON output with Gini coefficient approximations, supply concentration percentages, and labeled whale addresses — ready for downstream analysis or portfolio dashboards.

The Actor resolves tokens by contract address or CoinGecko ID, automatically routing to the correct chain API (Blockscout for EVM chains, Solana RPC for SPL tokens). Three distinct analysis modes let you choose between a full distribution report, a focused whale tracking view, or a simple ranked holder list.

Key features

• Holder distribution analysis with Gini coefficient, top-10/20/50 concentration percentages, and a plain-language distribution score
• Whale tracking for the top 20 addresses with USD values, known label detection (exchanges, burn addresses, contracts), and per-holder alerts above 5% supply threshold
• Top 50 holders ranked list with balance, percentage, and live USD value per address
• CoinGecko ID resolution — enter uniswap or chainlink instead of a contract address
• Cross-chain coverage: Ethereum, BNB Smart Chain, Polygon, Arbitrum, Base, Solana
• Risk level output (Very High / High / Medium / Low) with a plain-language risk reason string
• Automatic retry with exponential backoff on API failures

Use cases

• Crypto investors: Assess token ownership risk before entry — identify whether a handful of wallets control most of the supply
• DeFi researchers: Track whale accumulation patterns across chains and flag addresses approaching dangerous concentration levels
• Portfolio risk managers: Integrate structured holder data via the Apify API into automated risk dashboards
• Token launchers and advisors: Benchmark your project's decentralization health against comparable tokens
• Journalists and analysts: Quickly pull verifiable on-chain data for token distribution stories without building scraper infrastructure

How to use Token Holder Analysis

1. Configure input — Enter a contract address or CoinGecko ID, select the chain, and choose your analysis mode
2. Run the actor — Click "Start" in Apify Console or trigger via the REST API
3. Get structured results — Download the JSON output from the dataset or stream results via the API

Input parameters

Parameter	Type	Required	Default	Description
token	string	Yes	—	Contract address (0x... or base58) or CoinGecko ID (e.g., uniswap)
chain	enum	No	ethereum	ethereum, bsc, polygon, arbitrum, base, solana
mode	enum	No	holder_distribution	holder_distribution, whale_tracking, top_holders

Output example

{
    "mode": "holder_distribution",
    "token": "0xdAC17F958D2ee523a2206206994597C13D831ec7",
    "chain": "ethereum",
    "tokenName": "Tether USD",
    "tokenSymbol": "USDT",
    "totalSupply": 39823315808.35,
    "totalHolders": 6142853,
    "priceUsd": 1.0,
    "concentration": "Highly Concentrated",
    "top10Percentage": 85.42,
    "top20Percentage": 91.15,
    "giniCoefficient": 0.912,
    "riskLevel": "Very High",
    "riskReason": "Top 10 holders control 85.42% of supply",
    "whaleAlerts": [
        {
            "address": "0x5754284f345afc66a98fbb0a0afe71e0f007b949",
            "percentage": 15.23,
            "alert": "Holds 15.23% of total supply"
        }
    ],
    "topHolders": [
        {
            "rank": 1,
            "address": "0x5754284f345afc66a98fbb0a0afe71e0f007b949",
            "balance": 4200000000,
            "percentage": 10.55,
            "label": "Contract",
            "isContract": true
        }
    ],
    "timestamp": "2026-03-13T12:00:00.000Z"
}

Cost of usage

Token Holder Analysis uses a pay-per-event pricing model at $0.05 per scan.

Usage	Cost
1 scan	$0.05
100 scans	$5.00
1,000 scans	$50.00

New Apify users get a free trial with $5 in platform credits — enough for 100 scans at no cost.

Data sources

• Blockscout — Token holders, supply, and holder count for EVM chains (free, no key)
• Solana RPC — Largest token accounts and supply for SPL tokens (free, no key)
• DexScreener — Token price, 24h volume, and liquidity (free, no key)
• CoinGecko — Token ID to contract address resolution (free, no key)

Related actors

• Crypto Token Scanner — Scan tokens for momentum signals, liquidity, and market cap across DEXes
• Crypto Wallet Tracker — Monitor specific wallet addresses for balance changes and transaction history
• Airdrop Tracker — Discover tokenless DeFi protocols with high TVL and strong airdrop potential

FAQ

Is an API key required?

No. All four data sources (Blockscout, Solana RPC, DexScreener, CoinGecko) are free and publicly accessible. No registration or API key is needed.

Which chains are supported?

Ethereum, BNB Smart Chain, Polygon, Arbitrum, Base, and Solana. For EVM chains the Actor uses Blockscout; for Solana it uses the native RPC endpoint.

Can I use a token name instead of a contract address?

Yes. Enter a CoinGecko ID such as uniswap, chainlink, or aave and the Actor will resolve it to the correct contract address automatically.

What is the difference between the three analysis modes?

holder_distribution provides the full concentration report including Gini coefficient and risk assessment. whale_tracking focuses on the top 20 largest holders with USD values and known labels. top_holders returns a simple ranked list of the top 50 holders with balance and percentage data.

How current is the data?

Data is fetched live at the time the Actor runs. Holder counts and balances reflect the chain state at the moment of each API call.

Limitations

• Holder data accuracy depends on the Blockscout indexing status for each chain; recently deployed tokens may show incomplete holder counts
• CoinGecko free tier rate limits apply to ID resolution; high-volume runs against many tokens by CoinGecko ID may experience occasional resolution delays
• Known address labels (exchange wallets, burn addresses) are identified by a static list and may not cover all labeled addresses
• Solana token account data reflects the largest accounts returned by the RPC getTokenLargestAccounts call, capped at 20 accounts
• This Actor provides analytical data only and does not constitute financial or investment advice