rest api · v1

Liquidation data, straight from the engines.

Raw forced-closure events from 10 exchanges, minute aggregates and whale filters over a single REST endpoint. Start free — a key is issued instantly below. Paid plans are 40% off while we're young.

10
exchanges, one endpoint
0.4–2.8s
event-to-API latency
−40%
founding prices, locked forever

Endpoints

GET /api/v1/liquidationsRaw events. Filters: exchange, symbol, side, min_vol, from, to, limit (≤1000).
GET /api/v1/agg/1mMinute aggregates per symbol: long_usd, short_usd, count.
GET /api/v1/metaData depth, 24h per-exchange summary, your plan limits.

Latest liquidations

curl "https://stream.liquidations.dev/api/v1/liquidations?limit=5" \
  -H "X-API-Key: liq_…"

Whales only ($1M+)

curl "https://stream.liquidations.dev/api/v1/liquidations?min_vol=1000000&limit=3" \
  -H "X-API-Key: liq_…"

Minute aggregates

curl "https://stream.liquidations.dev/api/v1/agg/1m?symbol=BTCUSDT&limit=10" \
  -H "X-API-Key: liq_…"

Plans

founding −40% forever · until Feb 1, 2027

Free

api
$0forever
rate limit
10 req/min
history
24h history window
  • ·Raw liquidation events
  • ·Minute aggregates (1m)
  • ·All 10 exchanges
  • ·Community support

Start below — instant key.

Data

api
$17per month−40% founding

price locked forever · until Feb 1, 2027

rate limit
60 req/min
history
full history depth
  • ·Everything in Free
  • ·Full depth (growing daily)
  • ·Whale filters (min_vol)
  • ·Historical research access

Manual onboarding during early access: [email protected].

Stream

api
$47per month−40% founding

price locked forever · until Feb 1, 2027

rate limit
120 req/min
history
full history depth
  • ·Everything in Data
  • ·WebSocket stream included
  • ·Live terminal access
  • ·Priority support

Manual onboarding during early access: [email protected].

One-off dumps

Whole-history snapshots for backtesting and research — same events the API serves, packed into an archive you keep. No subscription.

Full dataset

dump
$59one-off−40% founding

price locked forever · until Feb 1, 2027

every exchange, entire stored history

zip · gzipped CSV per exchange + README

Private download link after payment — [email protected].

Single exchange

dump
$17one-off−40% founding

price locked forever · until Feb 1, 2027

one exchange of your choice, entire history

zip · gzipped CSV + README

Private download link after payment — [email protected].

Get a free key

One active free key per email. The key appears instantly — no signup forms, no waiting. Paid plans and dumps are onboarded manually during early access.

FAQ

+What is a liquidation event?

When an exchange force-closes a leveraged position at market price. Every record includes timestamp, exchange, symbol, side (long/short), price, quantity and USD volume.

+Which exchanges are covered?

Binance, Bybit, OKX, Bitget and Gate directly over WebSocket, plus Hyperliquid, Aster, Lighter and others via aggregation. Ten sources total.

+How fast is the data?

Direct WebSocket feeds land within 0.4–2.8 seconds of the forced closure. The free window is 24 hours; paid plans reach the full stored depth.

+What are the rate limits?

Free: 10 requests per minute with a 24h history window. Data: 60 rpm. Stream: 120 rpm. Business: 1200 rpm. Responses include error codes (401/403/429) with upgrade hints.

+Do you offer CSV dumps?

Yes — one-off dumps: full dataset ($59) or per exchange ($17), founding prices until Feb 1, 2027. You get a private download link to a zip with gzipped CSV per exchange plus a README. Ideal for backtesting.

+What is the founding discount?

Until February 1, 2027 every purchase is 40% off — and the price you buy at is locked for you forever, even after the discount ends.