Health Factor Alert-and-Auto-Protect Tool

WHAT IT DOES

This tool evaluates health factor alert and auto-protect conditions for DeFi lending positions, helping users monitor liquidation risk and determine when protective actions are needed. Given a lending contract address, a position ID or user address, an optional collateral token address, and an optional oracle address, it reads the position's collateral balance, debt balance, health factor, liquidation threshold, collateral price, and debt price. The tool then determines the alert level—Safe, Warning, or Critical—and displays a visual health factor bar showing the current health relative to the liquidation threshold. It also provides a protection status indicator showing whether auto-protect is recommended. All data is pulled directly from the blockchain in real time, providing a transparent, timely view of position health for automated alerting and protection triggering.

HOW TO USE

Connect your wallet using the Connect button in the header. Select the target network from the dropdown—Ethereum Mainnet, Polygon, Optimism, Arbitrum One, Base, or Sepolia testnet. Enter the lending contract address, the position ID or user address (position ID is a number, user address is an Ethereum address starting with 0x). Optionally, provide a collateral token address for detailed collateral information, and an oracle address for additional price verification. Click "Check health." The tool will fetch the position's collateral balance, debt balance, health factor, liquidation threshold, prices, and trigger conditions. Results appear in the card below with a prominent alert level badge (Safe, Warning, or Critical), a visual health factor bar showing the position's health relative to the liquidation threshold, a protection status indicator, detailed position information including collateral and debt balances, health factor, liquidation threshold, prices, and a breakdown of protection status factors with checkmarks or crosses. Use this information to monitor position health and configure auto-protect alerts.

HEALTH FACTOR ALERT AND AUTO-PROTECT VERIFICATION WITH LIQUIDATION RISK ANALYSIS

The tool provides comprehensive health factor alert and auto-protect verification through multiple on-chain reads. First, it calls getPosition() or getPositionByUser() to retrieve the position's collateral balance, debt balance, health factor, and liquidation threshold. The health factor is the key metric—when it falls below 1.0, the position becomes liquidatable. The tool also reads getCollateralBalance() and getDebtBalance() for detailed position composition, getCollateralPrice() and getDebtPrice() for valuation context, and getHealthFactor() and getLiquidationThreshold() as fallback reads. The alert level is determined by the health factor—Safe if above 1.5, Warning if between 1.1 and 1.5, and Critical if below 1.1. The tool displays a visual health bar with color coding: green for safe, amber for warning, and red for critical, with the liquidation threshold clearly marked. The protection status indicates whether auto-protect is recommended—active for warning or critical levels. All factors are combined to provide a clear, actionable view of position health and protection needs.

WHAT IT CANNOT SEE

This tool cannot guarantee protection execution—on-chain conditions may change between the check and the transaction. It cannot predict price movements or ensure that the health factor will not deteriorate further. It cannot verify off-chain alert conditions or ensure that the alert reaches the user. It cannot ensure liquidation prevention—the health factor may drop rapidly due to price volatility. It cannot detect oracle manipulation or ensure that the price feeds are accurate. It cannot assure that the lending contract is free from vulnerabilities, bugs, or malicious code. It cannot verify that the position ID or user address is correct. It cannot detect front-running or other execution risks. It cannot provide financial advice or guarantee that protection actions will prevent liquidation. All data is provided as-is for informational purposes only; any reliance on the tool's output for protection decisions is the sole responsibility of the user.

PLEASE NOTE

This tool supports EVM-compatible chains only: Ethereum Mainnet (1), Polygon (137), Optimism (10), Arbitrum One (42161), Base (8453), and Sepolia testnet (11155111). Solana, Tron, Starknet, SUI, TON, Aptos, Bitcoin, Cosmos, and XRP are not supported. The tool requires a Web3 provider (MetaMask or WalletConnect) and access to an RPC endpoint for the selected chain. It does not store any wallet data, position IDs, or alert records. All queries are performed directly against the blockchain in real time. The tool only provides read-only information and does not execute any transactions. Health factors, liquidation thresholds, and alert levels are contract-defined values and do not guarantee actual risk levels. Always verify critical data independently through a block explorer and consult with financial advisors before making any protection decisions.