# Vextorium Hyperliquid Liquidation Map

> Vextorium Hyperliquid Liquidation Map is a paid API for AI agents from api.vextorium.com, paid per call via x402, $0.005/call, status unknown (last checked 2026-10-11).

Returns a price-bracket liquidation map for a Hyperliquid perpetuals asset, showing where clustered long and short positions would be forcibly closed, along with the nearest individual liquidation levels and total notional at risk.

## Facts

- Endpoint: POST https://api.vextorium.com/v1/hyperliquid-liquidation-map?utm_source=zero.xyz
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-11
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/vextorium-hyperliquid-liquidation-map-778c19ec
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_5OAkA6d233whVteKA0jGG

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 vextorium-hyperliquid-liquidation-map-778c19ec -d '<json body>'
```

Example prompt: Pull the Hyperliquid liquidation map for BTC using 20 price brackets — I want to see where the long and short clusters are, which wallets are nearest to liquidation, and how much notional is at risk on each side.

## When to prefer this

Use this endpoint when you need structured, bracket-based liquidation risk data specifically from Hyperliquid perpetuals markets, including both aggregate cluster data and individual wallet-level liquidation proximity. Prefer it over generic CEX order-book tools when working with on-chain Hyperliquid positions, or when you need to identify which specific large wallets are near forced liquidation.

## Known failure modes

- Unsupported currency symbol returns empty or error response
- brackets value outside 5-60 range may be rejected or clamped
- Data is partial — only the 150 largest accounts are visible, not the full market
- Stale data if Hyperliquid state snapshot is delayed
- Network timeout on POST if Hyperliquid upstream is slow

## How this service works

Liquidation map of the largest Hyperliquid accounts for a coin: at which prices their longs (below) and shorts (above) would be liquidated, bucketed with the notional at risk, and the closest levels to the current price.

## Output

Returns the current asset price, a list of price brackets each containing the count of positions, long USD notional, short USD notional, and distance from current price, plus arrays of the nearest individual long and short liquidations (wallet address, liquidation price, distance %, and notional USD), total long and short notional at risk across all brackets, total number of positions with a liquidation level, and a source note clarifying coverage is limited to the top 150 accounts by capital.

## 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": {
     "required": [],
     "properties": {
      "brackets": {
       "type": "integer",
       "description": "5-60"
      },
      "currency": {
       "type": "string"
      }
     }
    },
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "POST"
     ],
     "type": "string"
    },
    "bodyType": {
     "enum": [
      "json",
      "form-data",
      "text"
     ],
     "type": "string"
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": [
      "object",
      "null"
     ],
     "properties": {
      "note": {
       "type": [
        "string",
        "null"
       ]
      },
      "price": {
       "type": [
        "number",
        "null"
       ]
      },
      "source": {
       "type": [
        "string",
        "null"
       ]
      },
      "brackets": {
       "type": [
        "array",
        "null"
       ],
       "items": {
        "type": [
         "null",
         "object"
        ],
        "properties": {
         "since": {
          "type": [
           "null",
           "number"
          ]
         },
         "until": {
          "type": [
           "null",
           "number"
          ]
         },
         "longs_usd": {
          "type": [
           "null",
           "number"
          ]
         },
         "positions": {
          "type": [
           "null",
           "number"
          ]
         },
         "shorts_usd": {
          "type": [
           "null",
           "number"
          ]
         },
         "distance_pct": {
          "type": [
           "null",
           "number"
          ]
         }
        }
       }
      },
      "currency": {
       "type": [
        "string",
        "null"
       ]
      },
      "long_notional_at_risk_usd": {
       "type": [
        "number",
        "null"
       ]
      },
      "nearest_long_liquidations": {
       "type": [
        "array",
        "null"
       ],
       "items": {
        "type": [
         "null",
         "object"
        ],
        "properties": {
         "wa
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "note": "Partial: only large accounts are visible; not the full market map.",
  "price": 84644.1,
  "source": "Hyperliquid (state of the 150 active accounts with the most capital)",
  "brackets": [
   {
    "since": 71947.485,
    "until": 76179.69,
    "longs_usd": 31496,
    "positions": 1,
    "shorts_usd": 0,
    "distance_pct": -12.5
   },
   {
    "since": 84644.1,
    "until": 88876.305,
    "longs_usd": 0,
    "positions": 1,
    "shorts_usd": 39265958,
    "distance_pct": 2.5
   }
  ],
  "currency": "BTC",
  "long_notional_at_risk_usd": 139683299,
  "nearest_long_liquidations": [
   {
    "wallet": "0x9a1500b41519868039b1f95c447ba50b76d837e6",
    "liquidation": 73774.9858313574,
    "distance_pct": -12.84,
    "notional_usd": 31496
   },
   {
    "wallet": "0xcfe2729438475c5eb9e8e6da6b314a0b9e2d8fb3",
    "liquidation": 41630.9464742785,
    "distance_pct": -50.82,
    "notional_usd": 42322050
   }
  ],
  "nearest_short_liquidations": [
   {
    "wallet": "0xec0b9ebf2a304c99cafe85c548c14dd7783cb078",
    "liquidation": 87288.8216754827,
    "distance_pct": 3.12,
    "notional_usd": 39265958
   },
   {
    "wallet": "0x218a65e21eddeece7a9df38c6bbdd89f692b7da2",
    "liquidation": 95125.3334571767,
    "distance_pct": 12.38,
    "notional_usd": 51338089
   }
  ],
  "positions_with_liquidation": 34,
  "short_notional_at_risk_usd": 763297363
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/vextorium-hyperliquid-liquidation-map-778c19ec/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.vextorium.com](https://www.zero.xyz/host/api.vextorium.com/llms.txt)