# Vextorium Hyperliquid Leaderboard

> Vextorium Hyperliquid Leaderboard 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-28).

Fetches the Hyperliquid public perpetuals trading leaderboard, ranked by PnL, ROI, or volume over a chosen time period, with optional minimum account size filter.

## Facts

- Endpoint: POST https://api.vextorium.com/v1/hyperliquid-leaderboard?utm_source=zero.xyz
- Price: $0.004/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-28
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/vextorium-hyperliquid-leaderboard-a3db82ed
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_wAqtj67fi3OIoWg2p5zTB

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 vextorium-hyperliquid-leaderboard-a3db82ed -d '<json body>'
```

Example prompt: Pull the Hyperliquid leaderboard for this month, ranked by PnL, show me the top 20 traders, and only include wallets with at least $50,000 in their account.

## When to prefer this

Use this endpoint when you need structured, filterable access to the Hyperliquid perpetuals trading leaderboard with control over ranking metric (PnL, ROI, or volume), time window, result count, and minimum account size — especially in agent workflows that need to identify top traders, copy-trade candidates, or benchmark performance against the broader Hyperliquid community.

## Known failure modes

- Invalid enum value for 'order' or 'period' returns a validation error
- Hyperliquid public API unavailability may cause upstream timeout or empty response
- Extremely high 'limit' values may return truncated results if leaderboard data is limited
- Missing required 'input' wrapper object causes schema validation failure

## How this service works

558 pay-per-call data APIs for AI agents: Solana and EVM on-chain data, tokenized stocks, DeFi, Hyperliquid, economy and official statistics, FX, validation, web and developer tools. Pay in USDC via x402.

## Output

Returns a JSON object containing the leaderboard parameters used (period, order), the data source attribution, a disclaimer note, the total number of wallets considered, and an array of ranked trader entries each containing rank, wallet address, PnL in USD, ROI percentage, volume in USD, and account value in USD.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "limit": {
   "type": "integer"
  },
  "order": {
   "enum": [
    "pnl",
    "roi",
    "volume"
   ],
   "type": "string"
  },
  "period": {
   "enum": [
    "day",
    "week",
    "month",
    "allTime"
   ],
   "type": "string"
  },
  "min_account_usd": {
   "type": "number"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "note": "Past results; not a recommendation.",
  "order": "pnl",
  "period": "month",
  "source": "Hyperliquid (public leaderboard)",
  "traders": [
   {
    "rank": 1,
    "wallet": "0x30afce2f6842bf183c7e3fe7162e279ff0b6393e",
    "pnl_usd": 18392482,
    "roi_pct": 624.76,
    "volume_usd": 117967268,
    "account_value_usd": 11316393
   },
   {
    "rank": 2,
    "wallet": "0xeadc152ac1014ace57c6b353f89adf5faffe9d55",
    "pnl_usd": 16309377,
    "roi_pct": 200.29,
    "volume_usd": 27111872,
    "account_value_usd": 19752067
   }
  ],
  "considered_wallets": 8326
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/vextorium-hyperliquid-leaderboard-a3db82ed/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)