# DeFi Liquidation Explorer

> Recent Aave V3 liquidations in USD, who liquidated whom, and a live health-factor check. Reads Aave V3 LiquidationCall events from the official Pool contract over a recent block window (Ethereum, Base, Arbitrum, OP Mainnet, Polygon, Avalanche, BNB Chain), resolves token symbols and decimals on-chain, values each liquidation at current DefiLlama prices, ranks liquidators and borrowers, and checks any address's current health factor with getUserAccountData — so you can see how close a position is to liquidation.

Part of usefulweb.site (https://usefulweb.site/). Results are deterministic calculations from the inputs and the listed assumptions; the API returns exactly what the web page shows.

## Use it
- Human interface: https://defiliquidationexplorer.usefulweb.site/ (interactive tool at https://defiliquidationexplorer.usefulweb.site/tool)
- JSON API: POST https://defiliquidationexplorer.usefulweb.site/api/v1/calculate with a JSON object of inputs (schema: https://defiliquidationexplorer.usefulweb.site/api/v1/tool)
- OpenAPI: https://defiliquidationexplorer.usefulweb.site/openapi.json
- MCP (Streamable HTTP): https://defiliquidationexplorer.usefulweb.site/mcp - tool `defi_liquidation_explorer`

## Inputs
- mode (select): What do you have?
- chain (select): Aave V3 market
- blocks (integer): Blocks to scan back from the latest - Ethereum ≈ 12 s/block, Base/OP ≈ 2 s, Arbitrum ≈ 0.25 s. Public nodes cap log ranges; the window shrinks automatically if refused.
- user (text): Check a borrower's health factor (optional) - Without it, the most recently liquidated borrower is checked.
- logs (textarea): LiquidationCall logs JSON (offline)

## Method
- Events: LiquidationCall(address indexed collateralAsset, address indexed debtAsset, address indexed user, uint256 debtToCover, uint256 liquidatedCollateralAmount, address liquidator, bool receiveAToken) from the Aave V3 Pool of the chosen market (addresses from the bgd-labs aave-address-book), read with eth_getLogs over the last N blocks; if the node refuses the range it is halved (down to 100 blocks) and the shrink is reported.
- Tokens: symbol() and decimals() via eth_call. USD: current DefiLlama coins prices — today's value of the amounts, not the price at liquidation time.
- Implied bonus = collateral USD ÷ debt USD − 1 at current prices (approximate; Aave's liquidation bonus and protocol fee are reserve parameters).
- Health factor: Pool.getUserAccountData(user); collateral/debt in the market base currency (BASE_CURRENCY_UNIT read from the price oracle via ADDRESSES_PROVIDER); a health factor below 1 means the position can be liquidated now.