Volume Spike Alert for Token

WHAT IT DOES

Volume Spike Alert for Token watches the current page for token trading volume data from DEXs, reads the current volume from liquidity pools via eth_call at regular intervals, calculates the volume change over time, and triggers alerts when a volume spike exceeds a user-defined multiplier or threshold. It helps you detect sudden trading interest and potential market-moving activity before prices react significantly.

WHERE IT RUNS

This tool operates as a userscript within the BotGentz extension framework, running directly in your browser on any website. It works on any EVM-compatible blockchain page—Ethereum, Polygon, Arbitrum, Optimism, and more—where DEX liquidity pools are deployed. The tool integrates seamlessly into your workflow, appearing as a draggable panel that stays accessible as you monitor trading activity.

HOW TO USE

Enter the token address and DEX pool address in the "Token & Pool Setup" section. Configure your volume settings: set the spike multiplier (e.g., 2x average volume), adjust the lookback period (number of blocks to average), and set the refresh interval. Toggle desktop notifications on or off. Click "Start Volume Monitoring" to connect your real wallet extension, which will begin reading volume data at your specified interval. The panel displays current volume, average volume, and whether a spike is active. Use "Check Now" for an immediate update, "Clear History" to reset the volume history, or "Stop Monitoring" to disconnect.

TECHNICAL OPERATION

Volume Spike Alert for Token uses raw JSON-RPC calls via window.ethereum.request() to interact with the blockchain—no external library required for basic operations. It loads ethers at runtime using a simple script tag injection for ABI encoding and contract interactions. The tool reads swap event logs from the DEX pool via eth_getLogs using the Swap event signature. It calculates the volume by decoding the event data (amount0In, amount1In, amount0Out, amount1Out) and converting to the token's units using the pool's reserves. The tool maintains a rolling history of volume data and calculates the average volume over the specified lookback period. When the current volume exceeds the average multiplied by the user-defined spike multiplier, it triggers a desktop notification and panel flash. The tool also displays the current spike status and updates in real-time.

THE PANEL

The Volume Spike Alert for Token panel is fully draggable and remembers its position between sessions using GM_setValue. It snaps to the edge of the viewport for a clean interface and can be collapsed to a small icon when not in use. The panel is resizable to accommodate longer content. Press Escape to quickly close or collapse the panel. The design is optimized for productivity with a dark theme, clear visual hierarchy, and responsive controls that adapt to your workflow.

PLEASE NOTE

This tool requires the free BotGentz extension installed in your browser and a real EVM wallet extension (MetaMask, Rabby, etc.) already installed. EVM chains only—this does not work on non-EVM blockchains. The tool cannot read volume data if the pool contract does not expose the required view functions or event logs, cannot detect off-chain volume from centralized exchanges, cannot predict future volume spikes, and cannot monitor volume during network congestion or RPC downtime. No private keys are stored or transmitted—all data is read-only from the blockchain. Always verify the token and pool addresses before starting monitoring.