Token Sink-and-Source Balance Report Generator

WHAT IT DOES

Token Sink-and-Source Balance Report Generator provides a comprehensive analytics report for any ERC-20 token, analyzing supply dynamics, holder distribution, and token flow patterns. The tool reads the token contract state—including total supply, circulating supply, holder balances, and top holder distribution—then analyzes wallet transaction histories to identify sinks (addresses where tokens accumulate) and sources (addresses from which tokens flow out). It also reports burn and mint events, vesting and lockup contract status, and token velocity metrics. The tool supports tracking specific addresses to understand their balance and net flow over time.

This tool is essential for token teams, investors, DAOs, and analysts who need to understand token distribution, identify concentration risks, track vesting schedules, and monitor overall token health. It provides a single dashboard view of the token's on-chain ecosystem.

HOW TO USE

1. Connect your EVM wallet to the network where the token is deployed.

2. Enter the token contract address.

3. Optionally add specific addresses to track (one per line) for custom balance and flow analysis.

4. Click "Generate Report" to fetch on-chain data and compile the report.

5. The tool displays key metrics: total supply, circulating supply, holder count, burn/mint rates, and token velocity.

6. Review the top holders section showing percentage distribution.

7. View tracked address balances and net flow (incoming minus outgoing).

8. Review vesting contract information and unlock dates if applicable.

9. The report includes a summary of limitations to help interpret the data.

TECHNICAL MECHANISM

The tool reads the token contract using view functions: totalSupply() and balanceOf(address) for supply and balances. It fetches holder data by scanning Transfer events using eth_getLogs, walking backwards in chunks and halving the chunk size on failure (per PLAYBOOK-C §5.1). It identifies sinks and sources by analyzing incoming and outgoing transfers for each tracked address. Burn events are detected by transfers to address(0), and mint events by transfers from address(0). Vesting contracts are identified by checking if an address is a contract with locked balance and unlock functions. Token velocity is calculated as the total transfer volume divided by the average daily balance. The tool uses a read-only approach with no transaction signing.

WHAT IT CANNOT SEE

This tool cannot distinguish between active and inactive holders—it treats all addresses with a balance equally, regardless of whether they are actively trading. It cannot identify the purpose of transfers (trading, staking, OTC, governance, etc.)—the tool only sees the flow amount, not the intent. It cannot verify off-chain token holdings or exchange balances; tokens held on centralized exchanges are not reflected in the report unless the exchange address is tracked. It cannot track tokens that have been bridged to other chains; the report is limited to the current chain. It cannot determine the real-world identity of wallet owners; addresses are pseudonymous. It cannot predict future token flow patterns or price movements. It cannot analyze tokens with complex privacy features or zero-knowledge proofs that obfuscate transfers.

PLEASE NOTE

EVM chains only. This tool requires that the token contract implements the standard ERC-20 interface. The report is a snapshot in time and may not reflect real-time changes. Token velocity is an approximation based on the last 7 days of transfers. The tool does not provide financial advice; the report is for informational purposes only.