# 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-12).

Returns a bucketed liquidation map for a given coin on Hyperliquid, showing at which prices large accounts' longs and shorts would be liquidated and the notional at risk per price band.

## Facts

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

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-79b9dd06 -d '<json body>'
```

Example prompt: Show me the Hyperliquid liquidation map for BTC with 20 price buckets — I want to see where the biggest long and short liquidation clusters are and which levels are closest to the current price.

## When to prefer this

Use this endpoint when you need to understand where Hyperliquid perpetual positions are clustered for liquidation risk analysis on a specific coin — especially for identifying price levels where cascading liquidations could accelerate moves. Prefer this over generic order book or funding rate endpoints when the specific goal is liquidation mapping of large accounts on Hyperliquid.

## Known failure modes

- Unknown or unsupported coin ticker returns empty or null result
- tramos value outside 5-60 range may cause validation error
- Hyperliquid data source unavailable causes null or error response
- No large positions found for a coin returns empty buckets
- Network timeout on Hyperliquid data fetch

## 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 price of the coin, an array of price buckets each containing the price range, number of positions, long notional at risk in USD, short notional at risk in USD, and distance from current price as a percentage. Also returns the closest individual long and short liquidation levels with wallet address, liquidation price, notional USD, and distance percentage, plus aggregate totals for long and short notional at risk and total number of positions at risk.

## 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": {
      "moneda": {
       "type": "string"
      },
      "tramos": {
       "type": "integer",
       "description": "5-60"
      }
     }
    },
    "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": {
      "nota": {
       "type": [
        "string",
        "null"
       ]
      },
      "fuente": {
       "type": [
        "string",
        "null"
       ]
      },
      "moneda": {
       "type": [
        "string",
        "null"
       ]
      },
      "precio": {
       "type": [
        "number",
        "null"
       ]
      },
      "tramos": {
       "type": [
        "array",
        "null"
       ],
       "items": {
        "type": [
         "null",
         "object"
        ],
        "properties": {
         "desde": {
          "type": [
           "null",
           "number"
          ]
         },
         "hasta": {
          "type": [
           "null",
           "number"
          ]
         },
         "cortos_usd": {
          "type": [
           "null",
           "number"
          ]
         },
         "largos_usd": {
          "type": [
           "null",
           "number"
          ]
         },
         "posiciones": {
          "type": [
           "null",
           "number"
          ]
         },
         "distancia_pct": {
          "type": [
           "null",
           "number"
          ]
         }
        }
       }
      },
      "posiciones_con_liquidacion": {
       "type": [
        "number",
        "null"
       ]
      },
      "nocional_cortos_en_riesgo_usd": {
       "type": [
        "number",
        "null"
       ]
      },
      "nocional_largos_en_riesgo_usd": {
       "type": [
        "number",
        "null"
       ]
      },
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/vextorium-hyperliquid-liquidation-map-79b9dd06/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)