Token Balance Overlay Widget

WHAT IT DOES

Token Balance Overlay Widget displays a persistent, movable overlay showing your connected wallet's balance for one or more ERC-20 tokens. You can add token addresses with optional symbols to track, and the overlay shows the current balance and USD value for each token. The overlay is compact, showing token symbols and balances in a clean list. Clicking any token entry copies its address to your clipboard instantly. A manual refresh button and automatic updates every 30 seconds keep your balances current.

WHERE IT RUNS

This tool runs as a userscript inside the BotGentz extension on any website. It connects directly to your real EVM wallet via window.ethereum—no intermediate bridge. It works on any page, making it a universal token balance monitor.

HOW TO USE

Install the script and navigate to any page. Click "Connect Wallet" to link your EVM wallet. In the panel, add token addresses with their symbols (e.g., "USDC" for 0xA0b869...). You can also add the native token (ETH, MATIC, etc.) with the "Add Native" button. Once tokens are added, a compact overlay appears showing balances and USD values. Click any token in the overlay to copy its address. Drag the overlay anywhere on the screen. Use the panel to refresh balances or remove tokens.

TECHNICAL MECHANISM

The tool connects to your wallet via window.ethereum and uses eth_call to read ERC-20 token balances via the balanceOf function (0x70a08231). It also reads the native token balance using eth_getBalance. Token decimals are fetched using the decimals() function (0x313ce567) and symbols are fetched using symbol() (0x95d89b41). Token prices are fetched from the CoinGecko API (with a 60-second cache). The overlay updates every 30 seconds and also refreshes when wallet accounts change. The overlay is a fixed-position element with drag support and position persistence using GM_setValue.

THE PANEL

The panel can be dragged anywhere on screen, snapped to the edge, resized, collapsed, and closed with Escape. It remembers its position per site and stays out of your way until you need it.

PLEASE NOTE

This tool requires the free BotGentz extension and a real EVM wallet extension (e.g., MetaMask) installed in your browser. It is EVM-only and works on Ethereum, Optimism, Arbitrum, Polygon, Base, and other EVM-compatible chains. Token addresses must be added manually; the tool does not auto-detect tokens in your wallet. Price feeds may be unavailable for obscure tokens. Sites change frequently; the script may need updating. No data is collected or stored beyond your own browser settings.