# 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-14).

Returns a ranked list of the top liquidators on the Hyperliquid perpetuals exchange, computed from first-party node fills data.

## Facts

- Endpoint: POST https://hyperliquid-data.v1337.org/services/hyperliquid-data/v1/analytics/top-liquidators
- 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-top-liquidators-analytics-148cdb4a
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_BDY4eKqgM_U32E76GqP5e

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-148cdb4a -d '<json body>'
```

Example prompt: Pull the top liquidators on Hyperliquid perps right now — I want to see who's been doing the most liquidations and how much volume they've handled.

## When to prefer this

Choose this endpoint when you need first-party, operator-computed liquidator rankings on Hyperliquid perpetuals without relying on third-party data aggregators. Ideal for DeFi analysts, risk monitors, or trading bots that need to identify who is actively liquidating positions, track liquidator wallet behavior, or assess liquidation market competition on Hyperliquid. Prefer this over generic block explorers or Hyperliquid's own public API when you need pre-aggregated, ranked analytics rather than raw event data.

## Known failure modes

- HTTP 402 if free quota is exhausted and no USDC payment is attached — pay-per-call via x402 required
- Malformed POST body returns a 400 error with schema validation details
- Upstream Hyperliquid node data lag may cause slightly stale results
- Empty result set if no liquidations occurred in the specified time window
- Connection timeout if the operator node is under heavy load

## 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 ranked leaderboard of wallet addresses that have acted as liquidators on Hyperliquid, with associated metrics such as number of liquidations executed, total liquidation volume in USDC, and realized profit from liquidation activity, computed from first-party node fills data.

## 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-148cdb4a/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)