# Crypto Liquidations Tracker > Crypto Liquidations Tracker is a paid API for AI agents from derivs.duoleads.com, paid per call via x402, $0.003/call, status unknown (last checked 2026-10-15). Returns aggregated and per-venue forced-liquidation data (counts, USD volumes, largest events) for a given crypto coin over a configurable look-back window across up to 8 derivatives exchanges. ## Facts - Endpoint: GET https://derivs.duoleads.com/v1/liquidations?utm_source=zero.xyz - Price: $0.003/call - Payment: x402 - Status: unknown - Last checked: 2026-10-15 - Activations on Zero: 0 - Tags: x402 - Canonical page: https://www.zero.xyz/c/crypto-liquidations-tracker-5226cddb - Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap__quT3vO70_qs2TQV7qG2M Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently. ## How to call it through Zero Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`): ```sh zero fetch --capability crypto-liquidations-tracker-5226cddb ``` Example prompt: Pull BTC liquidation data across all exchanges for the last 24 hours — I want to see total USD liquidated, the long vs short breakdown, and the biggest individual liquidation events. ## When to prefer this Use this endpoint when you need real-time or recent liquidation event data (counts, USD volumes, directional breakdown) for a specific crypto coin across multiple derivatives venues in one call. Prefer this over exchange-specific APIs when cross-venue aggregation and the largest-event list are needed. If you need open interest changes or funding rates instead of liquidations, use the sibling endpoints on the same platform. ## Known failure modes - Missing required 'coin' query parameter returns a validation error - Unknown or unsupported coin symbol may return empty venue data or an error - Hours value outside 1-24 range is rejected by schema validation - Some venues marked as 'partial' may have incomplete data for the requested window - Venues listed in venues_missing are not covered for the given coin - Network or exchange feed outages can cause stale=true flags on specific venues - Payment failure via x402/USDC on Base will block the request before data is returned ## How this service works Perp funding rates, open interest, futures basis, implied volatility, liquidations, order book depth and a perp screener for crypto perpetual futures across 8 exchanges (Bybit, Hyperliquid, dYdX, Gate, Kraken, Bitfinex, Deribit, OKX), paid per call over x402 with USDC on Base. No account, no API key. ## Output Returns a JSON object with a totals block (count, long_usd, short_usd, total_usd, long_share_pct, partial flag), a per-venue array (covered_hours, window_start, as_of, long_usd, short_usd, count, stale flag), a largest-liquidations list (side, time, price, venue, symbol, size_usd, size_coins), units metadata, and a list of venues not covered. Also includes a see_also pointer to the open-interest endpoint. ## Request schema (JSON Schema) ```json { "type": "object", "$schema": "https://json-schema.org/draft/2020-12/schema", "required": [ "input" ], "properties": { "input": { "type": "object", "required": [ "type", "method" ], "properties": { "type": { "type": "string", "const": "http" }, "method": { "enum": [ "GET" ], "type": "string" }, "queryParams": { "type": "object", "required": [ "coin" ], "properties": { "coin": { "type": "string", "maxLength": 32, "minLength": 1, "description": "Coin symbol: BTC, ETH, SOL ... (also BTCUSDT, BTC-PERP, XBT)." }, "hours": { "type": "string", "default": "24", "pattern": "^[0-9]{1,2}$", "description": "Look-back window in hours, 1-24. Default 24." } } } }, "additionalProperties": false }, "output": { "type": "object", "required": [ "type" ], "properties": { "type": { "type": "string" }, "example": { "type": "object" } } } } } ``` ## Response schema (JSON Schema) ```json { "type": "json", "example": { "coin": "BTC", "colo": null, "as_of": "2026-10-14T23:00:00Z", "hours": 24, "units": { "side": "the side of the position that was liquidated (long = forced sell)", "price": "USD per coin (execution or bankruptcy price as the venue publishes)", "times": "ISO 8601 UTC", "size_usd": "USD = size_coins x price", "size_coins": "coins", "covered_hours": "hours back from as_of that the venue's feed reaches (<= hours)" }, "totals": { "count": 141, "partial": true, "long_usd": 2039006.657, "short_usd": 38256.80723, "total_usd": 2077263.464, "long_share_pct": 98.1583, "partial_venues": [ "okx" ] }, "venues": [ { "as_of": "2026-10-14T23:00:00Z", "count": 29, "stale": false, "venue": "gate", "long_usd": 305655.3674, "short_usd": 34040.14805, "window_start": "2026-10-13T23:00:00Z", "covered_hours": 24 }, { "as_of": "2026-10-14T23:00:00Z", "count": 12, "stale": false, "venue": "bitfinex", "long_usd": 469920.1238, "short_usd": 0, "window_start": "2026-10-13T23:00:00Z", "covered_hours": 24 }, { "as_of": "2026-10-14T23:00:00Z", "count": 0, "stale": false, "venue": "dydx", "long_usd": 0, "short_usd": 0, "window_start": "2026-10-13T23:00:00Z", "covered_hours": 24 } ], "largest": [ { "side": "long", "time": "2026-10-14T21:03:30Z", "price": 81646.4, "venue": "okx", "symbol": "BTC-USDT-SWAP", "size_usd": 489878.4, "size_coins": 6 }, { "side": "long", "time": "2026-10-14T21:03:34Z", "price": 81630.8, "venue": "okx", "symbol": "BTC-USDT-SWAP", "size_usd": 169792.064, "size_coins": 2.08 } ], "see_also": { "params": [ "coin" ], "reason": "Open interest per venue with its 1 h / 4 h / 24 h change.", "endpoint": "https://derivs.duoleads.com/v1/open-interest" }, "disclaimer": "Data only, not investment advice, not a benchmark; not affiliated with any exchange", "request_id": "01KEXAMPLE0000000000000000", "venues_missing": [ { "venue": "bybit", "reason": "not_covered" }, { "venue": "hyperliquid", "reason": "not_covered" }, { "venue": "kraken", "reason": "not_covered" } ] } } ``` ## More - Live health (JSON, refreshed every minute): https://www.zero.xyz/c/crypto-liquidations-tracker-5226cddb/health.json - [Zero catalog index](https://www.zero.xyz/llms.txt) - [Other services from derivs.duoleads.com](https://www.zero.xyz/host/derivs.duoleads.com/llms.txt)