---
title: "Observed liquidation-level buckets for one market (BTC, ETH, SOL, HYPE). Public and rate-limited. Query: coin, tf (12h|24h|3d|7d), format=concise for the densest levels only."
method: GET
path: "/api/liquidations/heatmap"
---

# Observed liquidation-level buckets for one market (BTC, ETH, SOL, HYPE). Public and rate-limited. Query: coin, tf (12h|24h|3d|7d), format=concise for the densest levels only.

`GET /api/liquidations/heatmap`

## Request

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

Buckets are computed server-side from real per-position liquidation prices in Hyperliquid clearinghouse state across a sample of the largest wallets, weighted by position notional. Positions, wallets and the weighting method are never returned. Every response states the share of open interest observed. Terms: https://tapeperp.com/disclosures

## Query parameters

- `coin` string
- `tf` '12h' | '24h' | '3d' | '7d'

## Response `200`

Bucket grid, realized-liquidation overlay, coverage and methodology

## Other responses

- `401`: Missing or invalid API key
- `404`: Feature not enabled on this deployment
- `503`: Snapshot history not yet available for this market

---

[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)