Multi-Position Health Dashboard Overlay

WHAT IT DOES

Multi-Position Health Dashboard Overlay watches the current DeFi lending page for the user's wallet address, reads the user's supplied assets and borrowed assets from the protocol contract(s) on-chain, calculates health factor and collateralization ratio for each position, aggregates data across multiple positions, monitors changes in health metrics over time, and displays a consolidated dashboard with position health, risk levels, and recommendations when any position approaches an undercollateralized state. The tool connects to the user's wallet via window.ethereum, reads supplied and borrowed asset balances from the protocol contract(s), fetches current asset prices from the protocol's price oracle, calculates health factors for each position using the protocol's formula, aggregates data across all positions to determine overall portfolio health, and displays a comprehensive dashboard with color-coded risk indicators.

WHERE IT RUNS

The tool runs as a panel inside your browser on DeFi lending pages at https://app.aave.com/* and https://app.compound.finance/*. It works on Aave and Compound dashboard pages where users can view their supplied and borrowed positions. The tool connects to your real EVM wallet extension (MetaMask, WalletConnect, or any wallet injecting window.ethereum) to read on-chain data via eth_call and the ethers library loaded at runtime. No data is sent to any external server; all reads happen directly from the blockchain through your wallet provider.

HOW TO USE

Install the BotGentz extension, navigate to your Aave or Compound dashboard, and open the Multi-Position Health Dashboard Overlay panel. Set your warning threshold health factor (default 1.5) — the tool will display a warning when any position's health factor falls below this value. Set your critical threshold health factor (default 1.1) — the tool will trigger critical alerts when any position falls below this value. Select your monitoring interval from the dropdown — 15, 30, 60, or 120 seconds. Choose your alert preference — Panel only, Browser notification, or Both. Toggle "Auto-check on page load" if you want the tool to analyze automatically when you open the panel. Click "Monitor Health" — the tool connects to the protocol contracts, reads your supplied and borrowed asset balances, fetches current prices from the price oracle, calculates health factors for each position and overall portfolio, and displays a consolidated dashboard with position summaries, health factors, and risk levels. When any position approaches the configured thresholds, the tool triggers alerts with the health factor and risk level. The dashboard updates automatically at your chosen interval. Click "Refresh" to manually update the health status.

MECHANISM — MULTI-POSITION HEALTH AGGREGATION WITH RISK CLASSIFICATION

This tool uses a multi-position health aggregation engine that evaluates DeFi lending positions across multiple assets. The system first connects to window.ethereum and requests the user's wallet address. It detects the protocol from the page URL (Aave or Compound) to determine the appropriate contract addresses and health factor calculation methods. The tool reads the user's supplied asset balances and borrowed asset balances from the protocol contracts via eth_call. It fetches current asset prices from the protocol's price oracle, then calculates the health factor for each position using the protocol's standard formula: Health Factor = (suppliedValue * liquidationThreshold) / borrowedValue. It also calculates aggregate metrics: total collateral (sum of all supplied assets in USD), total debt (sum of all borrowed assets in USD), and overall health factor (total collateral / total debt). The tool classifies each position and the overall portfolio using a multi-tier system: CRITICAL (health ≤ critical threshold), WARNING (health ≤ warning threshold), or SAFE (health > warning threshold). Alerts are triggered when positions cross these thresholds, and recommendations are provided based on the risk level.

THE PANEL

The BotGentz panel is fully draggable, allowing you to position it anywhere on your screen without obstructing the DeFi interface. It includes per-site position memory, so the panel returns to your preferred location each time you visit the dashboard. Snap-to-edge functionality lets you dock the panel to any side of the browser window. The panel collapses to a compact icon when not in use and expands with a single click. You can resize it to your preferred dimensions, and pressing the Escape key instantly closes the panel. All interactions are smooth and intuitive, designed to work alongside your DeFi position management workflow.

PLEASE NOTE

This tool requires the free BotGentz extension and a real EVM wallet extension (such as MetaMask) already installed in your browser. EVM chains only — currently supports Ethereum mainnet. This is a monitoring and dashboard tool only — it does not execute position management transactions automatically. The tool cannot guarantee that the displayed health metrics match the exact moment of execution due to price oracle latency. It cannot account for asset price fluctuations between data reads. It cannot read position data from protocols not supported by the tool. It cannot read cross-protocol positions that affect overall health. It cannot predict future price movements or health changes. It cannot read private wallet information or position management intentions. All blockchain reads are performed directly through your wallet provider; no data is stored or transmitted beyond your browser. Websites change their layouts and content structures regularly; while we continuously update the extraction logic, some pages may require script updates. Always verify all position health metrics and risk levels independently before taking any action based on the dashboard.