hist: Liquidation history

API: bitfinex.com:bitfinex
Endpoint: /liquidations/hist
Response format: application/json
Auth: none
Method: GET
Last Status: 200
Latency: 208ms

Description

Returns historical forced liquidation events including position details, symbol, price, and liquidation amount. Use this to analyze market stress periods and liquidation patterns.

From spec: Returns historical liquidation data.

Usage Tips

- Query params: limit (max 500), start/end timestamps for date range - Returns nested structure with position type, symbol, price - No symbol filter by default; use query params to filter - Data shows both position opens and closes

Parameters (4)

end (integer, query, optional)

End timestamp in milliseconds

limit (integer, query, optional)

Number of records (max 500)

Constraints: {'maximum': 500}

sort (integer, query, optional)

Sort order: +1 for ascending, -1 for descending

Constraints: {'enum': [-1, 1]}

start (integer, query, optional)

Start timestamp in milliseconds

Examples (1)

Get recent liquidation history probe-gate

Demonstrates fetching the 5 most recent forced liquidation events

curl 'https://api-pub.bitfinex.com/v2/liquidations/hist?limit=5'
import requests

resp = requests.get(
    "https://api-pub.bitfinex.com/v2/liquidations/hist",
    params={
        'limit': '5',
    },
)
data = resp.json()
import zingu_apis

api = zingu_apis.api("bitfinex")
result = api.fetch("liquidations/hist", limit=5)

for item in result:
    print(item)
const resp = await fetch("https://api-pub.bitfinex.com/v2/liquidations/hist?limit=5");
const data = await resp.json();

Probe History

Latency

Status Codes

TimeStatusLatencySize
2026-04-16 04:11:58.173747 200 208ms
2026-04-15 03:36:03.636555 200 199ms
2026-04-14 01:36:45.181752 200 197ms
2026-04-12 16:00:29.048611 200 182ms
2026-04-10 02:23:38.344801 200 244ms
2026-04-09 03:35:52.422014 200 182ms
2026-04-08 07:10:31.392351 200 190ms
2026-04-07 01:33:24.504956 200 198ms
2026-04-06 06:21:56.378923 200 208ms
2026-04-05 02:55:40.632247 200 172ms