---
title: "Live Hyperliquid liquidation feed (rolling 24h) with 1h/4h/24h totals and long/short split. Public and rate-limited; a sample recovered from liquidation counterparties, coverage stated. Query: coins, coin, side, minNotional, since, limit, fields."
method: GET
path: "/api/liquidations"
---

# Live Hyperliquid liquidation feed (rolling 24h) with 1h/4h/24h totals and long/short split. Public and rate-limited; a sample recovered from liquidation counterparties, coverage stated. Query: coins, coin, side, minNotional, since, limit, fields.

`GET /api/liquidations`

## Request

- Base URL: `https://tapeperp.com`
- URL: `https://tapeperp.com/api/liquidations`
- Auth: one of:
  - API key in header `X-API-Key`
  - API key in query parameter `api_key`

Hyperliquid publishes no global liquidation stream; events are recovered from the fills of dynamically-discovered liquidation counterparties, so this is a representative sample, not an exhaustive record. Side reported is the side that was LIQUIDATED (a liquidated long is a forced sell). Terms: https://tapeperp.com/disclosures

## Query parameters

- `coin` string
- `since` string
- `min_notional` number
- `side` 'long' | 'short'
- `limit` integer

## Response `200`

Liquidation events, rolling stats and coverage note

## Other responses

- `401`: Missing or invalid API key
- `404`: Feature not enabled on this deployment
- `503`: No API keys provisioned

---

[API](https://skmtc.dev/tapeperp/apis/tape-hyperliquid-analytics-api.md) · [All operations](https://skmtc.dev/tapeperp/apis/tape-hyperliquid-analytics-api/llms.txt) · [OpenAPI document](https://skmtc.dev/tapeperp/apis/tape-hyperliquid-analytics-api/revisions/5f86c44f9a91?raw)