Volatility Spike Alert Tool

WHAT IT DOES

Volatility Spike Alert Tool is your price movement intensity monitor that alerts you when tokens experience significant volatility. It automatically detects token symbols and price data from DEX swap pages, NFT marketplaces, and token detail pages, then calculates price volatility using observed price movements including standard deviation, price range, and price change velocity. The tool triggers alerts when volatility exceeds user-defined thresholds and displays volatility metrics with visual indicators—Low (green), Medium (yellow), High (red), and Extreme (purple). It shows volatility history with chart-like trend indicators, supports per-token volatility alerts with pause/resume functionality, and provides configurable lookback windows and sensitivity settings.

WHERE IT RUNS

This script runs on all major DEX interfaces including Uniswap (app.uniswap.org), SushiSwap (app.sushi.com), Curve (curve.fi), Balancer (balancer.fi), 1inch (1inch.io), CowSwap (cow.fi), major NFT marketplaces including OpenSea (opensea.io), Blur (blur.io), LooksRare (looksrare.org), Zora (zora.co), Rarible (rarible.com), Foundation (foundation.app), and Etherscan (etherscan.io). It works on swap pages, token detail pages, NFT listings, and any page displaying token price information.

HOW TO USE

Install the script through the BotGentz userscript manager. Click "Connect Wallet" to link your EVM wallet extension. Navigate to any supported page showing token prices. Create a volatility alert by entering a token symbol and a trigger threshold percentage (e.g., 3.0%). The tool automatically begins tracking price changes for that token. When price volatility exceeds the configured threshold, you receive a browser notification with the percentage change and volatility level. The panel displays real-time volatility metrics including percentage change, range percentage, price velocity, and volatility level with color-coded indicators. Use the lookback window setting to control how many price samples are used for calculation.

VOLATILITY CALCULATION ENGINE WITH MULTI-METRIC ANALYSIS

Unlike simple price change alerts, this tool implements a comprehensive volatility calculation engine that analyzes price movements across multiple dimensions. The engine collects price samples from DOM-detected price data and calculates three key volatility metrics: standard deviation (measuring price dispersion from the mean), price range (difference between high and low prices as a percentage), and price change velocity (rate of change between consecutive samples). Each metric provides a different perspective on volatility—standard deviation captures overall price instability, range captures the full price swing, and velocity captures the speed of movement. The combined analysis triggers alerts when any metric exceeds user-defined thresholds, with visual indicators that classify volatility as Low, Medium, High, or Extreme. The lookback window parameter (configurable, default 20 samples) controls the time horizon for volatility calculations, enabling users to adjust sensitivity to short-term versus long-term price behavior.

THE PANEL

The floating panel is fully draggable and snap-to-edge enabled. You can collapse it to a compact bubble when not in use, resize it to your preferred dimensions, and it remembers its position across page loads using persistent storage. Press Escape to quickly dismiss the panel. The panel displays active volatility alerts, real-time metrics for tracked tokens, visual level indicators, and recent spike history.

PLEASE NOTE

This script requires the free BotGentz extension to be installed in your browser—it does not run as a standalone extension. You also need a real EVM wallet extension already installed and configured. The tool cannot fetch historical price data beyond what is observed while the page is open and relies on the page exposing current price in a detectable format. Volatility calculations are based on observed price changes during the browsing session only. No user data is collected or transmitted—all alert configurations and history stay local in your browser storage. The tool provides volatility monitoring assistance but does not guarantee real-time price accuracy or comprehensive token coverage.