Token Holder Analyzer

WHAT IT DOES

Token Holder Analyzer provides a comprehensive view of the holder distribution for any ERC-20 token on EVM chains. Enter a token contract address, and the tool scans the blockchain to identify all unique holders, their current balances, and their percentage of the total supply. The results are displayed in a ranked table showing each holder's address, balance (formatted with the token's decimals), and share of the total supply with a visual bar chart. The tool also displays the token name, symbol, decimals, total supply, and total number of unique holders, giving you a complete picture of the token's distribution and concentration.

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 you want to analyze — Ethereum, BNB Chain, Polygon, Arbitrum, Optimism, Base, or any EVM chain. Enter the token contract address in the input field. Click "Analyze holders" to start the analysis. The tool will fetch all Transfer events from the entire blockchain history, reconstruct holder balances, and then verify each balance with a live balanceOf call. Results are displayed with the top holders sorted by balance descending. The tool automatically handles large token histories by chunking log requests to respect RPC limits.

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 (the only event that changes balances) and fetches all logs from block 0 to the latest block. Because public RPCs cap the number of blocks that can be queried in a single eth_getLogs request, the tool uses a chunked scanning strategy (PLAYBOOK-C §5.1): it 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 estimated balance for each address that has ever held the token. To ensure accuracy, the tool then makes a live balanceOf call for the top 200 holders to verify their current balances. Holders are sorted by balance descending, and each is displayed with its percentage of the total supply.

WHAT IT CANNOT SEE

The tool cannot track holders across multiple token types simultaneously — it analyzes one token at a time. 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 analyze tokens with privacy features (e.g., Tornado Cash, zk-proofs, or confidential transfers) that hide sender, receiver, or amount. It cannot provide real-time holder data beyond the latest block — the analysis is based on historical logs and live balance checks at the time of the request. It cannot detect token holdings across multiple addresses owned by the same person. It cannot show transfer history or transaction details for each holder. 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 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.