Off-Peak Gas Time Predictor

WHAT IT DOES

Off-Peak Gas Time Predictor is an advanced transaction optimization tool that analyzes historical gas price patterns to predict the best times to execute blockchain transactions. The tool continuously collects gas price data from your connected wallet's RPC endpoint via eth_gasPrice calls, building a comprehensive history of gas prices over days and weeks. Using this historical data, it identifies recurring patterns—such as lower gas prices on weekends, during specific hours of the day, or around market events—and generates predictions for off-peak windows. The panel displays a list of predicted off-peak windows for the next 24 hours, each with a confidence level (High/Medium/Low) and estimated gas savings percentage. It highlights the best time to execute a transaction in the next hour, 6 hours, and 24 hours, making it easy to plan your transactions. A visual heatmap shows gas prices by day of week and hour of day, enabling you to identify optimal times at a glance. The tool sends desktop notifications when an off-peak window is approaching, so you never miss a savings opportunity.

WHERE IT RUNS

This overlay operates on any website (matching all URLs) across the entire web. It works in any browser that supports the BotGentz extension framework and has an EVM-compatible wallet extension installed. The panel activates automatically when you're on a page and begins collecting and analyzing gas price data for your current chain.

HOW TO USE

Install the extension and connect your wallet. The tool immediately starts collecting gas price data from your wallet's RPC endpoint, building a historical database. The more data it collects, the more accurate the predictions become—reliable predictions typically require at least 7 days of data. The panel displays predicted off-peak windows with confidence levels and savings estimates. Check the "Best Off-Peak Window" section for the top recommended time, and review the list of top predictions for additional options. Use the heatmap to visualize gas price patterns by day and hour—green cells indicate lower prices. Configure settings: set the prediction window (4-48 hours), confidence threshold (Low/Medium/High), notification timing (10-60 minutes before), and minimum savings percentage to trigger notifications. Use the "Refresh Predictions" button to update forecasts, "Clear History" to reset data, and "Save Settings" to apply preferences.

MECHANISM: HISTORICAL PATTERN ANALYSIS WITH TIME-BASED AGGREGATION AND CONFIDENCE SCORING

The extension implements a sophisticated pattern recognition system that builds a time-based matrix of historical gas prices. Every 5 minutes, the tool captures the current gas price via eth_gasPrice and stores it with a timestamp and chain ID using GM_setValue, building a dataset of up to 5,000 data points. The prediction engine aggregates this data into a 7x24 matrix (days of week × hours of day), computing the average gas price for each day-hour combination. When a user requests predictions, the engine calculates the current day and hour, then scans forward through the configured prediction window (4-48 hours), comparing each future day-hour combination against the historical average for that slot. For each slot, it calculates the potential savings percentage and a confidence score based on the number of historical data points for that day-hour combination (more data = higher confidence). The predictions are ranked by savings, with confidence levels assigned: High (80%+), Medium (60-79%), and Low (below 60%). The heatmap visualization converts the matrix into a color-coded grid where each cell represents a day-hour combination colored from green (low gas) to red (high gas), with gray indicating no data. The notification system checks the predictions against the user's configured minimum savings threshold and sends a GM_notification at the configured lead time before an off-peak window begins.

THE PANEL

The overlay panel is fully draggable via its title bar and remembers its position per-site using GM_setValue. It snaps to the nearest edge when dragged within 40px of any screen boundary. The panel includes clear sections for gas price predictor (chain name, wallet address, current gas price, data points and days of history), best off-peak window (top recommendation with time, price, savings, confidence, and savings label), top predictions (list of up to 5 upcoming off-peak windows with times and savings), best times (next 6 hours and 24 hours recommendations), heatmap (7x24 color-coded grid with legend), settings (prediction window selector, confidence threshold selector, notification timing selector, minimum savings input, notification toggle), and action buttons (Refresh Predictions, Clear History, Save Settings). The heatmap provides a visual snapshot of gas price patterns, making it easy to spot optimal times without reading through text. Pressing Escape temporarily dismisses the panel until you navigate to a new page or manually reactivate.

PLEASE NOTE

This extension requires the free BotGentz framework extension to be installed and active. You must also have a real EVM-compatible wallet extension (such as MetaMask, WalletConnect, Coinbase Wallet, or Rabby) already installed in your browser—the overlay uses your wallet's RPC provider for eth_gasPrice calls and chain detection. This tool is read-only—it does not send transactions or modify gas settings; it only predicts optimal times. The tool cannot predict future gas prices with certainty (predictions are estimates based on historical patterns that may not repeat); depends on the wallet's RPC endpoint which may be rate-limited or unavailable; requires at least 7 days of historical data for reliable predictions; data is stored locally and may be lost if storage is cleared; does not support chains where gas price mechanics differ significantly from Ethereum's fee market; cannot account for unexpected network events, surges, or market conditions; does not support non-EVM chains where gas calculation methods differ; and cannot provide accurate predictions if the user switches chains without refreshing the panel. No private keys, wallet balances, browsing history, or transaction data are ever collected, transmitted, or stored outside your local browser—all data is stored locally using GM_setValue. Predictions are for informational purposes only—always verify current gas prices before executing transactions.