# Hyperliquid Crypto Liquidation Data API

> Hyperliquid Crypto Liquidation Data API is a paid API for AI agents from nonvisceral-eloisa-mousily.ngrok-free.dev, paid per call via x402, $0.02/call, status unknown (last checked 2026-09-14).

Returns real-time cryptocurrency liquidation metrics including open interest velocity, cascade risk detection, and large trade tracking ($50K+) for BTC, ETH, and SOL from Hyperliquid DEX

## Facts

- Endpoint: GET https://nonvisceral-eloisa-mousily.ngrok-free.dev/api/liquidations
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/nonvisceral-eloisa-mousily-ngrok-free-dev-a1c312d8
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_5a6hw9JcdtR6LfaeyGq2A

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 nonvisceral-eloisa-mousily-ngrok-free-dev-a1c312d8
```

Example prompt: Pull the latest liquidation data from Hyperliquid for BTC, ETH, and SOL — I want to see the open interest velocity, any cascade risk signals, and what large trades over $50K have happened in the last hour.

## When to prefer this

Choose this endpoint when you need real-time liquidation-specific data from Hyperliquid DEX — particularly open interest velocity, cascade risk scoring, and large trade activity for BTC, ETH, and SOL. Prefer this over generic funding rate or OI endpoints when the specific concern is liquidation cascade risk or large directional trades triggering forced selling.

## Known failure modes

- Hyperliquid DEX data feed unavailable — stale or missing data returned
- Payment failure or missing x402 payment header — 402 response
- Rate limiting if called too frequently — 429 response
- ngrok tunnel down or unreachable — connection timeout or 502
- Empty large_trades_1h array if no qualifying trades occurred in the window

## How this service works

Cryptocurrency liquidation data API: real-time open interest velocity, cascade risk detection, large trade tracking ($50K+) for Bitcoin BTC, Ethereum ETH, and Solana SOL. Market risk and liquidation heatmap data from Hyperliquid DEX.

## Output

Returns a JSON object with open interest velocity at 5m/1h/24h intervals with cascade risk level per coin, current open interest with mark price and funding rate, an array of large trades ($50K+) in the last hour, and a count of large trades over the past 24 hours — all sourced from Hyperliquid DEX and timestamped with updated_at.

## 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": {}
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "properties": {
      "velocity": {
       "type": "object",
       "description": "OI rate of change at 5m/1h/24h intervals with cascade risk level"
      },
      "current_oi": {
       "type": "object",
       "description": "Current open interest, mark price, and funding per coin"
      },
      "updated_at": {
       "type": "string"
      },
      "large_trades_1h": {
       "type": "array",
       "description": "Large trades ($50K+) in the last hour"
      },
      "large_trades_24h_count": {
       "type": "number",
       "description": "Count of large trades in last 24h"
      }
     }
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/nonvisceral-eloisa-mousily-ngrok-free-dev-a1c312d8/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from nonvisceral-eloisa-mousily.ngrok-free.dev](https://www.zero.xyz/host/nonvisceral-eloisa-mousily.ngrok-free.dev/llms.txt)