Liquidation History

Historical liquidation long/short USD totals bucketed by date and exchange. Returns a chronological series of daily (or hourly, for the 1d range) liquidation volumes broken down per venue. Use it to chart long-term liquidation trends, identify historically heavy deleveraging days, or correlate liquidation spikes with price movements.

Authentication

Requires Dev tier or higher. Dev: maximum 7 days (range=7d). Pro: up to 90 days. Requests exceeding your tier's limit are clamped and a notice is included in the response.

Parameters

Tier behavior

• Dev: Maximum 7 days. Requests for 30d or 90d are clamped to 7d; a notice is included in the response.
• Pro: Full 90-day history.

Example request

curl -H "X-Api-Key: lk_live_your_key_here" \
  "https://api.loris.tools/liquidations/history?range=7d"

Example response

{
  "data": [
    {
      "date": "2026-06-01T00:00:00Z",
      "exchanges": {
        "binance": { "long_usd": 145000000, "short_usd": 62000000 },
        "bybit": { "long_usd": 87000000, "short_usd": 31000000 }
      }
    },
    {
      "date": "2026-06-02T00:00:00Z",
      "exchanges": {
        "binance": { "long_usd": 98000000, "short_usd": 44000000 },
        "bybit": { "long_usd": 72000000, "short_usd": 28000000 }
      }
    }
  ]
}

Errors

• 400 — Invalid range value. Accepted: 1d, 7d, 30d, 90d.

For authentication errors (401) and rate limit responses (429), see Errors.