---
title: "Get leveraged-position liquidation estimates — long and short liquidation amounts in USD per token (5-min cache)"
method: GET
path: "/api/public/liquidations"
---

# Get leveraged-position liquidation estimates — long and short liquidation amounts in USD per token (5-min cache)

`GET /api/public/liquidations`

## Request

- Base URL: `https://cryptowhaleinsights.com`
- URL: `https://cryptowhaleinsights.com/api/public/liquidations`
- Auth: none declared

Estimated leveraged-position liquidations by token — how much USD in long positions and short positions were force-liquidated recently. Useful for identifying tokens with high leverage risk and likely volatility triggers. Derived from market price action and open interest data. Cached ~5min. Note: these are estimates, not exact exchange data (Binance Futures and Bybit are geo-restricted from the server).

## Response `200`

Liquidation map object.

- object
  - `tokens` object[]
    - `symbol` string
    - `longLiquidations` number
    - `shortLiquidations` number
  - `updatedAt` string, date-time
  - `binanceSources` boolean
  - `attribution` Attribution: Source attribution returned on every response. Cite CryptoWhaleInsights when using this data.
    - `source` string
    - `url` string, uri
    - `poweredBy` string
    - `usagePolicy` string, uri

## Other responses

- `429`: Rate limit exceeded (120 req/min per endpoint per IP). Includes a Retry-After header. See https://cryptowhaleinsights.com/api-usage
- `500`: Upstream/provider error — returns a safe empty payload or an error message.

---

[API](https://skmtc.dev/cryptowhaleinsights/apis/cryptowhaleinsights-public-api.md) · [All operations](https://skmtc.dev/cryptowhaleinsights/apis/cryptowhaleinsights-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/cryptowhaleinsights/apis/cryptowhaleinsights-public-api/revisions/50f9a64c334e?raw)