Price Target Alert for Token

WHAT IT DOES

Price Target Alert for Token watches the current page for token price data from DEXs or oracles, reads the current price from liquidity pools or price feeds via eth_call at regular intervals, and triggers alerts when the price crosses user-defined target levels (upper or lower bounds), with optional percentage change tracking. It helps you catch price movements at critical levels without constant manual monitoring.

WHERE IT RUNS

This tool operates as a userscript within the BotGentz extension framework, running directly in your browser on any website. It works on any EVM-compatible blockchain page—Ethereum, Polygon, Arbitrum, Optimism, and more—where token prices are available via DEX pools or price oracles. The tool integrates seamlessly into your workflow, appearing as a draggable panel that stays accessible as you monitor token prices.

HOW TO USE

Enter the token address and either a DEX pool address (for Uniswap V2-style pools) or a price oracle address in the "Token Setup" section. Configure your price targets in the "Price Targets" section: set an upper target price, a lower target price, and a percentage change threshold. Set your refresh interval and toggle desktop notifications on or off. Click "Start Price Monitoring" to connect your real wallet extension, which will begin reading the token price at your specified interval. The panel displays the current price in real-time. Use "Check Now" for an immediate update, "Clear Alert History" to reset alert tracking, or "Stop Monitoring" to disconnect.

TECHNICAL OPERATION

Price Target Alert for Token uses raw JSON-RPC calls via window.ethereum.request() to interact with the blockchain—no external library required for basic operations. It loads ethers at runtime using a simple script tag injection for ABI encoding and contract interactions. The tool reads price data from either a DEX pool (using getReserves and token0/token1 to calculate the price) or a price oracle (using latestAnswer, latestRoundData, or getPrice functions). It compares the current price against the user-defined upper and lower targets. When the price crosses either target, it triggers a desktop notification and panel flash. The tool also tracks percentage changes from the previous price and triggers alerts when the change exceeds the user-defined threshold. It maintains a history of alert states to avoid duplicate notifications.

THE PANEL

The Price Target Alert for Token panel is fully draggable and remembers its position between sessions using GM_setValue. It snaps to the edge of the viewport for a clean interface and can be collapsed to a small icon when not in use. The panel is resizable to accommodate longer content. Press Escape to quickly close or collapse the panel. The design is optimized for productivity with a dark theme, clear visual hierarchy, and responsive controls that adapt to your workflow.

PLEASE NOTE

This tool requires the free BotGentz extension installed in your browser and a real EVM wallet extension (MetaMask, Rabby, etc.) already installed. EVM chains only—this does not work on non-EVM blockchains. The tool cannot read price data if the pool or oracle contract does not expose the required view functions, cannot detect off-chain price data from centralized exchanges, cannot predict future price movements, and cannot monitor price changes during network congestion or RPC downtime. No private keys are stored or transmitted—all data is read-only from the blockchain. Always verify the token, pool, and oracle addresses before starting monitoring.