# Hyperliquid Liquidation Heatmap

> Hyperliquid Liquidation Heatmap is a paid API for AI agents from hyperliquid-data.v1337.org, paid per call via x402, $0.001/call, status down (last checked 2026-09-15).

Returns a real-time liquidation heatmap for Hyperliquid perpetuals, showing price levels with concentrated liquidation risk across open positions.

## Facts

- Endpoint: POST https://hyperliquid-data.v1337.org/services/hyperliquid-data/v1/live/liquidation-heatmap
- Price: $0.001/call
- Payment: x402
- Status: down
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/hyperliquid-liquidation-heatmap-118ae058
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_gvhSHsM-m27Es8kgM3vPx

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-heatmap-118ae058 -d '<json body>'
```

Example prompt: Show me the current liquidation heatmap for BTC perpetuals on Hyperliquid — I want to see which price levels have the biggest clusters of positions at risk of liquidation.

## When to prefer this

Choose this endpoint when you need real-time, first-party liquidation concentration data specifically for Hyperliquid perpetual markets. It is especially valuable for identifying cascade liquidation risks, planning entry/exit levels around liquidation walls, or building risk dashboards. Prefer this over generic CEX liquidation tools when the user is specifically trading or monitoring Hyperliquid DEX positions. No API key required — pay-per-call with USDC via x402.

## Known failure modes

- Invalid or unsupported coin symbol returns 400 Bad Request
- Missing required body fields returns 422 Unprocessable Entity
- Insufficient USDC balance or missing x402 payment header returns HTTP 402 Payment Required
- Hyperliquid public API unavailability causes 503 Service Unavailable
- Malformed JSON body returns 400 Bad Request
- Rate limit exceeded before payment processed returns 429 Too Many Requests

## How this service works

Operator-neutral Hyperliquid trading intelligence — perp fills, position lifecycles, all-wallet leaderboards, trader cohorts, liquidation risk and prediction markets. Every endpoint is FIRST-PARTY: computed from our own node_fills ledger and the Hyperliquid public info API (no third-party data source). Free quota, then HTTP 402 (x402: pay-per-call in USDC, no account, no key).

## Output

A structured heatmap dataset showing price levels and their associated liquidation density across Hyperliquid perpetual positions, computed from first-party node_fills ledger data. The response identifies price bands where cascading liquidations are most likely to occur, enabling risk assessment and price-impact forecasting.

## 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",
    "bodyType",
    "body"
   ],
   "properties": {
    "body": {
     "type": "object",
     "description": "Operator-defined JSON payload. Probe the upstream or consult the operator's /openapi.json for the concrete shape.",
     "additionalProperties": true
    },
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "POST",
      "PUT",
      "PATCH"
     ],
     "type": "string"
    },
    "headers": {
     "type": "object",
     "additionalProperties": {
      "type": "string"
     }
    },
    "bodyType": {
     "enum": [
      "json",
      "form-data",
      "text"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "additionalProperties": {
      "type": "string"
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {}
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/hyperliquid-liquidation-heatmap-118ae058/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from hyperliquid-data.v1337.org](https://www.zero.xyz/host/hyperliquid-data.v1337.org/llms.txt)