# ByKaranteli Largest Liquidations History

> ByKaranteli Largest Liquidations History is a paid API for AI agents from bykaranteli.com, paid per call via x402, $0.1/call, status unknown (last checked 2026-11-15).

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.

## Facts

- Endpoint: GET https://bykaranteli.com/api/x402/liquidation-leaderboard-history?utm_source=zero.xyz
- Price: $0.1/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/bykaranteli-largest-liquidations-history-3672a12b
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_jhrGNVat0evMYUob6e4-n

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 bykaranteli-largest-liquidations-history-3672a12b
```

Example prompt: 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.

## When to prefer this

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.

## Known failure modes

- 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

## How this service works

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.

## Output

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.

## 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",
     "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"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/bykaranteli-largest-liquidations-history-3672a12b/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from bykaranteli.com](https://www.zero.xyz/host/bykaranteli.com/llms.txt)
