Hyperliquid leaderboard API: top traders by PnL
Hyperliquid's documented API has no leaderboard request. Its leaderboard data is one public JSON file, stats-data.hyperliquid.xyz/Mainnet/leaderboard, with 48,064 accounts when we checked on 10 November 2026. To rank every wallet over your own window by realized PnL, use an indexed API such as Ironflow's /v1/analytics/leaderboard-pnl.
Free key14 days of history at 60 requests a minute. Without a key, the API reaches 24 hours back.
By requesting a key you agree to the Terms and API terms; see the Privacy Policy. We may email you when your key keeps hitting its limits; you can opt out at any time.
The answer#
- Fixed windows: Hyperliquid's leaderboard file. Day, week, month and all time.
- Any window, every wallet:
GET /v1/analytics/leaderboard-pnl, no key for 24 hours. - A ready list: top traders, the last 30 days, refreshed every 15 minutes.
Hyperliquid's leaderboard file#
One GET, about 39 MB of JSON. Each row has ethAddress, accountValue, an optional displayName, and windowPerformances with pnl, roi and vlm for day, week, month and allTime. It is not part of the documented API, so its shape can change without notice.
import requests
rows = requests.get("https://stats-data.hyperliquid.xyz/Mainnet/leaderboard", timeout=60).json()["leaderboardRows"]
def month_pnl(row):
return float(dict(row["windowPerformances"])["month"]["pnl"])
for row in sorted(rows, key=month_pnl, reverse=True)[:10]:
print(row["ethAddress"], round(month_pnl(row)), row["accountValue"])It has no trades, no win rate and no dates of your own choosing. For those you need the fills.
Any window, from fills#
Ironflow ranks every wallet from its fills: realized PnL, volume, wins and losses, maker share and markets traded. Wallets with fewer than 5 fills in the window are left out.
curl "https://api.ironflow.sh/v1/analytics/leaderboard-pnl?from=-24h&limit=3&sort_by=realized_pnl"{
"from": 1794231097841, "to": 1794317497841, "sort_by": "realized_pnl",
"data": [
{ "address": "0xc609...ea03", "realized_pnl": 24688.52, "volume_usd": 54739.27,
"fills": 19, "wins": 12, "losses": 6, "win_rate": 0.667,
"pct_maker": 0.895, "markets_count": 5 },
...
]
}sort_by:realized_pnl(top winners),loss(biggest losers) orvolume.limitup to 200.fromandtotake Unix milliseconds or-7dstyle times.- Without a key the window is cut to the last 24 hours; check
fromin the answer. A free key reaches 14 days. - In an agent: the
get_pnl_leaderboardandget_top_traderstools onmcp.ironflow.sh/mcp.
One wallet in detail#
Hyperliquid's portfolio request returns one account's PnL history and clearinghouseState its open positions. Ironflow adds the PnL series, funding paid and trading behaviour for any address:
curl "https://api.ironflow.sh/v1/analytics/user-state?address=0xYOUR_ADDRESS"Hyperliquid's request types are on its info endpoint page.
Questions#
Does Hyperliquid have a leaderboard API?#
Not in its documented API: the info endpoint has no leaderboard request. Its leaderboard data is a public JSON file at stats-data.hyperliquid.xyz/Mainnet/leaderboard, about 39 MB, with PnL, ROI and volume per account for the day, week, month and all time.
How do I get every Hyperliquid trader address?#
No single Hyperliquid request lists all users. The leaderboard file had 48,064 accounts on 10 November 2026. Every address that traded is on its fills, so an indexed API can rank all of them: Ironflow's leaderboard-pnl ranks every wallet with at least 5 fills in the window.
Can I rank traders over my own dates?#
Not with Hyperliquid's file, which has four fixed windows. Ironflow's /v1/analytics/leaderboard-pnl takes from and to, and sorts by realized PnL, biggest loss or volume. Without a key it covers the last 24 hours, with a free key 14 days.
Can I see what a top trader holds now?#
Yes. Hyperliquid's clearinghouseState request returns one address's open positions. Ironflow's /v1/analytics/user-state and the get_user_state MCP tool return the same for any address.
Related guides#
- Hyperliquid trades and fills data: API, archive and history by wallet
- Hyperliquid SQL: query every fill, liquidation and transfer
- Hyperliquid API key: what it is and how to get one
- Hyperliquid API endpoints: which one to use
Free key14 days of history at 60 requests a minute. Without a key, the API reaches 24 hours back.
By requesting a key you agree to the Terms and API terms; see the Privacy Policy. We may email you when your key keeps hitting its limits; you can opt out at any time.