Time-Weighted Average Price Executor

WHAT IT DOES

Time-Weighted Average Price Executor is your institutional-grade trading tool for executing large orders on decentralized exchanges while minimizing market impact. It implements the Time-Weighted Average Price (TWAP) strategy by automatically splitting your large order into equal smaller chunks that execute at regular intervals over a configured time period. The tool detects token pairs, current prices, and user balances directly from the DEX page, then calculates and displays the average price achieved, price deviation from target, and execution progress in real-time. It provides visual progress indicators and estimated completion time, with support for one-click TWAP execution, transaction scheduling, pause/resume capability, and gas optimization.

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), and 1inch (1inch.io). It works on swap pages and trading interfaces where users exchange tokens. The tool automatically detects the DEX interface regardless of how it's structured and adapts its TWAP execution engine to the specific page.

HOW TO USE

Install the script through the BotGentz userscript manager. Navigate to a supported DEX swap page. Click "Connect Wallet" to link your EVM wallet extension—the tool supports MetaMask, Coinbase Wallet, and any Web3-compatible wallet. The panel will automatically detect the swap interface, token pair, and current market price. Configure your TWAP order by setting the number of chunks, total duration (minutes), maximum price deviation tolerance, and gas multiplier. Enter your desired trade amount on the DEX page, then click "Start TWAP" to begin execution. The script will execute the first chunk immediately, then schedule subsequent chunks at regular intervals. You can pause, resume, or stop the execution at any time. The panel displays real-time progress including completed chunks, average price achieved, and price deviation monitoring.

SCHEDULED CHUNK EXECUTION ENGINE WITH DEVIATION GUARD

Unlike simple limit order tools that only place one order, this tool implements a full TWAP scheduling engine that automatically splits your trade across multiple transactions over time. The engine uses a time-weighted distribution model where each chunk represents an equal fraction of the total order (total amount ÷ number of chunks). The interval between chunks is calculated as (total duration × 60 seconds) ÷ number of chunks, ensuring even spacing. The tool includes a deviation guard that monitors price movement between chunks and can automatically pause execution if price deviation exceeds your configured threshold (default 2%). It also maintains a running TWAP calculation that updates after each chunk, showing the average price achieved and deviation from the current market price. Each chunk automatically sets the amount in the DEX interface, triggers the swap, and waits for confirmation before proceeding to the next scheduled interval.

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 automatically updates with fresh market data every 30 seconds when not executing, and during execution it provides real-time progress updates, chunk completion status, and price deviation alerts.

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 works with major DEXs but may not detect all DEX interfaces correctly. Market movements during execution can affect actual execution price vs the target TWAP. Gas costs for multiple transactions may be higher than a single large trade. Long-running TWAP executions are vulnerable to browser sleep or background throttling. No user data is collected, stored, or transmitted—all wallet interactions stay local in your browser. Execution success depends on network conditions, pool liquidity, and contract state; the tool provides execution assistance but cannot guarantee order completion if market conditions change rapidly or contract issues occur.