DH
4 min read·Updated 2026-06-14

Rank traders

Leaderboard of traders ranked by pnl, roi, or volume with capital, quality, and style cohort filters.

GET/networks/{network}/rankings/traders

Supported metrics are pnl, roi, and volume. The period is echoed in the response and defaults to 7d.

Capital cohorts

Filter by capital tags such as shrimp, fish, dolphin, shark, small_whale, whale, tidal_whale, leviathan.

capital

Quality cohorts

Filter by quality tags such as positive_expectancy, consistent_operator, high_quality, exceptional.

quality

Strategy style

Filter by strategy style such as lowDd, stableProfit, hiRiskHiReturn, aggrHiFreq, volatileStrategy.

style

Asset filter

Filter by a traded asset. Unknown assets return 404.

asset=BTC

Path Params
networkstringrequired

Network identifier. Only hyperliquid is supported.

Example: hyperliquid

Query Params
metricstring

Ranking metric: pnl, roi, or volume.

Example: roi

periodstring

Look-back period. Accepts Nd format. Default 7d.

Example: 30d

capitalstring

Capital cohort filter. Repeatable.

Example: whale

qualitystring

Quality cohort filter. Repeatable.

Example: high_quality

stylestring

Strategy style filter. Repeatable.

Example: lowDd

assetstring

Filter to wallets that have traded a specific asset.

Example: BTC

limitinteger

Maximum results to return.

Example: 25

Responses

200OK

Ranked trader list with key analytics for the requested period.

Schema
itemsobject[]

Ranked traders for the requested metric and period.

rankinteger

1-based rank within the result set.

addressstring

Wallet address.

labelstringnullable

Human label if DexHunt has one.

accountValuestring (decimal)

Total account value in USD.

pnlstring

PnL over the period in USD.

roistring

Return on investment percentage.

volumestring

Traded volume over the period in USD.

periodstring

Resolved look-back period echoed from the request.

metricstring

Ranking metric used — pnl, roi, or volume.

400Bad Request
401Unauthorized
404Not Found
500Server Error
Request
curl -sS "https://api.dexhunt.app/v1/networks/hyperliquid/rankings/traders?metric=roi&period=30d&quality=high_quality&asset=BTC&limit=3" \
  -H "X-API-Key: hlsk_your_developer_key"
Response
200 · OK
{
  "items": [
    {
      "rank": 1,
      "address": "0x1111111111111111111111111111111111111111",
      "label": null,
      "accountValue": "12500000.42",
      "pnl": "820000.12",
      "roi": "7.12",
      "volume": "98100000.50"
    }
  ],
  "period": "30d",
  "metric": "roi"
}