Token Distribution Analyzer

WHAT IT DOES

Token Distribution Analyzer provides a comprehensive analysis of how any ERC-20 token is distributed among its holders. Enter a token contract address, and the tool reconstructs the complete holder list by scanning all Transfer events, calculates the balance of each holder, and computes key distribution metrics including the percentage of supply held by the top 10% and top 1% of holders, the Gini coefficient (a measure of inequality from 0 to 1), and a distribution score (0-100) that indicates how decentralized the token is. The tool displays the token name, symbol, decimals, total supply, total number of unique holders, and a ranked list of the top 100 holders with their balances and percentage of supply.

HOW TO USE

Connect your wallet using the BGWallet bridge (MetaMask or any Web3 wallet). Ensure you are on the same network as the token — Ethereum, BNB Chain, Polygon, Arbitrum, Optimism, Base, or any EVM chain. Enter the token contract address in the input field. Click "Analyze distribution" to start the analysis. The tool scans all Transfer events from block 0 to the latest block, reconstructs holder balances, and computes distribution metrics. Results are displayed with token metadata, concentration metrics (top 10% and top 1% holder supply percentages), Gini coefficient with a color-coded badge (low/medium/high inequality), a distribution score, and a ranked table of holders sorted by balance descending. Each holder address links to the block explorer for further inspection.

TECHNICAL MECHANISM

The tool first reads the token's metadata — name, symbol, decimals, and totalSupply using the standard ERC-20 interface. It then constructs a filter for the Transfer event and fetches all logs from block 0 to the latest block using a chunked scanning strategy (PLAYBOOK-C §5.1). Because public RPCs cap the number of blocks that can be queried in a single eth_getLogs request, the tool walks forward in configurable chunks (default 100,000 blocks). If a chunk request fails due to RPC limits, the tool halves the chunk size and retries, continuing until the entire range is scanned. For each Transfer log, it parses the from address, to address, and value, and updates an in-memory balance map (subtracting from the sender, adding to the receiver, and skipping the zero address for mints). After processing all logs, the map contains the current balance for each address that has ever held the token. The tool then verifies the top 50 holders with a live balanceOf call to ensure accuracy. From the holder list, it calculates the top 10% and top 1% supply percentages, the Gini coefficient (using the Lorenz curve method), and a normalized distribution score.

WHAT IT CANNOT SEE

The tool cannot analyze tokens with privacy features (e.g., Tornado Cash, zk-proofs, or confidential transfers) that hide sender, receiver, or amount. It cannot detect holders who use proxy contracts, delegate voting power, or hold tokens through smart contract wallets that obscure the true beneficial owner. It cannot provide real-time distribution beyond the latest block — the analysis is based on historical logs and live balance checks at the time of the request. It cannot accurately analyze tokens with dynamic supply changes such as rebasing tokens or reflection mechanisms where balances change automatically with every transaction. It cannot detect multiple addresses controlled by the same entity or person. It cannot analyze ERC-721 or ERC-1155 tokens — only ERC-20. The tool is read-only and does not sign any transactions.

PLEASE NOTE

This tool works exclusively on EVM-compatible chains (Ethereum, BNB Chain, Polygon, Arbitrum, Optimism, Base, Avalanche C-Chain, Fantom, and others). Solana, Tron, Starknet, SUI, TON, Aptos, Bitcoin, Cosmos, and XRP are not supported. The tool only supports ERC-20 tokens — ERC-721 and ERC-1155 are not supported. Performance depends on the token's transfer history size; tokens with millions of transfers may take longer to scan. The Gini coefficient is a simplified estimate and may not perfectly reflect the true distribution for tokens with complex supply mechanics. The tool does not store any data — all reads happen live from the blockchain through your wallet provider. The tool is provided as-is with no warranty or liability. Always verify contract addresses from trusted sources.