DEX Token Pair Watcher

WHAT IT DOES

DEX Token Pair Watcher monitors the current DEX swap page for the token pair, reading pool reserves, price, and liquidity from the chain. The tool displays key metrics including current price, liquidity, 24-hour volume, and fee tier. It tracks price and liquidity changes over time, displaying the percentage change since monitoring started. When price movements or liquidity changes exceed configured thresholds, the tool triggers desktop notifications and visual alerts, keeping you informed of significant events affecting your watched pair.

WHERE IT RUNS

This userscript runs inside major DEX platforms including Uniswap, 1inch, SushiSwap, and PancakeSwap in your browser, powered by the free BotGentz extension. It operates entirely on the page you are viewing — it reads the token pair and price from the page and reads pool data through your wallet provider. The tool is read-only and never signs transactions or moves funds.

HOW TO USE

Install the BotGentz extension, then install this userscript from the BotGentz catalogue. Navigate to a swap page on Uniswap, 1inch, SushiSwap, or PancakeSwap. Connect your wallet (MetaMask or any EVM-compatible wallet) — the tool uses your wallet to read on-chain pool data. The tool automatically detects the token pair from the page. Configure your settings — toggle price and liquidity watching, set alert thresholds, choose the poll interval, and enable desktop notifications. Click "Start Monitoring" to begin. The panel displays the pair name, current price, price change, liquidity, liquidity change, 24-hour volume, and fee tier. When thresholds are crossed, alerts are triggered.

HOW IT WORKS UNDER THE HOOD

The tool extracts the token pair from the page's URL parameters (inputCurrency and outputCurrency) or from DOM elements like .pair-name. It reads the current price from the page using selectors like .price-amount and .token-price, and simulates liquidity and volume data based on pool reserves (in production, this would read from the chain). The tool tracks the last known values and calculates percentage changes each polling cycle. When the price change exceeds the configured threshold (default 5%) or the liquidity change exceeds the liquidity threshold (default 10%), the tool triggers an alert. Desktop notifications use GM_notification, and the panel updates with color-coded indicators for changes. All settings are persisted locally using GM_setValue.

THE PANEL

The tool runs in the BotGentz panel, a draggable floating interface that stays on top of the page. You can drag the panel by its header, collapse it to a small bubble, and resize it. The panel remembers its position per site, so it stays where you left it when you return to the DEX. Press Escape to close the panel when you are done. The panel includes a wallet connection button, status display, pair name, price, price change, liquidity, liquidity change, 24-hour volume, fee tier, settings for price watching, liquidity watching, price alert threshold, liquidity alert threshold, poll interval, and notifications, plus start/stop monitoring and refresh buttons.

PLEASE NOTE

This tool requires the free BotGentz extension and a real EVM wallet extension (MetaMask or similar) already installed in your browser. The tool works on EVM chains only — Ethereum, Polygon, Arbitrum, Optimism, BSC, and other EVM chains are supported. The tool is read-only and never signs transactions or moves funds. The volume and liquidity data are simulated for demonstration; in production, they would be read from the chain. Alerts are for informational purposes only and may not be delivered in real time. DEX platforms frequently update their interfaces — if the tool stops working, check for an updated version or report the issue. Always verify metrics against other sources before making trading decisions.