# Hyperliquid Live Coin Liquidation Risk

> Hyperliquid Live Coin Liquidation Risk is a paid API for AI agents from hyperliquid-data.v1337.org, paid per call via x402, $0.001/call, status unknown (last checked 2026-09-14).

Returns real-time liquidation risk metrics aggregated by coin/asset on the Hyperliquid perpetuals exchange

## Facts

- Endpoint: POST https://hyperliquid-data.v1337.org/services/hyperliquid-data/v1/live/risk/coins
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/hyperliquid-live-coin-liquidation-risk-603b4e42
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_pCL30mNuYhyhyLLLGgn6b

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-coin-liquidation-risk-603b4e42 -d '<json body>'
```

Example prompt: Which coins on Hyperliquid perps are carrying the highest liquidation risk right now — show me a breakdown by asset so I can see where cascading liquidations might hit first.

## When to prefer this

Use this endpoint when you need live, per-coin liquidation risk data sourced entirely from first-party Hyperliquid node data — not third-party aggregators. Ideal for risk dashboards, liquidation alert systems, and trading bots that need to monitor which perpetual markets are most exposed to forced liquidations in real time. Prefer this over generic DeFi risk APIs when the specific focus is Hyperliquid perp markets.

## Known failure modes

- HTTP 402 if free quota is exhausted and no USDC payment is provided
- Empty or sparse results if no significant open positions exist for requested coins
- Stale data if the operator's node_fills ledger has a sync lag
- Malformed request body returns 400-level error
- Network timeout if Hyperliquid public info API is slow

## 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 response containing per-coin liquidation risk metrics computed from live Hyperliquid perpetuals data, including risk scores, leverage exposure, and proximity-to-liquidation indicators aggregated across open positions by asset.

## 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-coin-liquidation-risk-603b4e42/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)