Hyperliquid Top Traders Leaderboard

Track the best on-chain perps traders on Hyperliquid: top PnL, ROI, and volume across 24h/7d/30d windows. Returns address, account size, realized P&L, ROI %, trading volume, and multi-window comparison. No API key required. $0.002/trader returned (top 50 = $0.10).

---

What It Does

Hyperliquid is a fully on-chain perpetuals DEX — all trading activity is public and verifiable on-chain. This actor fetches the official Hyperliquid leaderboard and returns structured data on the top traders, perfect for:

• Copy trading research — Find the top performers and analyze their strategies
• Sentiment signals — Aggregate top-trader bias (long vs. short) as a market signal
• Account monitoring — Track specific whale wallets over time
• Market analysis — Correlate leaderboard shifts with price action

Example Output

{
  "rank": 1,
  "address": "0x85ecf584f25db6f146718b86d493e33c5af72052",
  "account_value_usd": 62529963.78,
  "pnl_usd": 95023.81,
  "roi_pct": 0.1761,
  "volume_usd": 1554167493.28,
  "time_window": "day",
  "day":   { "pnl_usd": 95023.81, "roi_pct": 0.1761, "volume_usd": 1554167493.28 },
  "week":  { "pnl_usd": -813721.88, "roi_pct": -0.9074, "volume_usd": 8929123456.0 },
  "month": { "pnl_usd": 4219041.53, "roi_pct": 4.8123, "volume_usd": 39812345678.0 },
  "hl_url": "https://app.hyperliquid.xyz/explorer/address/0x85ecf..."
}

Key Features

• Multi-window comparison — Day, week, month, and all-time stats for every trader
• Flexible sorting — Rank by PnL (absolute), ROI (%), or trading volume
• Account size filter — Filter out small accounts, focus on whales
• Optional live positions — Enrich with each trader's current open position count and unrealized PnL
• Direct explorer links — Every row includes the Hyperliquid explorer URL

Input Options

Parameter	Type	Default	Description
timeWindow	string	"day"	Ranking period: day, week, month, allTime
sortBy	string	"pnl"	Sort by: pnl (absolute USD), roi (percentage), volume
limit	integer	50	Max traders to return (5–200)
minAccountValue	number	0	Filter: only return traders with account ≥ this USD value
includePositionState	boolean	false	Add live open position count + unrealized PnL per trader

Pricing

• $0.002 per trader returned
• Top 50 traders = $0.10 per run
• Top 100 traders = $0.20 per run
• Typical use: run daily to track leaderboard shifts

Use Cases

Schedule daily for smart money tracking:

{
  "timeWindow": "day",
  "sortBy": "pnl",
  "limit": 50,
  "minAccountValue": 1000000
}

Weekly ROI champions (focus on skill not just size):

{
  "timeWindow": "week",
  "sortBy": "roi",
  "limit": 20
}

Full position state (for copy-trade research):

{
  "timeWindow": "day",
  "limit": 20,
  "includePositionState": true
}

Data Source

All data is fetched from the official Hyperliquid stats API — the same data shown on Hyperliquid's leaderboard. No scraping, fully on-chain, free public API.