DeFi Liquidation Tracker

Real-time on-chain liquidation events across Aave V3, Compound V3, and Spark Protocol. Track liquidator addresses, collateral seized, debt repaid, and USD value of every liquidation. Telegram alerts for whale-sized liquidations. No API key required.

---

What It Does

Liquidations are the single most actionable on-chain signal — they mark forced position closures during volatility spikes, expose stressed leverage, and reveal who the active MEV liquidators are. This Actor:

• Decodes Aave V3 LiquidationCall events from the mainnet Pool contract
• Decodes Compound V3 (Comet) AbsorbCollateral events across USDC/WETH/USDT markets
• Decodes Spark Protocol (Aave V3 fork) liquidations
• Resolves token symbols + USD prices via Coingecko
• Returns the liquidator address (= MEV bot), borrower, collateral seized, debt repaid, USD valuation, Etherscan link
• Sends Telegram alerts for liquidations above a configurable USD threshold

---

Why This Matters

• Whale liquidation = market-moving event. A $1M+ liquidation on Aave often precedes a sharp wick down as keeper bots dump seized collateral. This Actor surfaces those in real time.
• MEV bot leaderboard. The same handful of addresses absorb most liquidations. Watching their P&L is a direct signal of how lucrative liquidations are right now (= leverage stress).
• Health-factor scanner cross-reference. Pair this with liquidationCall history to backtest your own position safety margins.

---

Input

Field	Type	Default	Description
includeAaveV3	boolean	true	Include Aave V3 mainnet liquidations
includeCompoundV3	boolean	true	Include Compound V3 (USDC/WETH/USDT markets)
includeSpark	boolean	true	Include Spark Protocol
lookbackBlocks	integer	7200	Blocks to scan (~24h on Ethereum)
minLiquidationUsd	integer	1000	Filter out small liquidations
sortBy	string	usd_desc	usd_desc, block_desc, block_asc
limit	integer	100	Max events
alertUsd	integer	0	Telegram alert threshold ($). 0 = disabled
telegramBotToken	string (secret)	—	Bot token for alerts
telegramChatId	string	—	Chat ID

Example: Last 24h whale liquidations

{"lookbackBlocks": 7200, "minLiquidationUsd": 100000, "sortBy": "usd_desc", "limit": 20}

Example: Live monitor with $500K alerts

{
  "lookbackBlocks": 600,
  "minLiquidationUsd": 50000,
  "alertUsd": 500000,
  "telegramBotToken": "...",
  "telegramChatId": "..."
}

---

Output

{
  "protocol": "Aave V3",
  "block_number": 19847221,
  "tx_hash": "0xabc...",
  "timestamp": "2026-06-03T11:42:00+00:00",
  "user": "0xborrower...",
  "liquidator": "0xliquidatorbot...",
  "collateral_asset": "0xae78736cd615f374d3085123a210448e74fc6393",
  "collateral_symbol": "rETH",
  "collateral_amount": 142.3,
  "collateral_price_usd": 3920.50,
  "debt_asset": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
  "debt_symbol": "USDC",
  "debt_amount": 540000.0,
  "debt_price_usd": 1.0,
  "liquidation_usd": 558087.15,
  "etherscan_url": "https://etherscan.io/tx/0xabc..."
}

---

Pricing

• $0.005 per liquidation event returned

Examples:

• Last 24h, ≥ $10K: ~$0.50 - $2.00 (volatility-dependent)
• Scheduled hourly monitor with $50K floor: ~$10-50/month

---

Use Cases

Risk management — Set Telegram alerts for $1M+ liquidations on assets you hold:

{"alertUsd": 1000000, "telegramBotToken": "...", "telegramChatId": "..."}

MEV liquidator P&L tracking — Aggregate liquidator field to see who is absorbing the most:

curl -X POST "https://api.apify.com/v2/acts/gochujang~defi-liquidation-tracker/runs?token=YOUR_TOKEN" \
  -d '{"lookbackBlocks": 50000, "minLiquidationUsd": 0, "limit": 1000}'

Volatility post-mortem — After a flash crash, pull every liquidation in the impacted window to reconstruct the cascade.

---

Data Sources

• Etherscan logs API (module=logs&action=getLogs) — free, shared API key bundled
• Coingecko for token USD pricing
• Aave V3 Pool: 0x87870Bca3F3fD6335C3F4ce8392D69350B4fA4E2
• Compound V3 Comet markets (USDC, WETH, USDT)
• Spark Pool: 0xC13e21B648A5Ee794902342038FF3aDAB66BE987

---

Related Actors

• Smart Money Wallet Tracker — Cross-reference liquidator wallets against known whale list.
• Hyperliquid Whale Tracker — On-chain perp leverage stress signal.
• Stablecoin Depeg Monitor — Liquidations spike when stablecoin pegs slip.

---

---

🎬 Live Sample Run

A real run of this actor with default-ish inputs, executed on 2026-06-10:

Field	Value
Items in dataset	1
Dataset (JSON)	https://api.apify.com/v2/datasets/veXzNHngKOhcLqBrL/items?clean=1&format=json
Dataset (CSV)	https://api.apify.com/v2/datasets/veXzNHngKOhcLqBrL/items?clean=1&format=csv
Run summary (KVS)	https://api.apify.com/v2/key-value-stores/2UMWO9X1l0ATEVfjB/records/SUMMARY
Run details	https://api.apify.com/v2/actor-runs/EcKyYEQmdjnDNfOkY

Try it now: pop any of the dataset URLs in your browser to see live output, or hit the API endpoints from your code.

Want to reproduce? Click Try Actor on the Apify Store page and use the input defaults shown above.

Feedback

Leave a review on Apify Store