# Hyperliquid Top-Volume Wallets Analytics

> Hyperliquid Top-Volume Wallets 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 wallets with the highest trading volume on Hyperliquid perpetuals, computed from first-party node fills data.

## Facts

- Endpoint: POST https://hyperliquid-data.v1337.org/v1/analytics/top-volume-wallets
- 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-volume-wallets-analytics-a623efa6
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_RRr5X7Yc65KT9WfHL8QJo

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-volume-wallets-analytics-a623efa6 -d '<json body>'
```

Example prompt: Show me the top 20 wallets by trading volume on Hyperliquid perps over the last 7 days, ranked from highest to lowest volume.

## When to prefer this

Use this endpoint when you need first-party, operator-computed Hyperliquid top-volume wallet rankings without relying on any third-party data aggregator. It is ideal for identifying whale traders, building leaderboards, or performing competitive volume analysis on Hyperliquid perps. Prefer this over generic DeFi analytics APIs when you specifically need Hyperliquid-native fill data at low per-call cost with no API key required.

## Known failure modes

- Payment not fulfilled via x402 on Base — returns 402 Payment Required
- Invalid or malformed JSON body — returns 400 Bad Request
- Unsupported time range or filter parameters — returns 422 Unprocessable Entity
- Hyperliquid node data temporarily unavailable — returns 503 Service Unavailable
- Rate limiting or payment processing delay — returns 429 or timeout

## 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 sorted by perpetuals trading volume on Hyperliquid, including volume totals, trade counts, and potentially per-asset breakdowns, derived 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-volume-wallets-analytics-a623efa6/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)