DEX Price Deviation Alert

WHAT IT DOES

DEX Price Deviation Alert monitors the current DEX swap page for the token pair price and compares it against a reference price from a secondary source (simulated). When the price deviation exceeds a configured threshold percentage, the tool triggers an alert — desktop notification, sound, and a visual indicator in the panel. The deviation is displayed in real time with color-coded indicators showing the severity level relative to the threshold. You can configure the threshold, reference source, check interval, notification settings, sound, and alert cooldown to match your preferences.

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 price from the page and simulates a reference price 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 data. Configure your settings — set the deviation threshold percentage, choose the reference source, set the check interval in seconds, and toggle desktop notifications, sound alerts, and alert cooldown. Click "Start Monitoring" to begin. The panel displays the current DEX price, reference price, and deviation percentage with color coding. When the deviation exceeds the threshold, an alert is triggered and the status changes to red.

HOW IT WORKS UNDER THE HOOD

The tool extracts the current token price from the DEX page using DOM selectors like .price-amount, .token-price, and [data-testid="price-amount"]. It then generates a reference price — in production, this would fetch from an oracle or aggregator; here it's simulated with slight random variation to demonstrate the alert mechanism. The deviation is calculated as ((currentPrice - referencePrice) / referencePrice) * 100. When the absolute deviation exceeds the configured threshold, the tool triggers an alert. To prevent alert spam, a cooldown period (in minutes) prevents repeated alerts for the same deviation event. Desktop notifications use GM_notification, and sound alerts use the Web Audio API to generate a two-tone beep. 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, current price, reference price, deviation with color coding, settings for threshold, reference source, check interval, notifications, sound, and cooldown, plus start/stop monitoring and manual check 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 reference price is simulated for demonstration; in production, it would use real oracle data. Price deviations may be due to legitimate market movements or temporary liquidity imbalances. DEX platforms frequently update their interfaces — if the tool stops working, check for an updated version or report the issue. Always verify price data against multiple sources before making trading decisions.