Create Price Breakout Alert

WHAT IT DOES

This tool monitors token prices using the CoinGecko API and alerts you when a price breaks above or below a configurable threshold. You specify the token symbol (e.g., ethereum, bitcoin, polygon), set a threshold price in USD, and choose whether to alert on price above or below that level. The tool polls CoinGecko at your specified interval and triggers an alert when the condition is met. All alert configurations are stored in-memory — no data is persisted across page reloads.

HOW TO USE

Connect your MetaMask wallet using the Connect button. Give your alert a name, enter the token symbol (use CoinGecko IDs like "ethereum", "bitcoin", "polygon"), select the condition (above or below), set the threshold price in USD, and choose a check interval (5-300 seconds). Click "Create Alert" to start monitoring. Active alerts appear in the list. When a price breakout is detected, the alert status changes to "Triggered" and the event appears in the Price Breakouts log with a rocket emoji. Use "Remove" to delete an individual alert or "Clear All" to remove all alerts and history.

TECHNICAL MECHANISM

The tool does not read from the blockchain — it uses the CoinGecko public API's /simple/price endpoint. For each active alert, it creates a JavaScript interval that runs at the user-specified frequency. On each interval tick, the tool constructs a request to CoinGecko using the token symbol and fetches the current USD price. The fetched price is compared against the configured threshold. If the condition (above or below) evaluates to true, the alert is marked as triggered and logged. The tool includes a price history log that displays recent checks and breakouts. All alert configurations and state are stored in-memory variables — no data is persisted to disk. When the page is reloaded, all alerts are cleared.

WHAT IT CANNOT SEE

This tool cannot persist alerts across page reloads because it runs in an opaque-origin sandboxed frame with no storage access. It cannot send push notifications or emails without external services. It cannot provide real-time price data if the CoinGecko API is unavailable or rate-limited. It cannot detect price breakouts on tokens not listed on CoinGecko. It cannot detect breakouts below the configured polling interval — a breakout that occurs between checks will not be detected. It cannot detect intra-day volatility without more frequent polling. It cannot detect price breakouts on non-EVM networks. It cannot provide trading signals or investment advice. It cannot detect breakouts based on volume or other technical indicators. It cannot monitor multiple tokens simultaneously without creating separate alerts.

PLEASE NOTE

This tool works only with EVM-compatible wallets connected via the BGWallet bridge, but the price data comes from CoinGecko and is not network-specific. The token symbol must match CoinGecko's ID exactly — common IDs include "ethereum", "bitcoin", "matic-network", "binancecoin", "solana", "avalanche-2", "arbitrum", "optimism". CoinGecko's public API has rate limits — frequent requests may be throttled. Alerts are in-memory only and will be lost when the page is refreshed or closed. The tool does not store or transmit any data — all processing occurs in your browser. This tool is provided as a lightweight price monitoring utility and should not be used as a financial trading signal or investment decision tool.