v1

latestOpenAPI 3.0.32026-08-04850206.9 KB
Liquidations

Hourly liquidations

Hourly long/short USD totals over the raw feed. Because the raw feed is pruned at ~48h, hours is capped at 48. Source coverage is currently OKX swap markets.

get/api/v1/liquidations/hourly

Query parameters

hoursinteger nullable

Look-back window in hours (1–48, default 24).

Example:24

Look-back window in hours (1–48, default 24).

Response

Example response

{
  "data": [
    {
      "hour": "2026-07-03T08:00:00+00:00",
      "liquidations": 112,
      "total_usd": 1834567.21,
      "long_usd": 1034567.11,
      "short_usd": 800000.1
    }
  ],
  "meta": {
    "hours": 24,
    "note": "Source coverage: OKX swap markets."
  }
}