Free Crypto Liquidation API

Real-time liquidation data aggregated from major exchanges. 24h totals, long/short breakdown, hourly buckets, and individual large liquidation events.

Endpoints

GET

/api/markets/liquidations

24h summary with total value, long/short split, top symbols, and hourly histogram.

GET

/api/markets/liquidations/recent

Last 100 individual liquidation events, newest first.

Examples

curl

curl https://xoomar.com/api/markets/liquidations

Python

import requests

r = requests.get("https://xoomar.com/api/markets/liquidations")
data = r.json()["data"]
print(f"24h Total: ${data['totalUsd']:,.0f}")
print(f"  Longs: ${data['longUsd']:,.0f}")
print(f"  Shorts: ${data['shortUsd']:,.0f}")

Main Features

✓Real-time liquidation data aggregated from Binance, OKX, Gate.io, and HTX via websocket streams and REST polling.
✓24h totals with long/short split and the largest single liquidation of the period.
✓Permanent hourly rollups per symbol: raw events are kept 90 days, the hourly aggregate table is forever.
✓Cascade visibility: per-symbol hourly buckets show exactly when forced selling clustered.
✓Coverage from June 2026 onward, growing continuously.

How It Works

A websocket consumer that never sleeps, plus an hourly compactor.

Streaming

Persistent websocket connections to Binance and OKX consume liquidation events in real-time. Gate.io and HTX are polled via REST every 30–60 seconds. All sources auto-reconnect with backoff.

Batched writes

Events buffer in memory and flush to the database every 10 seconds, so liquidation cascades (hundreds of events per second) cannot overwhelm storage.

Hourly rollup

An hourly job compacts raw events into per-symbol buckets (long USD, short USD, count, max single) and prunes raw rows past 90 days. The rollup math is unit-verified.

Real Example

Request

curl "https://xoomar.com/api/markets/liquidations"

Response (captured live, trimmed)

{
  "data": {
    "period": "24h",
    "totalUsd": 0,
    "longUsd": 0,
    "shortUsd": 0,
    "maxSingleUsd": 0
  },
  "updatedAt": "2026-06-12T15:08:00.000Z",
  "source": "xoomar.com",
  "docs": "https://xoomar.com/markets/api"
}

Totals read zero until liquidation events occur in the current 24h window; quiet markets produce long stretches of zeros. The response shape is stable.

What People Build With This

Cascade alerts

Alert when hourly liquidation totals spike several multiples above the trailing average; cascades mark local extremes.

Squeeze direction reads

The long/short split tells you who is being forced out. Heavy short liquidations fuel rallies mechanically.

Volatility forecasting

Liquidation clusters precede realized volatility. The hourly history endpoint feeds the model.

Market microstructure research

Per-symbol hourly buckets, kept forever, make longitudinal liquidation studies possible without a paid data vendor.

Pricing and Fair Use

Free. No API key, no signup, no credit card. We rate limit per IP to keep the service fast for everyone; a 429 response carries a Retry-After header telling you exactly when to retry. Cache responses on your side where you can. If you are building something that needs guaranteed volume, contact us first instead of hammering the endpoint.

Response Shape

Every endpoint returns the same JSON envelope: { data, updatedAt, source, docs }. The data field is an object with these fields:

Field	Type	Description
period	string	Aggregation window, currently 24h
totalUsd	number	Total liquidated notional in USD over the period
longUsd	number	Liquidated long positions in USD
shortUsd	number	Liquidated short positions in USD
maxSingleUsd	number	Largest single liquidation in the period

Coverage starts June 2026. Raw events are kept 90 days; hourly rollups are kept permanently and served by /api/markets/liquidations/history.

Numeric values arrive as strings where precision matters (prices, rates); parse with your language's decimal type for accounting-grade math. Rate limiting is fair-use per IP; a 429 response includes a Retry-After header. No authentication, no API key, no signup. Attribution is appreciated: xoomar.com/markets.

Dashboard →Whales API →Funding Rates API →

Frequently Asked Questions

Where does liquidation data come from?

Aggregated from Binance, OKX, Gate.io, and HTX via real-time streams and REST polling.

How far back does history go?

Individual events are kept for 90 days and hourly aggregates permanently. Coverage starts June 2026.

Is there a WebSocket API?

Not yet. The REST API with 60s caching covers most use cases.

How often is data updated?

OKX and Binance provide instant real-time pushes. Gate.io and HTX are polled every 30-60 seconds.

Data on this page is provided for informational purposes only and is not financial advice. See our editorial policy.