Blockchain Tokenomics Analyzer

WHAT IT DOES

Blockchain Tokenomics Analyzer gives you a comprehensive, data-driven view of any ERC-20 token's economic structure. Enter a token contract address and instantly see: token name, symbol, decimals, total supply, recent transfer volume, and the number of unique holders. The tool builds a holder distribution map from recent Transfer events, showing you the top holders with visual percentage bars that make concentration immediately clear. You can identify which addresses hold the largest shares, how supply is distributed, and how active the token has been in recent blocks. This is essential for due diligence, investment research, and understanding the health of any token ecosystem.

HOW TO USE

Connect your EVM wallet (optional—the tool works read-only). Select the network from the dropdown (Ethereum Mainnet, Goerli, Sepolia, Polygon, Arbitrum, or Optimism). Enter the ERC-20 token contract address (0x…42) and click "analyze". The tool fetches the token's metadata, scans recent Transfer events (last 20,000 blocks), and builds a holder balance map. The results display the token name, symbol, decimals, total supply, transfer count, unique holder count, and a ranked list of top holders with percentage bars. Use the "clear" button to reset and start a new analysis. No signing or approvals required.

TECHNICAL MECHANISM

The tool uses ethers.js v5.7.2 via the BGWallet provider. It first queries the contract's ERC-20 metadata using standard view functions: name(), symbol(), decimals(), and totalSupply(). It then scans Transfer event logs using a chunked fetcher that automatically halves block ranges on RPC limit errors—ensuring the scan completes even on public nodes with strict eth_getLogs caps. Each Transfer event is decoded to extract the sender, receiver, and value. The tool builds a balance map by subtracting from the sender and adding to the receiver, tracking only holders with positive balances. The zero address (0x000...000) is filtered out to remove burned tokens. The final holder list is sorted by balance descending, and the top holders are displayed with percentage bars showing their share of the total supply.

WHAT IT CANNOT SEE

This tool cannot track off-chain token movements or locked/unlocked schedules—it only sees on-chain transfers. It cannot automatically identify team wallets, vesting contracts, or treasury addresses—you see addresses, but not who controls them. It cannot verify token authenticity or audit contract security—it reads standard ERC-20 interfaces, but cannot detect malicious code or backdoors. It cannot predict future price movements or market cap. It does not include price oracle data in this version. Historical data is limited by the RPC provider's archive node availability; older blocks may be unavailable. The holder map is built from recent transfers only and may not reflect the full holder base if many holders are inactive.

PLEASE NOTE

Works exclusively on EVM-compatible chains: Ethereum Mainnet, Goerli, Sepolia, Polygon, Arbitrum, and Optimism. Solana, Tron, Starknet, SUI, TON, Aptos, Bitcoin, Cosmos, and XRP are not supported. This is a read-only, free analytics tool—use it for research and due diligence, but always combine with other sources for investment decisions. The tool relies on the standard ERC-20 Transfer event; non-standard or proxy contracts may not be fully supported.