
WhaleGuard is a lightweight, real-time risk oracle for ERC-20 / BEP-20 tokens. It answers one question: "Will this token dump on me?" Core capability: - Fetches top 10 token holders via Etherscan API V2 - Calculates Concentration Index (CI) = % of supply held by top 5 addresses - Flags manipulation risk: Red (>60%), Orange (30-60%), Green (<30%) - Works on Ethereum, BNB Chain, Polygon, Base, Arbitrum How to use: Provide a token contract address and optionally a chain (eth, bsc, polygon, base, arbitrum). WhaleGuard returns the full holder breakdown, the CI score and a risk verdict. Example: analyze_token("0x1f9840a85d5aF5bf1D1762F925BDADdC4201F984", "eth")