# Hyperliquid Max Pain Events Analytics

> Hyperliquid Max Pain Events Analytics 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 max-pain event analytics for Hyperliquid perpetuals, identifying price levels and moments where aggregate trader losses are maximized, derived from first-party node fills and position data.

## Facts

- Endpoint: POST https://hyperliquid-data.v1337.org/v1/analytics/max-pain-events
- 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-max-pain-events-analytics-328ee523
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_0L4p-vaQq6A7yK8r-d-7U

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-max-pain-events-analytics-328ee523 -d '<json body>'
```

Example prompt: Pull the max pain events for ETH-USDC perps on Hyperliquid — I want to see which price levels caused the biggest aggregate losses and when those events occurred.

## When to prefer this

Choose this endpoint when you need first-party, node-level max pain analytics specifically for Hyperliquid perpetual markets without relying on any third-party data aggregator. It is ideal for agents performing DeFi risk analysis, liquidation research, or market microstructure studies on Hyperliquid where data provenance and freshness from a dedicated node are important. Prefer it over generic crypto analytics APIs when Hyperliquid-specific fill-ledger fidelity and HIP-4 prediction market context matter.

## Known failure modes

- Payment required (402) if x402 micropayment on Base is not attached or fails
- Invalid or missing body payload returns 400 with schema validation error
- Unknown asset or market identifier returns empty result set or 404
- Rate limiting or node data lag may cause stale or delayed results
- Malformed JSON body returns parse error

## How this service works

First-party Hyperliquid trading intelligence: perp fills, position lifecycles, all-wallet leaderboards, trader cohorts, liquidation risk and HIP-4 prediction markets - computed from our own node_fills ledger plus the Hyperliquid public info API (no third-party data source). Free discovery (/healthz, /v1/stats, /.well-known/x402, /v1/openapi.json) and free sample routes (/v1/markets/overview, /v1/assets); all other API calls are $0.001 USDC per request via x402 on Base (no account, no API key).

## Output

Returns computed max-pain event records for Hyperliquid perpetual markets, including price levels at which aggregate unrealized or realized losses are maximized, timestamps of peak pain events, affected assets, and associated open interest or fill volume context — all derived from the operator's first-party node_fills ledger.

## 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-max-pain-events-analytics-328ee523/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)