# Hyperliquid Trader Leaderboard by PnL, ROI, or Volume

> Hyperliquid Trader Leaderboard by PnL, ROI, or Volume is a paid API for AI agents from api.vextorium.com, paid per call via x402, $0.004/call, status unknown (last checked 2026-10-09).

Returns a ranked leaderboard of Hyperliquid traders sorted by PnL, ROI, or volume over a chosen time period, excluding non-trading accounts like vaults.

## Facts

- Endpoint: POST https://api.vextorium.com/hyperliquid-ranking-pago?utm_source=zero.xyz
- Price: $0.004/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-09
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/hyperliquid-trader-leaderboard-by-pnl-roi-or-volume-5f92cb9e
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_zgENfOlQH9D9rdeikR4fu

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-trader-leaderboard-by-pnl-roi-or-volume-5f92cb9e -d '<json body>'
```

Example prompt: Show me the top 20 Hyperliquid traders ranked by ROI over the past week, only including accounts with at least $10,000 in account value.

## When to prefer this

Use this endpoint when you need a ranked leaderboard of active Hyperliquid traders filtered by PnL, ROI, or volume with flexible time horizons. Prefer this over generic DeFi analytics APIs when the user specifically wants Hyperliquid performance rankings or is looking for top traders and whales to follow on that platform. For viewing a specific wallet's open positions on Hyperliquid, use the companion hyperliquid-posiciones endpoint instead.

## Known failure modes

- Invalid enum value for 'orden' or 'periodo' fields returns a validation error
- Hyperliquid API unavailability may cause upstream data fetch failures
- Very high 'limite' values may slow response or return partial data
- Missing required body fields may return a 400-level error
- Accounts with zero trading volume are excluded by design, so vault-only wallets won't appear

## How this service works

Hyperliquid trader leaderboard by PnL, ROI or volume over the day, week, month or all time, with account value (accounts without trading volume, like vaults, are excluded). Find top traders and whales to follow; see a wallet's positions with hyperliquid-posiciones.

## Output

Returns a ranked list of trader objects each containing: wallet address, rank position, PnL in USD, ROI percentage, trading volume in USD, and account value in USD. Also includes metadata such as the sort order used, time period, total wallets considered, and a data source note.

## 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": {
     "required": [],
     "properties": {
      "orden": {
       "enum": [
        "pnl",
        "roi",
        "volumen"
       ],
       "type": "string"
      },
      "limite": {
       "type": "integer"
      },
      "periodo": {
       "enum": [
        "day",
        "week",
        "month",
        "allTime"
       ],
       "type": "string"
      },
      "minimo_cuenta_usd": {
       "type": "number"
      }
     }
    },
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "POST"
     ],
     "type": "string"
    },
    "bodyType": {
     "enum": [
      "json",
      "form-data",
      "text"
     ],
     "type": "string"
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": [
      "object",
      "null"
     ],
     "properties": {
      "nota": {
       "type": [
        "string",
        "null"
       ]
      },
      "orden": {
       "type": [
        "string",
        "null"
       ]
      },
      "fuente": {
       "type": [
        "string",
        "null"
       ]
      },
      "periodo": {
       "type": [
        "string",
        "null"
       ]
      },
      "traders": {
       "type": [
        "array",
        "null"
       ],
       "items": {
        "type": [
         "null",
         "object"
        ],
        "properties": {
         "puesto": {
          "type": [
           "null",
           "number"
          ]
         },
         "cartera": {
          "type": [
           "null",
           "string"
          ]
         },
         "pnl_usd": {
          "type": [
           "null",
           "number"
          ]
         },
         "roi_pct": {
          "type": [
           "null",
           "number"
          ]
         },
         "volumen_usd": {
          "type": [
           "null",
           "number"
          ]
         },
         "valor_cuenta_usd": {
          "type": [
           "null",
           "number"
          ]
         }
        }
       }
      },
      "carteras_consideradas": {
       "type": [
        "number",
  
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/hyperliquid-trader-leaderboard-by-pnl-roi-or-volume-5f92cb9e/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.vextorium.com](https://www.zero.xyz/host/api.vextorium.com/llms.txt)