Correlation Break Alert Tool

WHAT IT DOES Correlation Break Alert Tool is your relationship monitoring tool for token pairs that alerts you when historically correlated tokens start moving independently. It automatically detects token symbols and price data from DEX swap pages, NFT marketplaces, and token detail pages, then monitors multiple tokens simultaneously to calculate price correlation coefficients using Pearson correlation. The tool detects correlation breaks when the historical correlation between two or more tokens deviates beyond a user-defined threshold, displaying correlation metrics with visual indicators—Strong (green, r ≥ 0.7), Medium (yellow, r ≥ 0.4), Weak (red, r ≥ 0.2), and Broken (purple, r < 0.2). It shows correlation history with trend lines, supports pair-based correlation alerts with pause/resume functionality, and provides configurable correlation windows and break thresholds. 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 for multiple tokens. 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. Add a correlation pair by entering two token symbols and a break threshold (default 0.3). The tool automatically tracks both tokens' prices and calculates their correlation in real-time. When the correlation drops below the threshold, you receive a browser notification. The panel displays all tracked pairs with current correlation values, strength indicators, and status (Tracking/Broken). Use the pause/resume function to temporarily suspend monitoring for specific pairs. Adjust the lookback window (default 30 samples) to control the time horizon for correlation calculations. PEARSON CORRELATION ENGINE WITH REAL-TIME BREAK DETECTION Unlike simple price comparison tools that only show current price differences, this tool implements a full Pearson correlation coefficient engine that calculates the statistical relationship between two tokens' price movements. The engine collects price samples from DOM-detected price data for each token, aligning them by timestamp to ensure synchronous comparison. The Pearson correlation coefficient (r) is calculated using the formula: r = Σ((x - x̄)(y - ȳ)) / √(Σ(x - x̄)² × Σ(y - ȳ)²), where x and y are the price series for the two tokens. This produces a value between -1 and 1, where 1 indicates perfect positive correlation, 0 indicates no correlation, and -1 indicates perfect negative correlation. The engine monitors this coefficient in real-time, comparing it against the user-defined break threshold to detect when correlation weakens. Visual indicators (Strong/Medium/Weak/Broken) provide immediate context for the current correlation strength, with color-coded badges that make it easy to spot changes in token relationships. 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 correlation pairs with current r-values, strength indicators, status badges, and recent break 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. Correlation calculations are based on observed price changes during the browsing session only and require at least two tokens to be tracked simultaneously. No user data is collected or transmitted—all correlation configurations and history stay local in your browser storage. The tool provides correlation monitoring assistance but does not guarantee real-time price accuracy or comprehensive token coverage.