v1

latestOpenAPI 3.0.02026-07-2224101.3 MB
BTC Market Data

Liquidations

Liquidations are sum of forced market orders to exit leveraged positions caused by price volatility. Liquidations indicate current price volatility and traders' sentiment which side they had been betting. Note that Binance's liquidation data collection policy has changed since 2021-04-27, which makes the distribution of the data has changed after that.

NameExchangeSymbolAvailable Since
All Exchangesall_exchangeall_symbolThe earliest time in the exchanges below.
Binancebinanceall_symbol <br/> btc_busd <br/> btc_usd <br/> btc_usdtThe earliest time in the symbols. <br/> 2019-11-20 00:00:00 <br/> 2020-08-14 00:00:00 <br/> 2021-01-15 00:00:00
Bitfinexbitfinexall_symbol <br/> btc_usdtThe earliest time in the symbols. <br/> 2019-09-18 00:00:00
Bitmexbitmexall_symbol <br/> btc_usdThe earliest time in the symbols. <br/> 2019-04-02 00:00:00
Bybitbybitall_symbol <br/> btc_usd <br/> btc_usdtThe earliest time in the symbols. <br/> 2020-12-20 00:00:00 <br/> 2020-12-18 00:00:00
Deribitderibitall_symbol <br/> btc_usdThe earliest time in the symbols. <br/> 2019-05-25 00:00:00
FTX**ftxall_symbol <br/> btc_usdThe earliest time in the symbols. <br/> 2019-08-04 00:00:00
Gate.iogate_ioall_symbol <br/> btc_usd <br/> btc_usdtThe earliest time in the symbols. <br/> 2018-12-20 16:00:00 <br/> 2019-11-18 17:00:00
HTX Globalhtx_globalall_symbol <br/> btc_usd <br/> btc_usdtThe earliest time in the symbols. <br/> 2020-06-26 00:00:00 <br/> 2021-09-23 12:00:00
OKXokxall_symbol <br/> btc_usd <br/> btc_usdtThe earliest time in the symbols. <br/> 2020-12-20 00:00:00 <br/> 2020-12-17 00:00:00

(**) Use in cautions due to the deprecation (no data update)

get/btc/market-data/liquidations

Query parameters

exchangestring required

A derivative exchange from the table that we support. See here.

symbolstring

A BTC pair symbol from the table that we support. See here

windowstring

Currently we support day, hour, and min.

fromstring

This defines the starting time for which data will be gathered, formatted as YYYYMMDDTHHMMSS (indicating YYYY-MM-DDTHH:MM:SS, UTC time). If window=day is used, it can also be formatted as YYYYMMDD (date). If window=block is used, you can also specify the exact block height (e.g. 510000). If this field is not specified, response will include data from the earliest time.

tostring

This defines the ending time for which data will be gathered, formatted as YYYYMMDDTHHMMSS (indicating YYYY-MM-DDTHH:MM:SS, UTC time). If window=day is used, it can also be formatted as YYYYMMDD (date). If window=block is used, you can also specify the exact block height (e.g. 510000). If this field is not specified, response will include data from the latest time.

limitinteger

The maximum number of entries to return before the latest data point (or before to if specified). This field ranges from 1 to 100,000.

formatstring

A format type about return message type. Supported formats are json, csv.

Response

Amount of long/short liquidations orders