Wallet Balance Overlay for Site

WHAT IT DOES

Wallet Balance Overlay for Site displays a persistent, movable overlay on any webpage showing your connected wallet's native token balance and its equivalent value in USD or your chosen fiat currency. It updates in real-time when your wallet balance changes or when you interact with the page. The overlay supports multiple EVM chains—Ethereum, Optimism, Arbitrum, Polygon, Base, and others—and automatically detects your current network. Clicking the balance copies your wallet address to the clipboard instantly. A refresh button lets you manually update the balance and price at any time. The overlay can be dragged anywhere on the screen and remembers its position.

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. All balance and price data is fetched live from the blockchain and from a public price API.

HOW TO USE

Install the script and navigate to any page. A small, unobtrusive overlay appears in the corner of your screen. Click "Connect wallet" on the overlay to link your EVM wallet. Once connected, your balance and USD value are displayed. Click the overlay to copy your wallet address to the clipboard. Drag the overlay anywhere on the screen. Use the panel to refresh the balance, copy your address, change the fiat currency, or adjust the overlay position. The overlay updates automatically every 30 seconds.

TECHNICAL MECHANISM

The tool uses window.ethereum to request wallet access and reads your native token balance via eth_getBalance. It then fetches the current token price from the CoinGecko API (with a 60-second cache to avoid rate limits) and multiplies it by your balance to display the fiat value. The overlay is a fixed-position element with high z-index, styled to blend with the page while remaining visible. Drag functionality is implemented using mousedown/mousemove/mouseup events, with position persistence using GM_setValue. The overlay updates on a 30-second interval and also refreshes when wallet accounts change. Price data is cached briefly to minimize API calls.

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 balances (ERC-20) are not displayed unless specifically configured. Price feeds are fetched from CoinGecko and require internet access. Sites and APIs change frequently; the script may need updating. No data is collected or stored beyond your own browser settings.