# Hyperliquid Top Liquidators Analytics

> Hyperliquid Top Liquidators Analytics 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-15).

Returns a ranked leaderboard of wallets that have executed the most or largest liquidations on Hyperliquid perpetuals, derived from first-party node_fills ledger data.

## Facts

- Endpoint: POST https://hyperliquid-data.v1337.org/v1/analytics/top-liquidators
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/hyperliquid-top-liquidators-analytics-ad77d4ba
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_LtjQyFI-PgLZbSlsJYC1Q

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-top-liquidators-analytics-ad77d4ba -d '<json body>'
```

Example prompt: Show me the top liquidators on Hyperliquid by total liquidation volume — I want to see which wallets are running the biggest liquidation operations on the perp markets.

## When to prefer this

Choose this endpoint when you need first-party, node-level liquidation leaderboard data for Hyperliquid perpetuals without relying on third-party data aggregators. It is ideal for DeFi research agents, liquidation bot benchmarking, or risk analysis tools that need authoritative on-chain liquidation rankings derived directly from Hyperliquid's fill ledger. Prefer this over generic DEX analytics APIs when Hyperliquid-specific liquidation intelligence is required.

## Known failure modes

- Payment not received or x402 payment flow incomplete — request rejected with 402
- Invalid or malformed POST body — 400 error returned
- No liquidation data available for the specified filter criteria — empty result set
- Node_fills ledger temporarily unavailable — 503 service error
- Rate limiting or upstream Hyperliquid API degradation causing stale or delayed data

## 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

A ranked list of wallet addresses that have acted as liquidators on Hyperliquid perpetuals, including metrics such as liquidation count, total notional volume liquidated, and estimated PnL from liquidation activity, sourced from the operator's 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-top-liquidators-analytics-ad77d4ba/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)