DeFi Liquidation Risk Checker (Aave V3)

On-demand health factor + collateral / debt / LTV for any wallet's Aave V3 positions across Ethereum, Arbitrum, Base, Optimism, Polygon, Avalanche. Direct on-chain via Etherscan eth_call. No API key required.

---

Why this exists

If you have leveraged positions on Aave, you need to know your health factor. A position with HF < 1.0 will be liquidated, costing you the liquidation penalty (5-10% of debt).

Aave's own UI requires you to connect a wallet to check positions. Third-party tools (DeFi Saver, Instadapp) require sign-up or stake.

This actor takes any wallet address and reports HF + collateral + debt for every Aave V3 market in one run, with optional Telegram alerts when HF drops below your threshold.

---

What you get

Per-chain row

Field	Example	Notes
chain	ethereum
risk_level	critical	liquidatable / critical / warning / watch / healthy / no-debt
health_factor	1.18	< 1.0 = liquidatable
total_collateral_usd	120,500.50
total_debt_usd	85,300.00
ltv_pct	70.84	current LTV
liquidation_threshold_pct	77.50	LT for this combination of collateral
available_borrows_usd	7,420.00	how much more you can borrow

Risk levels

Level	Health Factor
🔴 liquidatable	< 1.00
🟠 critical	1.00 – 1.20
🟡 warning	1.20 – 1.50
🟢 watch	1.50 – 2.00
✅ healthy	> 2.00
⚪ no-debt	no active debt

Summary row

Aggregates across all chains: total debt, total collateral, worst HF, worst chain.

---

Quick start

Check a wallet across all 6 Aave V3 markets

{
  "walletAddress": "0x47ac0Fb4F2D84898e4D9E7b4DaB3C24507a6D503"
}

Check only Ethereum + Arbitrum

{
  "walletAddress": "0x...",
  "chains": ["ethereum", "arbitrum"]
}

Alert when HF drops below 1.5

{
  "walletAddress": "0x...",
  "alertHealthFactorBelow": 1.5,
  "telegramBotToken": "YOUR_BOT_TOKEN",
  "telegramChatId": "YOUR_CHAT_ID"
}

Schedule every 15 minutes during volatile markets

Configure Apify schedule → cron */15 * * * * → input with alertHealthFactorBelow: 1.3. Sleeps until next 15-min boundary, costs $0.02 per check ($1.92/day for round-the-clock monitoring).

---

Pricing

Pay-Per-Event: $0.02 per wallet checked.

Flat fee regardless of how many chains you query. Vs:

• DeFi Saver: free dashboard, paid automation ($2-5 / tx)
• Instadapp DSA: gas + deposit required
• Hypernative: $99-$2000/mo

---

Risk explanation

Aave V3's health factor is calculated as:

HF = Σ(collateral_i × liquidationThreshold_i) / Σ(debt_j)

When HF drops to 1.0 or below, liquidators can repay your debt and seize collateral at a 5-10% discount.

Common triggers for HF drop:

1. Collateral price drops — e.g. ETH drops 20%, your wstETH collateral worth drops
2. Borrowed asset price rises — e.g. you borrowed USDC and ETH dumps, your debt value in ETH rises
3. Rates compounding — variable rate debt accrues interest

This actor takes a snapshot at the moment of the call. For continuous monitoring, schedule it.

---

Supported markets

All canonical Aave V3 deployments:

• Ethereum mainnet (Pool: 0x8787...4fA4E2)
• Arbitrum (Pool: 0x794a...4814aD)
• Optimism (Pool: same)
• Base (Pool: 0xA238...8d1c5)
• Polygon (Pool: same as Arb/Op)
• Avalanche C-Chain (Pool: same as Arb/Op)

Other markets (BNB, Metis, Gnosis, Scroll, ZkSync) coming if there's demand.

---

Limitations

• Aave V3 only. Compound V3, Morpho, Spark, Maker — not yet covered (v0.2).
• No isolation-mode logic. HF returned by the contract already accounts for it, but per-asset detail is not exposed.
• Etherscan free-tier rate limits. Default Etherscan V2 key is shared and rate-limited to 5 req/s. Pass your own etherscanApiKey for production use.

---

Related actors (same author)

• Wallet PnL Analyzer — Full token portfolio for the same wallet
• DeFi Liquidation Tracker — Track liquidation events across protocols
• Lending Rate Tracker — Current borrow APYs
• LST Health Tracker — If you collateralize wstETH/rETH

---

Feedback

A short review helps DeFi power users find it: Leave a review on Apify Store