# Hyperliquid Whale Liquidation Levels

> Hyperliquid Whale Liquidation Levels is a paid API for AI agents from chiefofstaff-solana.iodized-lemon.workers.dev, paid per call via x402, $0.003/call, status unknown (last checked 2026-10-11).

Returns whale liquidation price levels and USD exposure for Hyperliquid perpetual futures, showing where large positions would be liquidated above and below current mark price.

## Facts

- Endpoint: GET https://chiefofstaff-solana.iodized-lemon.workers.dev/hl/liq-levels?utm_source=zero.xyz
- Price: $0.003/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-11
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/hyperliquid-whale-liquidation-levels-6488de73
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap__hxy8MALEZJ_pJ2-FN4U5

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-whale-liquidation-levels-6488de73
```

Example prompt: What are the whale liquidation levels for ETH on Hyperliquid right now — show me where the big long and short clusters are and how far they are from the current mark price.

## When to prefer this

Choose this endpoint when you need granular whale-level liquidation price data for Hyperliquid perpetuals, specifically the clustered liquidation prices (both long and short) with USD exposure amounts and distance from mark price. It is purpose-built for trading agents that need to identify liquidation cascade risk zones or short squeeze targets on HL. Prefer this over generic market data endpoints when Hyperliquid-specific perp liquidation intelligence is needed. At $0.003 per call with ~3-minute refresh cadence, it is appropriate for pre-trade checks or periodic monitoring rather than tick-by-tick streaming.

## Known failure modes

- Invalid or unrecognized coin ticker returns empty or null by_coin entry
- Data older than expected if Hyperliquid public data feed is delayed
- Payment failure via x402 if USDC balance insufficient — request blocked before data returned
- Stale data is never charged — if age_s is too high, no charge is applied
- Network timeout to Hyperliquid data source results in error response

## How this service works

Paid token safety / rug-pull checks for AI agents: Solana SPL (/check) and Robinhood Chain ERC-20 (/rh/check). One-sentence verdict + blocking/warnings/unknowns, casino|speculative|legit tier, holder count & concentration, liquidity, 1h volume & buy/sell flow, honeypot/tax or mint/freeze authority, RugCheck/GoPlus cross-checks. $0.01 USDC on Base or Solana via x402. Also: Hyperliquid perp market data for trading agents: funding extremes across all HL perps ($0.002), whale liquidation levels ($0.003), whale net positioning ($0.005), and a one-call LLM-ready market brief ($0.008). Refreshed ~every 3 min from HL public data; every response has generated_at/age_s; stale data is never charged.

## Output

Returns a JSON object with liquidation level data per coin, including: reference mark price, arrays of long liquidation clusters below current price (with count of positions, price, USD exposure, and distance percentage), arrays of short liquidation clusters above current price, total long USD at risk within 10%, total short USD at risk within 10%, plus metadata fields generated_at (ISO timestamp) and age_s (seconds since data was generated, refreshed ~every 3 minutes).

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "properties": {
      "coin": {
       "type": "string",
       "description": "Optional HL perp ticker, e.g. ETH"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "age_s": 41,
  "by_coin": {
   "ETH": {
    "ref_mark": 2570.1,
    "below_longs": [
     {
      "n": 3,
      "px": 2446.18,
      "usd": 146100000,
      "dist_pct": -4.8
     }
    ],
    "above_shorts": [
     {
      "n": 2,
      "px": 3140.81,
      "usd": 54900000,
      "dist_pct": 22.2
     }
    ],
    "long_usd_within_10pct": 151000000,
    "short_usd_within_10pct": 0
   }
  },
  "endpoint": "/hl/liq-levels",
  "generated_at": "2026-10-07T20:00:59Z"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/hyperliquid-whale-liquidation-levels-6488de73/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from chiefofstaff-solana.iodized-lemon.workers.dev](https://www.zero.xyz/host/chiefofstaff-solana.iodized-lemon.workers.dev/llms.txt)