# Annalist Hyperliquid Market Liquidation Risk

> Annalist Hyperliquid Market Liquidation Risk is a paid API for AI agents from api.annalist.dev, paid per call via x402, $0.03/call, status unknown (last checked 2026-10-14).

Returns current market-wide liquidation risk data from Hyperliquid, including flagged coins, wallet watch counts, and largest long positions within 5% of liquidation price

## Facts

- Endpoint: GET https://api.annalist.dev/v1/liq/market?utm_source=zero.xyz
- Price: $0.03/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/annalist-hyperliquid-market-liquidation-risk-6349e665
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_ER1-uTNpk1lGK-JK24xHZ

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 annalist-hyperliquid-market-liquidation-risk-6349e665
```

Example prompt: Which coins on Hyperliquid are currently flagged for long cascade risk, and how much USD is sitting within 5% of liquidation across the market?

## When to prefer this

Use this endpoint when you need real-time, crowd-sourced liquidation risk intelligence specifically from Hyperliquid perpetual futures markets, particularly when you want cryptographically signed data suitable for agent-to-agent trust chains. Prefer this over generic crypto data APIs when you need smart-money liquidation heatmaps, flagged cascade risk coins, and historical context about what happened after similar liquidation clusters.

## Known failure modes

- Payment not received via x402 — endpoint returns 402 Payment Required
- Invalid or missing query parameters — returns malformed request error
- Hyperliquid data temporarily unavailable — may return upstream timeout or partial data
- Rate limiting if too many calls in short succession

## How this service works

Signed data for AI agents, paid per call over x402. Hyperliquid crowd state, smart money and liquidations with what historically happened next, plus independent checks of x402 services and MCP servers.

## Output

A JSON object containing: a list of flagged coins with associated risk labels (e.g. 'long_cascade_risk'), the number of wallets being tracked, and a ranked list of coins with the highest USD value of long positions within 5% of their liquidation price. Data is cryptographically signed for agent verification.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "properties": {
   "type": "string"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "data": {
   "flagged": {
    "XYZ": [
     "long_cascade_risk"
    ]
   },
   "wallets_watched": 1000,
   "most_longs_liquidating_within_5pct": [
    {
     "coin": "XYZ",
     "usd_within_5pct": 3100000
    }
   ]
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/annalist-hyperliquid-market-liquidation-risk-6349e665/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.annalist.dev](https://www.zero.xyz/host/api.annalist.dev/llms.txt)