Governance Token Unlock Alert

WHAT IT DOES

Governance Token Unlock Alert watches the current Etherscan address page for the displayed wallet address, reads the wallet's current token balance and transaction history via the Etherscan API, monitors for large token inflows that could indicate governance token unlocks or vesting releases, analyzes transaction patterns including source addresses and token types to detect potential governance token unlock events, and displays alerts with token details, unlock amount, and significance assessment when significant governance token unlocks are detected. The tool extracts the wallet address from the page URL, fetches recent token transfer history from the Etherscan API using the token transfer endpoint, stores historical transfer snapshots locally to detect new token inflows, identifies governance tokens by matching contract addresses against a watchlist of common DAO tokens, calculates transfer value in USD using approximate token prices, analyzes source addresses to detect common unlock sources, and classifies events by token type and unlock significance. It then displays alerts with the token symbol, amount, estimated value, source address, and significance assessment.

WHERE IT RUNS

The tool runs as a panel inside your browser on Etherscan address pages at https://etherscan.io/address/*. It works on any wallet address page on Etherscan where token transfer history is available through the Etherscan API. The tool connects to the Etherscan public API via GM_xmlhttpRequest to fetch token transfer data. No data is sent to any external server beyond the API request; all data is read-only and processed locally. A real EVM wallet is optional — the tool will work without one, but may provide additional on-chain verification if available.

HOW TO USE

Install the BotGentz extension, navigate to any Etherscan address page, and open the Governance Token Unlock Alert panel. Set your minimum unlock threshold in USD (default $1,000,000) — the tool will alert you when any governance token inflow exceeds this value. Select your monitoring interval from the dropdown — 30, 60, 120, or 300 seconds. Choose your alert preference — Panel only, Browser notification, or Both. Click "Monitor Unlocks" — the tool begins fetching token transfer data from the Etherscan API at your chosen interval, stores historical transfer hashes locally, and compares each new fetch against the stored history. When a new token transfer to the wallet is detected, the tool checks if the token is in the governance token watchlist, calculates its USD value, and triggers an alert if it exceeds the configured threshold. The alert log maintains a history of recent alerts for review. Click "Refresh" to manually check for new unlocks, or "Clear History" to reset the alert log.

MECHANISM — GOVERNANCE TOKEN DETECTION AND UNLOCK SIGNIFICANCE ANALYSIS

This tool uses a governance token detection engine that combines transfer tracking with token identification and significance analysis. The system extracts the wallet address from the page URL, then constructs the Etherscan API endpoint URL (https://api.etherscan.io/api?module=account&action=tokentx&address={address}&sort=desc&offset=20). It uses GM_xmlhttpRequest with GET method to fetch the token transfer list, which returns a JSON array containing up to 20 recent transfer events with fields including hash, from, to, value, contractAddress, tokenSymbol, and tokenDecimal. The tool stores transfer hashes from each fetch in a local history object keyed by wallet address using GM_setValue to persist data across page reloads. On each monitoring cycle, the tool compares the current transfer list against the stored history, filtering out transfers already seen and identifying new transactions. For each new transaction, it checks whether the to address matches the watched wallet (incoming transfer), identifies the token by matching the contractAddress against a built-in watchlist of 20+ common governance tokens including UNI, AAVE, YFI, SUSHI, LINK, CRV, CVX, and MKR, calculates the USD value using a price estimation function, and assesses significance using a tiered system: Critical (>5× threshold), High (>3× threshold), or Medium (≥ threshold).

THE PANEL

The BotGentz panel is fully draggable, allowing you to position it anywhere on your screen without obstructing the Etherscan interface. It includes per-site position memory, so the panel returns to your preferred location each time you visit an address page. Snap-to-edge functionality lets you dock the panel to any side of the browser window. The panel collapses to a compact icon when not in use and expands with a single click. You can resize it to your preferred dimensions, and pressing the Escape key instantly closes the panel. All interactions are smooth and intuitive, designed to work alongside your blockchain investigation workflow.

PLEASE NOTE

This tool requires the free BotGentz extension to function. A real EVM wallet extension is optional — the tool will work without one, but may provide additional on-chain verification if available. EVM chains only. This is a monitoring and alert tool only — it does not execute transaction-based actions automatically. The tool cannot guarantee that the API data includes all mempool transactions or pending unlocks. It cannot account for token price changes between data fetches. It cannot read transfer history from wallets or tokens not tracked on Etherscan. It cannot identify governance tokens not included in the watchlist. It cannot detect unlocks that occur through proxy contracts or multi-step transfers. It cannot verify whether detected inflows are from vesting contracts versus other sources without manual investigation. It cannot predict future unlock schedules or token distributions. All API data is fetched through public endpoints; no data is stored or transmitted beyond your browser. Websites change their layouts and content structures regularly; while we continuously update the extraction logic, some pages may require script updates. Always verify all unlock details independently before making any decisions based on the alerts.