Sign in
Hyperliquid

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 (main_dex or omit for the NATIVE market only — note /trades/aggregate omits to ALL markets — or a builder market: xyz, flx, vntl, hyna, km, abcd, cash, para, mkts).

Paginated with limit/offset; meta.total is the exact count matching your filters.

get/gateway/v1/hyperliquid/leaderboard

Query parameters

time_range'1d' | '7d' | '30d' | '90d' | 'all'

Window to rank over. Default all (data starts 2025-08-01).

Window to rank over. Default all (data starts 2025-08-01).

sort_by'total_pnl' | 'win_rate' | 'volume_traded'

Rank by this metric. Always sorted descending.

Rank by this metric. Always sorted descending.

min_tradesinteger

Only traders with at least this many trades. Defaults to 5; pass 0 for the full population.

Only traders with at least this many trades. Defaults to 5; pass 0 for the full population.

min_days_activeinteger

Only traders active at least this many days (0 = no filter).

Only traders active at least this many days (0 = no filter).

min_account_age_daysinteger

Only accounts at least this old, in days (0 = no filter).

Only accounts at least this old, in days (0 = no filter).

min_human_scoreinteger

Only traders scoring at least this, 0-100 (0 = no filter).

Only traders scoring at least this, 0-100 (0 = no filter).

dex'main_dex' | 'xyz' | 'flx' | 'vntl' | 'hyna' | 'km' | 'abcd' | 'cash' | 'para' | 'mkts'

Market to rank within: main_dex (or omit) for the native market ONLY, or a builder market — one of: xyz, flx, vntl, hyna, km, abcd, cash, para, mkts. NOTE: the omit default differs from /trades/aggregate, where omitting dex aggregates across ALL markets.

Market to rank within: main_dex (or omit) for the native market ONLY, or a builder market — one of: xyz, flx, vntl, hyna, km, abcd, cash, para, mkts. NOTE: the omit default differs from /trades/aggregate, where omitting dex aggregates across ALL markets.

limitinteger

Results per page (1-100).

Results per page (1-100).

offsetinteger

Results to skip.

Results to skip.

Response

OK

$schemastring uri

A URL to the JSON Schema for this object.

Example response

{
  "$schema": "https://example.com/schemas/DataResponseHyperliquidTrader.json"
}

Changes

No recorded changes to this endpoint across all 1 revision of this API.