Multi-Token Watchlist Alert Dashboard

WHAT IT DOES

Multi-Token Watchlist Alert Dashboard is your comprehensive token monitoring tool that keeps you informed about the tokens you care about most. It automatically detects token symbols and contract addresses from DEX swap pages, NFT marketplaces, and token detail pages, allowing you to build a personalized watchlist with one click. The tool monitors your watchlist tokens for price movements, volume changes, and wallet balance updates, displaying a clean dashboard showing current prices, 24h changes, and alert status. It supports price threshold alerts (above/below), volume spike alerts, and whale transaction alerts, with real-time notification integration and visual indicators. The dashboard also shows alert history and trend analysis for informed decision-making.

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 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 and the tool will detect tokens automatically. Add tokens to your watchlist by entering a symbol or using the "Add Current Token" button. Set price alerts by specifying an "Alert above" or "Alert below" price for any watchlist token. The dashboard displays all your watched tokens with current prices, price changes, and alert status—alert-triggered tokens are highlighted with a bell icon. Receive browser notifications when alerts trigger. The panel shows recent alert history and supports configurable alert cooldown periods to prevent notification spam.

DOM-BASED TOKEN DETECTION AND MULTI-CONDITION ALERT ENGINE

Unlike portfolio trackers that rely on external API integrations, this tool implements a DOM-based token detection engine that extracts token symbols, prices, and change data directly from the pages you visit. The engine scans page text for token symbols (2-8 character uppercase strings), price data using regex patterns, and 24h change percentages. Each detected token is cross-referenced against your watchlist, with price and change data stored for alert evaluation. The multi-condition alert engine supports three alert types: price above threshold, price below threshold, and volume spike. Each alert includes a cooldown mechanism (configurable, default 5 minutes) to prevent repeated notifications. The dashboard displays watchlist tokens in a compact card format with color-coded change indicators (green for up, red for down) and alert badges that show when a token has triggered a condition. Alert history is persisted locally, allowing you to review past alerts and identify patterns in token 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 your watchlist tokens with prices and changes, alert status indicators, recent alert history, and quick-add functionality for new tokens.

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 real-time price data from external APIs without additional integration and relies on the page exposing token data in a detectable format. Price alerts depend on price data visible on the current page. No user data is collected or transmitted—all watchlist and alert history stay local in your browser storage. The tool provides monitoring assistance but does not guarantee real-time price accuracy or comprehensive token coverage.