Skip to main content
GET
Perps - Token Liquidation Map
  • Returns a price-bucketed liquidation map for one Hyperliquid perpetual market.
  • The response is organized around liquidation concentration by price zone, not by wallet or trade.
  • Use this endpoint to understand where long and short liquidation pressure may cluster.
  • Pair with token overview and open positions for fuller market-structure interpretation.
  • This endpoint consumes 20 CU per request.
  • Visualize liquidation pressure above and below the current market price.
  • Build liquidation heatmaps for trader dashboards and risk tooling.
  • Identify crowded zones that may accelerate moves once price enters them.
  • Add liquidation context to market commentary, alerts, or derivatives analytics.
  • Query the target Hyperliquid perp token market.
  • Read the returned map as liquidation concentration across price bands.
  • Compare nearby clusters with current price and open-interest context from Perps Token Overview.
  • Use this endpoint as a risk-context layer, not as a standalone trading signal.
  • Plot the map visually to make clustering easier to interpret than raw tables alone.
  • Reconcile liquidation zones with current positioning concentration before making directional assumptions.

Authorizations

X-API-KEY
string
header
required

API key for authentication

Headers

x-perp
enum<string>
default:hyperliquid

Specify the perpetuals exchange. Currently supports hyperliquid.

Available options:
hyperliquid

Query Parameters

token
string
required

The symbol of a coin/token (e.g: BTC, SOL, ETH).

Response

JSON object containing a list of liquidation with certain fields

success
boolean
required

Whether the request succeeded.

data
object[]
required

Liquidation buckets showing where long and short positions are exposed across price ranges.