On-Chain News Alert Overlay

WHAT IT DOES

On-Chain News Alert Overlay watches the current Etherscan address page for the displayed wallet address, reads the wallet's recent transaction history via the Etherscan API, monitors for interactions with high-profile protocols, large transfers, and contract deployments, identifies notable on-chain events such as whale movements, protocol interactions, and new contract creations, and displays news alerts with event type, transaction details, and significance assessment when significant on-chain events are detected. The tool extracts the wallet address from the page URL, fetches recent transaction history from the Etherscan API using the transaction list endpoint, stores historical transaction snapshots locally to detect new events, identifies protocol interactions by matching contract addresses against a built-in list of known protocols, calculates transaction value in USD using approximate token prices, detects contract deployments by checking for zero-address transactions, and classifies events by type including whale transfers, protocol interactions, and deployments. It then displays alerts with the event type, transaction details, protocol name, value, 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 transaction history is available through the Etherscan API. The tool connects to the Etherscan public API via GM_xmlhttpRequest to fetch transaction 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 On-Chain News Alert Overlay panel. Set your minimum transaction value in USD (default $1,000,000) — the tool will alert you when any transaction exceeding this value is detected. 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 News" — the tool begins fetching transaction data from the Etherscan API at your chosen interval, stores historical transaction hashes locally, and compares each new fetch against the stored history. When a new transaction is detected, the tool classifies it by type (whale transfer, protocol interaction, or deployment), identifies any known protocols involved, calculates its USD value, and triggers an alert if it meets the significance criteria. The alert log maintains a history of recent alerts for review. Click "Refresh" to manually check for new events, or "Clear History" to reset the alert log.

MECHANISM — EVENT CLASSIFICATION AND SIGNIFICANCE ASSESSMENT

This tool uses an event classification engine that combines transaction monitoring with protocol identification and significance assessment. 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=txlist&address={address}&sort=desc&offset=15). It uses GM_xmlhttpRequest with GET method to fetch the transaction list, which returns a JSON array containing up to 15 recent transactions with fields including hash, from, to, value, timeStamp, and gasUsed. The tool stores transaction 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 transaction list against the stored history, filtering out transactions already seen and identifying new events. Each new transaction is classified by checking: whether the to address is zero (indicating a contract deployment), whether the to address matches a known protocol in the built-in list of high-profile DeFi protocols, and whether the USD value exceeds the configured threshold. Significance is assessed using a tiered system: Critical (>5× threshold), High (>3× threshold), or Medium (≥ threshold). Alerts are triggered with the event type, protocol name (if applicable), value, and significance assessment.

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 analysis 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 events. It cannot account for token price changes between data fetches. It cannot read transaction history from wallets not visible on Etherscan. It cannot identify protocols not included in the known protocol list. It cannot detect events that do not involve transfers or contract interactions. It cannot predict future on-chain events or significance. It cannot verify the authenticity or legitimacy of identified protocols. 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 event details independently before making any decisions based on the alerts.