# DeFi Liquidation Tracker — Aave Compound Maker Live Events (`gochujang/defi-liquidation-tracker`) Actor Live liquidation events across Aave V2/V3, Compound V2/V3, MakerDAO. Liquidator, debt amount, collateral seized, USD value. Detect market stress + alpha on which oracle was wrong. PPE $0.005/liquidation. - **URL**: https://apify.com/gochujang/defi-liquidation-tracker.md - **Developed by:** [Hojun Lee](https://apify.com/gochujang) (community) - **Categories:** Developer tools, Automation, Other - **Stats:** 3 total users, 1 monthly users, 100.0% runs succeeded, NaN bookmarks - **User rating**: No ratings yet ## Pricing Pay per usage This Actor is paid per platform usage. The Actor is free to use, and you only pay for the Apify platform usage, which gets cheaper the higher subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-usage ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## 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 ```json {"lookbackBlocks": 7200, "minLiquidationUsd": 100000, "sortBy": "usd_desc", "limit": 20} ```` #### Example: Live monitor with $500K alerts ```json { "lookbackBlocks": 600, "minLiquidationUsd": 50000, "alertUsd": 500000, "telegramBotToken": "...", "telegramChatId": "..." } ``` *** ### Output ```json { "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: ```json {"alertUsd": 1000000, "telegramBotToken": "...", "telegramChatId": "..."} ``` **MEV liquidator P\&L tracking** — Aggregate `liquidator` field to see who is absorbing the most: ```bash 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](https://apify.com/gochujang/smart-money-tracker)** — Cross-reference liquidator wallets against known whale list. - **[Hyperliquid Whale Tracker](https://apify.com/gochujang/hyperliquid-whale-tracker)** — On-chain perp leverage stress signal. - **[Stablecoin Depeg Monitor](https://apify.com/gochujang/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](https://apify.com/gochujang/defi-liquidation-tracker#reviews) # Actor input Schema ## `includeAaveV3` (type: `boolean`): Include Aave V3 LiquidationCall events from the mainnet Pool contract. ## `includeCompoundV3` (type: `boolean`): Include Compound V3 (Comet) AbsorbCollateral events. ## `includeSpark` (type: `boolean`): Include Spark Lending (Aave V3 fork) LiquidationCall events. ## `lookbackBlocks` (type: `integer`): How many recent blocks to scan (1 block ≈ 12s on Ethereum). 7200 = ~24h. ## `minLiquidationUsd` (type: `integer`): Skip liquidations below this USD value (uses Coingecko prices for valuation). ## `sortBy` (type: `string`): Sort order for the returned liquidation events. ## `limit` (type: `integer`): Maximum number of liquidation events to return. ## `alertUsd` (type: `integer`): Send Telegram alert for liquidations above this USD value. 0 = disabled. Requires bot token + chat ID. ## `telegramBotToken` (type: `string`): Telegram bot token for large-liquidation alerts. ## `telegramChatId` (type: `string`): Chat ID to receive alerts. ## `etherscanApiKey` (type: `string`): Bring your own Etherscan V2 API key for higher rate limits (recommended for scheduled use). Free at etherscan.io/myapikey. ## Actor input object example ```json { "includeAaveV3": true, "includeCompoundV3": true, "includeSpark": true, "lookbackBlocks": 7200, "minLiquidationUsd": 1000, "sortBy": "usd_desc", "limit": 100, "alertUsd": 0, "telegramChatId": "" } ``` # Actor output Schema ## `dataset` (type: `string`): No description ## `summary` (type: `string`): No description # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = {}; // Run the Actor and wait for it to finish const run = await client.actor("gochujang/defi-liquidation-tracker").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = {} # Run the Actor and wait for it to finish run = client.actor("gochujang/defi-liquidation-tracker").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{}' | apify call gochujang/defi-liquidation-tracker --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=gochujang/defi-liquidation-tracker", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "DeFi Liquidation Tracker — Aave Compound Maker Live Events", "description": "Live liquidation events across Aave V2/V3, Compound V2/V3, MakerDAO. Liquidator, debt amount, collateral seized, USD value. Detect market stress + alpha on which oracle was wrong. PPE $0.005/liquidation.", "version": "0.1", "x-build-id": "iZ8lN4OOKJ5GRfITu" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/gochujang~defi-liquidation-tracker/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-gochujang-defi-liquidation-tracker", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/gochujang~defi-liquidation-tracker/runs": { "post": { "operationId": "runs-sync-gochujang-defi-liquidation-tracker", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/gochujang~defi-liquidation-tracker/run-sync": { "post": { "operationId": "run-sync-gochujang-defi-liquidation-tracker", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "properties": { "includeAaveV3": { "title": "Include Aave V3", "type": "boolean", "description": "Include Aave V3 LiquidationCall events from the mainnet Pool contract.", "default": true }, "includeCompoundV3": { "title": "Include Compound V3", "type": "boolean", "description": "Include Compound V3 (Comet) AbsorbCollateral events.", "default": true }, "includeSpark": { "title": "Include Spark Protocol", "type": "boolean", "description": "Include Spark Lending (Aave V3 fork) LiquidationCall events.", "default": true }, "lookbackBlocks": { "title": "Lookback Blocks", "minimum": 100, "maximum": 50000, "type": "integer", "description": "How many recent blocks to scan (1 block ≈ 12s on Ethereum). 7200 = ~24h.", "default": 7200 }, "minLiquidationUsd": { "title": "Minimum Liquidation USD", "minimum": 0, "type": "integer", "description": "Skip liquidations below this USD value (uses Coingecko prices for valuation).", "default": 1000 }, "sortBy": { "title": "Sort By", "enum": [ "usd_desc", "block_desc", "block_asc" ], "type": "string", "description": "Sort order for the returned liquidation events.", "default": "usd_desc" }, "limit": { "title": "Max Events", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Maximum number of liquidation events to return.", "default": 100 }, "alertUsd": { "title": "Telegram Alert USD Threshold", "minimum": 0, "type": "integer", "description": "Send Telegram alert for liquidations above this USD value. 0 = disabled. Requires bot token + chat ID.", "default": 0 }, "telegramBotToken": { "title": "Telegram Bot Token", "type": "string", "description": "Telegram bot token for large-liquidation alerts." }, "telegramChatId": { "title": "Telegram Chat ID", "type": "string", "description": "Chat ID to receive alerts.", "default": "" }, "etherscanApiKey": { "title": "Etherscan API key (optional)", "type": "string", "description": "Bring your own Etherscan V2 API key for higher rate limits (recommended for scheduled use). Free at etherscan.io/myapikey." } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```