Whale Alert Tracker

WHAT IT DOES

Whale Alert Tracker monitors large token transfers on EVM-compatible chains, helping you spot significant movements of funds that could indicate market shifts, large accumulations, or major sell-offs. Enter a token contract address, set a minimum transfer threshold, and choose a lookback range — the tool scans recent blocks for transfers exceeding your threshold. It displays the token name, symbol, the threshold value, the total number of whale transfers found, the block range scanned, and a detailed list of each whale transfer showing the sender, recipient, value, block number, and transaction hash. Each sender and recipient address links to the block explorer for further investigation.

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. Set the minimum transfer threshold in token units — this defines what constitutes a "whale" transfer (e.g., 100,000 USDC or 1,000 ETH). Select the lookback range from the dropdown — options range from the last 1,000 blocks to the last 100,000 blocks. Click "Track whale movements" to start the scan. The tool fetches Transfer events from the specified block range, filters for transfers exceeding the threshold, and displays the results sorted by value descending. Each whale transfer includes the sender, recipient, value, block number, and transaction hash with block explorer links.

TECHNICAL MECHANISM

The tool first reads the token's metadata — name, symbol, and decimals using the standard ERC-20 interface. It then constructs a filter for the Transfer event and fetches logs from the specified block range (from the lookback offset 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 log, it parses the value using the token's decimals and compares it against the user-defined threshold. If the value meets or exceeds the threshold, the tool extracts the from, to, value, block number, and transaction hash. The results are sorted by value descending and displayed with whale classification badges (Mega, Large, Medium) based on how many times the transfer exceeds the threshold. All data is fetched directly from the blockchain — no external APIs or third-party services are used.

WHAT IT CANNOT SEE

The tool cannot detect whale movements on private mempools or through privacy tools (e.g., Tornado Cash, zk-proofs, or confidential transfers) that hide sender, receiver, or amount. It cannot identify the entity behind a whale address — the tool only shows addresses, not the individuals or organizations controlling them. It cannot track off-chain transfers (e.g., centralized exchange internal transfers) or cross-chain transfers that move assets between different blockchains. It cannot provide push notifications without continuous polling — you must manually refresh or re-run the scan to see new transfers. It cannot distinguish between genuine whales and exchange wallets, smart contracts, or protocol addresses that perform large automated transfers. It cannot detect transfers of tokens with dynamic supply mechanisms (rebasing, reflections). 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 in this version. The lookback range determines the number of blocks scanned; larger ranges take longer and may hit RPC limits. The threshold is in token units, not native currency — ensure you use the correct decimal places for the token. 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 transactions and addresses from trusted sources.