Collateral Ratio Monitor

WHAT IT DOES

Collateral Ratio Monitor gives DeFi users, liquidators, and risk managers real-time insight into collateral positions and liquidation risk. It reads live on-chain data including collateral ratio state, user positions, collateral balances, debt balances, liquidation thresholds, health factors, and price feed data. You can monitor any user's position to see their current collateral ratio, debt amount, health factor, and risk level. The tool shows you in real time whether a position is healthy, approaching liquidation, or at immediate risk—so you can take action before getting liquidated.

HOW TO USE

Connect your EVM wallet (optional—the tool can work in read-only mode). Enter the lending contract address, user address (defaults to your wallet), collateral token address, and debt token address. Click "Monitor collateral ratio" to fetch current data from the chain. The tool displays the user's collateral balance, debt balance, current ratio, minimum ratio required, liquidation threshold, health factor, and risk level (Low/Medium/High). A visual dashboard shows the ratio compared to the minimum requirement and health factor status. All data is read directly from the contract—no assumptions or simulations.

TECHNICAL APPROACH

This tool queries live contract state using ethers v5.7.2. It calls getPositionData() on the lending contract to fetch collateral, debt, and health factor in a single call, falling back to individual getCollateralAmount(), getDebtAmount(), and getHealthFactor() calls if needed. It reads getMinCollateralRatio() and getLiquidationThreshold() to get protocol parameters. Token decimals are read from the token contracts to format amounts correctly. The tool calculates the current ratio as (collateral / debt) * 100 and compares it to the minimum ratio. Health factor is displayed with color-coded risk indicators. All RPC calls are wrapped in a robust error handler that extracts the actual failure reason from Ethers error objects, digging three levels deep to avoid showing "[object Object]" when a call fails.

WHAT IT CANNOT SEE

This tool cannot predict future price movements or guarantee that monitored ratios will prevent liquidation in all scenarios. It cannot account for price fluctuations that occur between reads. It cannot simulate stress tests or determine the exact price drop that would cause liquidation. It cannot see pending transactions that might affect the position. It cannot detect off-chain factors that might impact collateral value. The tool provides current state monitoring, but it does not guarantee that a position will remain safe.

PLEASE NOTE

This tool supports EVM‑compatible chains only (Ethereum, Goerli, Sepolia, Arbitrum, Optimism, Polygon). Solana, Tron, Starknet, SUI, TON, Aptos, Bitcoin, Cosmos, and XRP are not supported. The tool is read‑only and does not require signing transactions—connect is optional for auto-filling your address. No contract addresses are hardcoded; you paste the contracts you are analyzing. The tool is free and open under the BotGentz PLAYBOOK‑C specification.