Percentage Move Alert Builder

WHAT IT DOES

Percentage Move Alert Builder is your price movement tracking tool that alerts you when tokens move by your specified percentages. It automatically detects token symbols and current prices from DEX swap pages, NFT marketplaces, and token detail pages, then builds percentage-based price movement alerts with configurable thresholds (e.g., +5%, -10%). The tool monitors price changes over time from page data, triggering alerts when percentage moves exceed your thresholds. It displays active alerts with progress bars showing movement toward the threshold, supports multi-token alert management with pause/resume functionality, and shows historical percentage moves and alert trigger frequency for each token.

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 a token price. Create alerts by entering a token symbol and setting up and down percentage thresholds (e.g., 5% up, 5% down). The tool automatically detects the current price and sets it as the base. As prices change, the tool calculates the percentage move and displays a progress bar showing how close the token is to triggering your alert. When a threshold is crossed, you receive a browser notification. Use the pause/resume function to temporarily disable alerts, and view alert history to see past triggers.

PRICE MOVEMENT DETECTION AND PROGRESS-BASED ALERT ENGINE

Unlike simple price alerts that only fire at fixed prices, this tool implements a percentage-based movement detection engine that calculates real-time percentage changes from a baseline price. The engine detects token symbols and current prices using DOM parsing, then stores each token's baseline price and monitors subsequent price changes. Percentage moves are calculated using the formula: ((currentPrice - basePrice) / basePrice) × 100. The alert engine supports two independent thresholds—percentage up and percentage down—allowing users to set asymmetric alerts (e.g., +5% up, -10% down). Each alert includes a visual progress bar that shows how far the price has moved toward the threshold, providing immediate visual feedback on price momentum. The engine includes a cooldown mechanism to prevent repeated alerts, preserving the baseline price for the next comparison cycle.

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 alerts with current prices, percentage moves, progress bars, status badges (Active/Paused/Triggered), and recent alert 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. Percentage moves are calculated from 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 alerting assistance but does not guarantee real-time price accuracy or comprehensive token coverage.