Lending Position Health Overlay

WHAT IT DOES

Lending Position Health Overlay monitors the current lending position page, reading your collateral balance, debt balance, health factor, and liquidation prices from the chain. The tool calculates risk metrics and overlays a visual indicator on the page showing your position's health status — safe (green), warning (yellow), or danger (red) — along with the liquidation threshold. The panel displays detailed position metrics including health factor, collateral amount, debt amount, LTV, and liquidation price. This gives you a clear, at-a-glance view of your position's risk level without having to navigate away from the page.

WHERE IT RUNS

This userscript runs inside major DeFi lending platforms including Aave, Compound, and Curve in your browser, powered by the free BotGentz extension. It operates entirely on the page you are viewing — it reads position data from the page and optionally through your wallet provider. The tool is read-only and never signs transactions or moves funds.

HOW TO USE

Install the BotGentz extension, then install this userscript from the BotGentz catalogue. Navigate to a lending position page on Aave, Compound, or Curve. Connect your wallet (MetaMask or any EVM-compatible wallet) — the tool uses your wallet to read on-chain position data. Configure your settings — choose the overlay position (top-right, bottom-left, or bottom-right), set the warning and danger health factor thresholds, toggle liquidation price display, and set the refresh interval. Click "Start Monitoring" to begin. The tool will display an overlay on the page with your health status, health factor, collateral, debt, and liquidation threshold. The panel shows detailed metrics including health factor, collateral, debt, LTV, and status.

HOW IT WORKS UNDER THE HOOD

The tool extracts position data from the page's DOM using platform-specific selectors like .health-factor, .collateral-value, .debt-value, and .ltv-value. When not directly available, it calculates the health factor as (collateral * 0.8) / debt. The health status is determined by comparing the health factor against configurable warning and danger thresholds — safe above warning, warning between warning and danger, danger below danger. The overlay is a fixed-position DOM element with a color-coded left border and status indicator. The liquidation threshold is displayed as a percentage, and the panel provides a comprehensive view of all position metrics. The tool updates at the configured refresh interval, and all settings are persisted locally using GM_setValue.

THE PANEL

The tool runs in the BotGentz panel, a draggable floating interface that stays on top of the page. You can drag the panel by its header, collapse it to a small bubble, and resize it. The panel remembers its position per site, so it stays where you left it when you return to the platform. Press Escape to close the panel when you are done. The panel includes a wallet connection button, health status display with color coding, health factor, collateral, debt, LTV, settings for overlay position, warning and danger thresholds, liquidation price display, and refresh interval, plus start/stop monitoring and refresh buttons.

PLEASE NOTE

This tool requires the free BotGentz extension and a real EVM wallet extension (MetaMask or similar) already installed in your browser. The tool works on EVM chains only — Ethereum, Polygon, Arbitrum, Optimism, and other EVM chains are supported. The tool is read-only and never signs transactions or moves funds. The health factor is an estimate based on current data and may change after the next block. DeFi platforms frequently update their interfaces — if the tool stops working, check for an updated version or report the issue. Always verify position metrics against the platform's official interface before making decisions. Lending positions carry liquidation risk — monitor your health factor regularly.