# Hyperliquid Live Risk Overview

> Hyperliquid Live Risk Overview 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 overview of liquidation risk and position exposure metrics across the Hyperliquid perpetuals market, computed from first-party node fills data.

## Facts

- Endpoint: POST https://hyperliquid-data.v1337.org/services/hyperliquid-data/v1/live/risk/overview
- 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-live-risk-overview-f4b99608
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_3sG9p5ntWlb_c5p9Jo26x

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-live-risk-overview-f4b99608 -d '<json body>'
```

Example prompt: Give me the live risk overview for the Hyperliquid perps market right now — I want to see how much liquidation risk is out there and what the overall exposure looks like across positions.

## When to prefer this

Choose this endpoint when you need a real-time, market-wide liquidation risk overview for Hyperliquid perpetuals, computed directly from a first-party node fills ledger rather than a third-party aggregator. Prefer it over generic DeFi analytics APIs when the specific concern is Hyperliquid perp liquidation risk and position exposure. Ideal for agents monitoring market conditions, risk dashboards, or alerting workflows tied to Hyperliquid.

## Known failure modes

- HTTP 402 with x402 payment-required header if free quota is exhausted — agent must complete USDC micropayment
- Malformed or missing required body fields return 4xx validation errors
- Upstream Hyperliquid node data delay may produce stale risk snapshots
- Empty or partial response if no risky positions exist at query time
- 503/timeout if the first-party node is temporarily unavailable

## 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 JSON object containing a real-time overview of liquidation risk and position exposure across Hyperliquid perpetual markets, derived from first-party node fills and the Hyperliquid public info API. Specific fields depend on the operator's schema (consult /openapi.json); expected to include risk metrics, exposure summaries, and liquidation proximity indicators.

## 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-live-risk-overview-f4b99608/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)