GET /v1/liquidations

Retrieve forced liquidation events from Binance Futures.

Min Tier: Free | Credits: 25 base + 2 per row returned

Parameters

Parameter	Type	Required	Default	Description
`api-key`	string	Yes	—	Your API key.
`symbol`	string	Yes	—	Asset symbol (e.g. `BTC`, `ETH`).
`start`	string	No	—	ISO 8601 start time (inclusive).
`end`	string	No	—	ISO 8601 end time (exclusive).
`side`	string	No	`all`	Filter by liquidation side. One of `long`, `short`, `all`.
`min_usd`	number	No	—	Minimum USD value filter. Only return liquidations above this threshold. Requires Business tier.
`limit`	integer	No	100	Number of rows to return. Range: 1–1000.
`after`	string	No	—	Cursor for pagination. Pass `meta.next_cursor` from a previous response.

Response

Field	Type	Description	Sources
`timestamp`	string	ISO 8601 liquidation time.	Binance Futures
`symbol`	string	Asset symbol.	Binance Futures
`source`	string	Always `binance_futures`.	Binance Futures
`side`	string	`long` or `short` — the side that was liquidated.	Binance Futures
`quantity`	number	Liquidated quantity in the base asset.	Binance Futures
`price`	number	Bankruptcy price that triggered the liquidation.	Binance Futures
`avg_price`	number	Average fill price of the liquidation order.	Binance Futures
`usd_value`	number	Total USD value of the liquidation (`quantity × avg_price`).	Binance Futures

Response Headers

Header	Description
`X-Credits-Used`	Credits consumed by this request.
`X-Credits-Remaining`	Credits remaining in your billing cycle.
`X-Rows-Returned`	Number of liquidation events in the response.
`X-Rows-Capped`	`true` if the result set was truncated by your plan's row limit.

Example

cURL

curl "https://kwery-api.com/v1/liquidations?api-key=YOUR_KEY&symbol=BTC&start=2026-03-08T00:00:00Z&end=2026-03-09T00:00:00Z&side=long&limit=5"

Python

import requests

resp = requests.get("https://kwery-api.com/v1/liquidations", params={
    "api-key": "YOUR_KEY",
    "symbol": "BTC",
    "start": "2026-03-08T00:00:00Z",
    "end": "2026-03-09T00:00:00Z",
    "side": "long",
    "limit": 5,
})
data = resp.json()

TypeScript

const params = new URLSearchParams({
  "api-key": "YOUR_KEY",
  "symbol": "BTC",
  "start": "2026-03-08T00:00:00Z",
  "end": "2026-03-09T00:00:00Z",
  "side": "long",
  "limit": "5",
});
const res = await fetch(`https://kwery-api.com/v1/liquidations?${params}`);
const data = await res.json();

Example Response

{
  "data": [
    {
      "timestamp": "2026-03-08T03:14:22.431Z",
      "symbol": "BTC",
      "source": "binance_futures",
      "side": "long",
      "quantity": 0.284,
      "price": 92150.00,
      "avg_price": 92145.30,
      "usd_value": 26169.27
    },
    {
      "timestamp": "2026-03-08T03:14:22.891Z",
      "symbol": "BTC",
      "source": "binance_futures",
      "side": "long",
      "quantity": 1.520,
      "price": 92140.00,
      "avg_price": 92138.50,
      "usd_value": 140050.52
    },
    {
      "timestamp": "2026-03-08T03:14:23.102Z",
      "symbol": "BTC",
      "source": "binance_futures",
      "side": "long",
      "quantity": 0.073,
      "price": 92135.00,
      "avg_price": 92130.80,
      "usd_value": 6725.55
    }
  ],
  "meta": {
    "symbol": "BTC",
    "source": "binance_futures",
    "returned": 5,
    "next_cursor": "eyJ0IjoiMjAyNi0wMy0wOFQwNDoxMjowMy40NTZaIn0",
    "has_more": true
  }
}

Tier Access

Plan	History Depth	`min_usd` Filter
Free	1 day	No
Pro	30 days	No
Business	Full history	Yes

Errors

Status	Code	When
400	`invalid_symbol`	The `symbol` parameter is missing or not recognized.
400	`invalid_side`	The `side` parameter is not one of `long`, `short`, `all`.
400	`invalid_time_range`	`start` is after `end`, or the range exceeds your plan's history depth.
401	`unauthorized`	Missing or invalid `api-key`.
403	`tier_restricted`	Your plan does not support the requested feature (e.g. `min_usd` on Pro).
429	`rate_limited`	You have exceeded your plan's request rate. Retry after the `Retry-After` header value.