
Hyperliquid trader leaderboard
GET/gateway/v1/hyperliquid/leaderboard
$0.02616per call
Every call costs the same.
You aren't charged for failed calls. A wallet payment for a failed call is refunded.
About this endpoint
Trader Leaderboard: Returns traders ranked by a chosen performance metric (PnL by default), with quality filters to exclude bots and brand-new accounts. Each row carries rank (1-based, offset-adjusted position in this response's ordering).
Metric basis — does NOT reconcile with `/performance`: the leaderboard is built on the upstream Hydromancer trade model, whose total_pnl is funding-INCLUSIVE over an all-markets trade universe, while /hyperliquid/performance//trades//trades/aggregate are funding-EXCLUDED over our episode warehouse. A leaderboard PnL and the same trader's /performance net can differ severalfold — do not display them side-by-side as the same number.
Ranking: sort_by (total_pnl, win_rate, volume_traded) over a time_range window (1d, 7d, 30d, 90d, all). Always sorted descending.
Filters: min_trades (defaults to 5; pass 0 for the full population), min_days_active, min_account_age_days, min_human_score, and dex (`m
Query parameters
Response types
More from Surf API
- KOL rankingGET/gateway/v1/smart-money/kol/ranking$0.01308 per callFixed
- Liquidation chartGET/gateway/v1/market/liquidation/chart$0.01308 per callFixed
- Blockchain SQL queryPOST/gateway/v1/onchain/sql$0.02616 per callFixed
- KOL call historyGET/gateway/v1/smart-money/kol/history$0.01308 per callFixed
- Order book depthGET/gateway/v1/exchange/depth$0.00654 per callFixed
- Latest company financialsGET/gateway/v1/equity/latest-financialsUp to $0.03924 per callResponse-based
- Web page fetchGET/gateway/v1/web/fetch$0.00654 per callFixed
- Matched market pairsGET/gateway/v1/prediction-market/matching/pairs$0.02616 per callFixed
- Polymarket wallet positionsGET/gateway/v1/prediction-market/polymarket/positions$0.02616 per callFixed
- Perpetual contract snapshotGET/gateway/v1/exchange/perp$0.00654 per callFixed
- KOL activityGET/gateway/v1/smart-money/kol/activity$0.01308 per callFixed
- Token DEX tradesGET/gateway/v1/token/dex-trades$0.02616 per callFixed