{"uid":"cap_jhrGNVat0evMYUob6e4-n","slug":"bykaranteli-largest-liquidations-history-3672a12b","name":"ByKaranteli Largest Liquidations History","description":"Per-day ranking of the largest single liquidation prints across Binance, Bybit, OKX, Gate, HTX, dYdX, Aster, Lighter, Kraken Futures and GMX: up to 100 ranks per finalized UTC day since 2026-08-29, with symbol, venue, side (SELL = a long was liquidated), price, quantity, notional and millisecond event time, filterable by symbol and venue. The free CSV carries the top 10 per day; the free page and API rank only the last 24 hours to 30 days.","url":"https://bykaranteli.com/api/x402/liquidation-leaderboard-history?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"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","properties":{"to":{"type":"string","description":"date, optional"},"from":{"type":"string","description":"date, optional, default 30 days ago"},"limit":{"type":"number","description":"number, optional, max 10000"},"symbol":{"type":"string","description":"string, optional"},"exchange":{"type":"string","description":"string, optional"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.1","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.1/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.1","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.1","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_nncEa1bSPZqbphp86FoBm","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.1","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns a per-day ranking of the largest single liquidation events across major crypto futures venues, filterable by symbol and exchange, with up to 100 ranks per UTC day since 2026-08-29.","exampleAgentPrompt":"Pull the top 20 largest single liquidation events on BTCUSDT across all venues from January 1 to January 31, 2027, ranked by notional value — I want to see which exchange, side, price, and quantity each one was.","exampleUseCases":[{"title":"BTC crash liquidation postmortem","prompt":"Show me the 50 biggest BTCUSDT liquidation prints across Binance, Bybit and OKX during the last major crash — pull the daily leaderboard for the past 30 days and sort by notional so I can see which venues got hit hardest."},{"title":"Identify largest ETH long squeezes","prompt":"What were the top 10 largest ETH long liquidation events (side = SELL) on Bybit over the past two weeks? I want the price, quantity, notional, and exact timestamp for each."},{"title":"Cross-venue liquidation comparison","prompt":"Compare the biggest daily liquidation events on GMX versus dYdX for the month of September 2027 — give me up to 100 ranks per day so I can see which decentralized venue sees more extreme liquidation prints."}],"resultDescription":"An ordered list of the largest single liquidation events per UTC day, each record containing: rank, symbol, venue/exchange name, side (SELL for long liquidated, BUY for short liquidated), fill price, quantity, notional USD value, and millisecond-precision event timestamp. Up to 100 ranks per finalized day; the free tier returns only top 10 per day and covers the last 24 hours to 30 days.","failureModes":["Invalid or future date range returns empty results or error","Unsupported symbol or exchange name returns empty dataset","Requesting data before 2026-08-29 returns no results (coverage start date)","Limit exceeding 10000 may be rejected or capped","Missing payment (x402) returns 402 Payment Required"],"whenToPreferThis":"Choose this endpoint when you need historical, day-level rankings of the single largest liquidation prints across multi-venue crypto futures markets. It is uniquely suited for postmortems of market crashes, identifying which venues experience the most extreme liquidation events, and building leaderboard-style analytics. It covers 10 major venues including both CEX (Binance, Bybit, OKX, Gate, HTX, Kraken Futures) and DEX (dYdX, GMX, Aster, Lighter). Use the raw liquidation events sibling endpoint instead if you need every individual liquidation rather than the daily top-N ranking.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-21T18:30:20.593Z","isFirstParty":false,"canonicalSlug":"bykaranteli-largest-liquidations-history-3672a12b"}