# Hyperliquid Liquidation Levels API

> Hyperliquid Liquidation Levels API is a paid API for AI agents from whaletape.xyz, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-15).

Returns per-market liquidation price levels on Hyperliquid with notional at risk, sorted nearest to current price first

## Facts

- Endpoint: GET https://whaletape.xyz/liquidations
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/hyperliquid-liquidation-levels-api-3cd7d23a
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_2oYI2Mw5maMG2wBwJ4IMG

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability hyperliquid-liquidation-levels-api-3cd7d23a
```

Example prompt: Pull the current liquidation levels across Hyperliquid markets and show me which ones have the largest notional at risk closest to the current price — I want to see where cascades are most likely to trigger.

## When to prefer this

Use this endpoint when you need structured, ranked liquidation level data for Hyperliquid perpetuals — specifically when you want notional-at-risk quantified per price level and sorted by proximity to mark price. Prefer this over generic order book endpoints when the goal is liquidation cascade analysis, squeeze detection, or risk mapping around whale positions on Hyperliquid.

## Known failure modes

- Hyperliquid data feed unavailable — returns error or stale data
- Market not found if a specific symbol is queried that doesn't exist
- Rate limiting or 402 payment required if x402 payment header is missing or insufficient
- Empty result set during low-volatility periods with no notable liquidation clusters
- Response latency spikes during high-volatility market conditions

## How this service works

Where whale positions get liquidated and how far price must move to trigger it: levels per market with notional at risk, nearest first

## Output

A list of liquidation levels per Hyperliquid perpetual market, each entry showing the liquidation price, the notional amount at risk at that level, the direction (long or short), and the distance from current mark price — ordered from nearest to farthest so the most imminent liquidation risk appears first.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "properties": {
   "type": "string"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "note": "liquidation levels of tracked whale positions, not executed liquidations; educational data",
  "markets": [
   {
    "levels": [
     {
      "side": "short",
      "notional": 7818691,
      "positions": 1,
      "distance_pct": 114.96,
      "liquidation_px": 97.16
     }
    ],
    "symbol": "HYPE",
    "mark_px": 45.2,
    "nearest": {
     "side": "short",
     "notional": 7818691,
     "distance_pct": 114.96,
     "liquidation_px": 97.16
    },
    "notional_at_risk": 150607773
   }
  ],
  "updated_at": "2026-08-25T00:30:00Z"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/hyperliquid-liquidation-levels-api-3cd7d23a/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from whaletape.xyz](https://www.zero.xyz/host/whaletape.xyz/llms.txt)