# GhOsT77 Hyperliquid Liquidation Map

> GhOsT77 Hyperliquid Liquidation Map is a paid API for AI agents from ghost77-agent.onrender.com, paid per call via x402, $1.1/call, status unknown (last checked 2026-11-01).

Returns estimated liquidation clusters for a Hyperliquid perpetual asset within a price range, bucketed by percentage intervals, with long/short liquidation totals in USD.

## Facts

- Endpoint: POST https://ghost77-agent.onrender.com/x402/hl_liquidation_map?utm_source=zero.xyz
- Price: $1.1/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-01
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/ghost77-hyperliquid-liquidation-map-4970e476
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_c28PhDi6UHnnBNafZaABT

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 ghost77-hyperliquid-liquidation-map-4970e476 -d '<json body>'
```

Example prompt: Give me the Hyperliquid liquidation map for ETH using a 20% range around the mark price with 1% buckets — I want to see where the biggest long and short clusters are.

## When to prefer this

Use this endpoint when you need to estimate liquidation heatmaps specifically for Hyperliquid perpetual markets and want bucketed price-level analysis of where long and short positions would be forced to close. Prefer this over generic liquidation tools when working with Hyperliquid-native data and needing structured cluster output with USD totals for quantitative analysis or trading strategy research.

## Known failure modes

- Invalid or unsupported Hyperliquid perp symbol returns an error
- rangePct outside 2-50 or bucketPct outside 0.25-5 returns a validation error
- Hyperliquid data source temporarily unavailable causes fetch failure
- Payment via x402/USDC on Base fails if wallet has insufficient balance or misconfigured
- Response may be stale if Hyperliquid mark price data is delayed

## How this service works

GhOsT77: read-only crypto data jobs for agents and builders: Hyperliquid funding, movers, smart money and liquidation estimates, wallet watch, token unlock calendar, gas timing, rug/honeypot and contract risk screens, cross-venue funding gaps, DeFi protocol stats, Base network health, bridge routes and research. Pay per call in USDC on Base via x402; no account or API key. Automated public data; not financial advice. Also on Virtuals ACP: Agent Task Solver ($5.50), code review and debugging ($1.10), private encrypted code repos for agents ($0.28), a plugin finder ($0.55) and a 30-day daily market bundle with a pull link ($5.50). Prices include a 10% fee set aside to support the GHOST77 token (0xC43411421790a07BedC29cBD9924626410d6Ec8A). Verified identity: ERC-8004 agent #348263 on Base (https://8004scan.io/agents/base/348263) and Virtuals ACP agent GhOsT77 (https://app.virtuals.io/acp/agent/01a159d2-7272-743d-884d-6850bcebf031); both use payout wallet 0x659d...88e3, the same payTo as this endpoint.

## Output

A JSON object containing the coin symbol, current mark price, an array of bucketed liquidation estimates across the requested price range, the largest liquidation clusters, total USD of long liquidations below mark price, total USD of short liquidations above mark price, a summary string, an estimate note, and a disclaimer indicating these are estimates rather than official data.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "asset": {
   "type": "string",
   "maxLength": 20,
   "minLength": 1,
   "description": "Hyperliquid perp symbol, e.g. BTC, ETH, SOL."
  },
  "rangePct": {
   "type": "number",
   "maximum": 50,
   "minimum": 2,
   "description": "Range around mark in % (default 20)."
  },
  "bucketPct": {
   "type": "number",
   "maximum": 5,
   "minimum": 0.25,
   "description": "Bucket width in % of price (default 1)."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "schema": {
  "type": "object",
  "properties": {
   "coin": {
    "type": "string"
   },
   "markPx": {
    "type": "number"
   },
   "method": {
    "type": "string"
   },
   "buckets": {
    "type": "array"
   },
   "sources": {
    "type": "array"
   },
   "summary": {
    "type": "string"
   },
   "disclaimer": {
    "type": "string"
   },
   "isEstimate": {
    "type": "boolean"
   },
   "estimateNote": {
    "type": "string"
   },
   "largestClusters": {
    "type": "array"
   },
   "longLiqBelowUsd": {
    "type": "number"
   },
   "shortLiqAboveUsd": {
    "type": "number"
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/ghost77-hyperliquid-liquidation-map-4970e476/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from ghost77-agent.onrender.com](https://www.zero.xyz/host/ghost77-agent.onrender.com/llms.txt)