Liquidations Data
Liquidation data contains the forced closures of leveraged positions that do not have sufficient margin. The data comes from the public feed of each exchange. Some venues sample that feed. Thus, the data is not a full record of all liquidations.
Download Liquidations Data
Download the hourly liquidation data files for futures trading pairs.
GET
https://api.cryptohftdata.com/v1/downloadExample: Download BTCUSDT Liquidations
Terminal
curl "https://api.cryptohftdata.com/v1/download?file=binance_futures/2025-08-01/20/BTCUSDT_liquidations.parquet&api_key=your-api-key-here" \
-o BTCUSDT_liquidations_20.parquetVenue-specific semantics
- Binance Futures, Aster: The liquidation stream of the exchange (
forceOrder) sends at most one liquidation snapshot per symbol per second. This is the latest liquidation in each 1,000 ms window. The rows are a subset that the exchange samples, and they do not include every liquidation. Thus, counts and totals are a lower limit. - Bybit, OKX:
priceandaverage_priceboth contain the bankruptcy price that the exchange publishes. This is not an execution price.order_type,time_in_forceandorder_statusare fixed placeholders, and they do not show the execution status.filled_quantityis equal toquantity. - OKX: OKX can send liquidations hours late (we saw delays of up to about 4 hours, and the cause is on the exchange side). We put each row in the file for its arrival hour (
received_time). Thus, a liquidation can be in the file of an hour that is later than itsevent_time. Load some hours after the end of your window, and filter onevent_time. Sizes are in contracts (multiply byctVal). - BitMEX: About 95 % of liquidations occur two times, about 5 seconds apart.
event_timeandtrade_timeare in nanoseconds, not in milliseconds. Remove the duplicates, and change the timestamps to the correct unit. We plan a correction of the published history. Quantities are in raw units that are different for each instrument. - Binance Futures: Before the 2026-09 data-integrity release, COIN-M contracts (for example,
BTCUSD_PERP,BTCUSD_260925) and delisted USDⓈ-M symbols also appeared underbinance_futuresin ticker, mark price and liquidation files. For COIN-M, the volumes and quantities in these files are in contracts. From the release, we do not publish these symbols there. If you need only listed USDⓈ-M markets, filter them out of older history.
For missing hours, partial periods and pending corrections to published history, refer to Known Gaps & Corrections.
Futures Only
Liquidation data is available only for futures/derivatives exchanges.