# Hyperliquid Top Traders Leaderboard

> Hyperliquid Top Traders Leaderboard is a paid API for AI agents from scraplingdata.xyz, paid per call via x402, $0.005/call, status unknown (last checked 2026-10-30).

Returns a ranked list of top (or worst) traders on Hyperliquid's on-chain perpetuals DEX, sorted by PnL, ROI, or volume across configurable time windows.

## Facts

- Endpoint: GET https://scraplingdata.xyz/v1/traders/top?utm_source=zero.xyz
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-30
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/hyperliquid-top-traders-leaderboard-a166fb97
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Nd2TPDL19yrJF652jfVDi

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-traders-leaderboard-a166fb97
```

Example prompt: Pull the top 50 traders on Hyperliquid ranked by PnL for this week, filtering to accounts with at least $25,000 in value.

## When to prefer this

Use this endpoint when you need a ranked leaderboard of Hyperliquid traders across the full ~47,000-account universe, filterable by time window and account size. Prefer this over single-wallet lookups when you need comparative rankings, top-N lists, or want to identify standout performers or worst losers across the entire platform. It is the right choice for copy-trading research, alpha hunting, or platform-wide analytics.

## Known failure modes

- Invalid venue parameter (only 'hyperliquid' supported) returns an error
- Invalid window value (not day/week/month/allTime) returns a validation error
- Limit exceeding 200 returns an error or is clamped
- Payment not included or insufficient USDC results in HTTP 402 rejection
- min_account or min_volume set too high may return an empty result set
- Temporary on-chain data unavailability may cause stale or partial results

## How this service works

Top traders on Hyperliquid (largest on-chain perp DEX), ranked from public on-chain account data across ~47,000 accounts: wallet address, display name, account value, PnL USD, ROI %, volume for the chosen window plus day/week/month/all-time stats and explorer link. Params: venue=hyperliquid, window=day|week|month|allTime, sort=pnl|roi|volume|worst, limit (default 25, max 200), min_account (USD, default 10000), min_volume.

## Output

Returns a ranked list of up to 200 Hyperliquid trader records, each containing wallet address, display name, account value in USD, PnL in USD, ROI percentage, volume for the selected window, and day/week/month/all-time breakdowns plus a blockchain explorer link.

## 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"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "headers": {
     "type": "object",
     "additionalProperties": {
      "type": "string"
     }
    },
    "queryParams": {
     "type": "object",
     "required": [],
     "properties": {
      "sort": {
       "type": "string",
       "description": "pnl | roi | volume | worst (default pnl)"
      },
      "limit": {
       "type": "integer",
       "description": "Max rows (default 25, max 200)"
      },
      "venue": {
       "type": "string",
       "description": "hyperliquid"
      },
      "window": {
       "type": "string",
       "description": "day | week | month | allTime (default week)"
      },
      "min_volume": {
       "type": "number",
       "description": "Minimum window volume USD"
      },
      "min_account": {
       "type": "number",
       "description": "Minimum account value USD (default 10000)"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/hyperliquid-top-traders-leaderboard-a166fb97/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from scraplingdata.xyz](https://www.zero.xyz/host/scraplingdata.xyz/llms.txt)