Contents

Trader leaderboard

Trader leaderboard from the official Hyperliquid leaderboard (PnL, ROI and volume of day / week / month / all-time; PnL is the change of the account with its sub-accounts and spot balances, so deposits and withdrawals do not count) plus what we observed: win rate and holding time from our position polls, max drawdown and Sharpe from Hyperliquid portfolio history (top traders), style tags and cohorts.

GET/api/v1/tradersEvery keyPaginated

Description

Only single trading accounts are listed (no vaults, dust or accounts without trading; ROI / Sharpe / drawdown sorts need more, rules says what applies). Names are self-chosen unless labelSource is a URL. Free keys: the top 100 of any sort with every column (full: false: no search, style filter or paging).

Who can call it

Available with every key and keyless (X-Blockmetric-Access: public). Keys of Free accounts get free-tier data (real-time feeds, 30 days of history, heatmap over time for every coin over the last 24 hours, liquidation levels now for every coin, the same as the free web plan); Pro and Desk keys the data of their plan; API Dev / API Pro raise the limits.

No key: 24 h
Free: 30 days
Pro: 365 days
Desk: 1095 days
API Dev: 365 days
API Pro: 1095 days

History window per plan. Limits: Authentication & limits.

Parameters

Parameters of /traders
Parameter	Description
`sort`string	pnl_day \| pnl_week \| pnl_month (default) \| pnl_all \| roi_week \| roi_month \| roi_all \| account_value \| vlm_month \| sharpe \| drawdown (smallest first).one of pnl_day, pnl_week, pnl_month, pnl_all, roi_week, roi_month, roi_all, account_value, vlm_month, sharpe, drawdown · default pnl_month
`search`string	Address prefix (0x…) or part of a displayed name (paid plans).
`style`string	scalper \| swing \| position \| high_turnover \| high_leverage \| mostly_long \| mostly_short (paid plans).one of scalper, swing, position, high_turnover, high_leverage, mostly_long, mostly_short
`minAccountValue`number	Minimum account value in USD (paid plans).≥ 0 · default 0
`limit`integer	Number of items, default 50, clamped to 1–500.1–500 · default 50
`cursor`string	Next page: the value of meta.nextCursor from the previous response (keep the other parameters unchanged). Cursors are signed: an edited cursor answers 400; paging stops at the plan history.
`fields`string	Comma-separated fields of every data.rows item to return, e.g. rank,address,pnl,roi (case-insensitive). All other fields are left out, so large lists get much smaller; an unknown name answers 400 with the list of fields. Default: every field.
`format`string	json (default: the { data, meta } envelope) \| csv (the rows with a header line; nested values as JSON text) \| ndjson (one JSON object per row and line). csv and ndjson carry the meta block in headers: Link rel="next" and X-Blockmetric-Next-Cursor (next page), X-Blockmetric-Next-After (forward polling), X-Blockmetric-Updated-At, X-Blockmetric-Warnings, X-Blockmetric-License. Errors stay JSON.one of json, csv, ndjson · default json

Response fields

Every success is { data, meta }; these are the fields of data. meta is the same on every endpoint.

Response fields of /traders
Field	Description
`rows[]`array of objects	The rows of this view.
`rows[].rank`integer	Rank in the current sort.
`rows[].address`string	Hyperliquid address, lowercase.
`rows[].label`string · nullable	Public label, else the self-chosen leaderboard name (unverified).
`rows[].labelSource`string · nullable	Source URL of a public label, or "hyperliquid-leaderboard".
`rows[].accountValue`number · nullable	Account value (USD).
`rows[].pnl`object	Hyperliquid leaderboard PnL per window (USD): the account with its sub-accounts and spot balances, deposits / withdrawals not counted.
`rows[].pnl.day`number · nullable	Last 24 hours.
`rows[].pnl.week`number · nullable	Last 7 days.
`rows[].pnl.month`number · nullable	Last 30 days.
`rows[].pnl.allTime`number · nullable	All time.
`rows[].roi`object	Hyperliquid leaderboard ROI per window (fraction).
`rows[].roi.day`number · nullable	Last 24 hours.
`rows[].roi.week`number · nullable	Last 7 days.
`rows[].roi.month`number · nullable	Last 30 days.
`rows[].roi.allTime`number · nullable	All time.
`rows[].vlm`object	Traded volume per window (USD).
`rows[].vlm.day`number · nullable	Last 24 hours.
`rows[].vlm.week`number · nullable	Last 7 days.
`rows[].vlm.month`number · nullable	Last 30 days.
`rows[].vlm.allTime`number · nullable	All time.
`rows[].observed`object	From the opens and closes our position polls saw (empty for free keys).
`rows[].observed.closes`integer	Position closes we observed.
`rows[].observed.wins`integer	Of those, closes with a profit.
`rows[].observed.winRate`number · nullable	wins / closes, from 10 closes on.
`rows[].observed.avgHoldMin`number · nullable	Average holding time in minutes (open → close pairs), from 3 pairs on.
`rows[].observed.holds`integer	Open→close pairs seen.
`rows[].observed.since`string (ISO 8601) · nullable	First observed event.
`rows[].risk`object · nullable	Risk figures from the Hyperliquid portfolio history (top traders), else null.
`rows[].risk.maxDrawdownUsd`number · nullable	Largest peak-to-trough fall of the account value in USD.
`rows[].risk.maxDrawdownPct`number · nullable	Fraction of the account value at the peak (0.17 = 17 %). Deprecated: use maxDrawdown (same value).
`rows[].risk.maxDrawdown`number · nullable	Largest fall as a fraction of the account value at the peak (0.17 = 17 %).
`rows[].risk.sharpe`number · nullable	Annualised mean / standard deviation of the 30-day portfolio returns, no risk-free rate.
`rows[].risk.fetchedAt`string (ISO 8601) · nullable	When the portfolio history was read.
`rows[].book`object · nullable	Open tracked positions of the wallet, else null.
`rows[].book.positionsUsd`number	Open tracked notional (USD).
`rows[].book.positions`integer	Number of positions.
`rows[].book.longShare`number · nullable	Long notional / total.
`rows[].book.avgLeverage`number · nullable	Notional-weighted.
`rows[].styles[]`array of string (enum)	Style tags from observed behaviour (scalper, swing, position, high_turnover, high_leverage, mostly_long, mostly_short).
`rows[].sizeCohort`"shrimp" \| "fish" \| "dolphin" \| "shark" \| "whale" · nullable	Size cohort by account value: shrimp < $10K, fish, dolphin, shark, whale ≥ $10M.
`rows[].pnlCohort`"top" \| "profitable" \| "flat" \| "losing" \| "rekt" · nullable	PnL cohort by all-time PnL: top ≥ +$1M, profitable, flat, losing, rekt ≤ −$1M.
`rows[].updatedAt`string (ISO 8601)	Leaderboard row time.
`total`integer	Rows matching the filters.
`updatedAt`string (ISO 8601) · nullable	Newest leaderboard run.
`riskUpdatedAt`string (ISO 8601) · nullable	Newest portfolio read (drawdown, Sharpe).
`full`boolean	false = free key: the top 100 of the chosen sort, every column, no search, style filter or paging.
`rules`string	Who the chosen sort lists.
`method`string	How the figures are computed, in plain words.

Errors

400invalid_param Invalid parameter
401unauthorized Missing or invalid API key
403plan_required Plan does not include this
403scope_required Key not scoped for this API
403ip_not_allowed Address not on the IP allowlist of the key
403origin_not_allowed Key used from a browser origin it does not allow
403source_restricted Exchange data not redistributed
403https_required https required
429rate_limited Per-minute limit reachedretry
429daily_limit_exceeded Daily limit reachedretry
429stream_limit Too many open streamsretry
500internal_error Internal errorretry

Methodology

Smart money (how it is computed and its limits)

Request

curl -s -H "X-Blockmetric-Access: public" \
  "https://api.blockmetric.io/v1/traders?sort=pnl_month&limit=25"

Example response

HTTP 200Real data from 2026-10-28 20:25 UTC

{
  "data": {
    "rows": [
      {
        "rank": 1,
        "address": "0x5b5d51203a0f9079f8aeb098a6523a13f298c060",
        "label": "Abraxas Capital (reported)",
        "labelSource": "https://info.arkm.com/research/abraxas-capital-still-shorting-500m-of-crypto",
        "accountValue": 218661360.67,
        "pnl": {
          "day": -1465730.63325,
          "week": 44257018.0382,
          "month": 112305737.722,
          "allTime": 184126724.078
        },
        "roi": {
          "day": -0.0066585654,
          "week": 0.269263319,
          "month": 0.6463733379,
          "allTime": 0.4963734104
        },
        "vlm": {
          "day": 8913480.21,
          "week": 52370497.51,
          "month": 213644821.23,
          "allTime": 5855538273.66
        },
        "observed": {
          "closes": 1,
          "wins": 1,
          "winRate": null,
          "avgHoldMin": null,
          "holds": 0,
          "since": "2026-10-23T00:27:13.150Z"
        },
        "risk": {
          "maxDrawdownUsd": 45751143.2,
          "maxDrawdownPct": 0.1648435951,
          "sharpe": 4.5903042327,
          "fetchedAt": "2026-10-28T20:24:09.857Z",
          "maxDrawdown": 0.1648435951
        },
        "book": {
          "positionsUsd": 720066402.26,
          "positions": 26,
          "longShare": 0.0010455763,
          "avgLeverage": 4.9254768902
        },
        "styles": [
          "mostly short"
        ],
        "sizeCohort": "whale",
        "pnlCohort": "top",
        "updatedAt": "2026-10-28T20:25:32.910Z"
      },
      {
        "rank": 2,
        "address": "0xb83de012dba672c76a7dbbbf3e459cb59d7d6e36",
        "label": null,
        "labelSource": null,
        "accountValue": 203523548.9,
        "pnl": {
          "day": -2114654.47643,
          "week": 34009183.7954,
          "month": 86744777.0968,
          "allTime": 137348648.242
        },
        "roi": {
          "day": -0.0144410549,
          "week": 0.2243557408,
          "month": 0.5661464986,
          "allTime": 0.8240901682
        },
        "vlm": {
          "day": 1924151.4,
          "week": 31476927.24,
          "month": 436329314.43,
          "allTime": 5929320806.8
        },
        "observed": {
          "closes": 0,
          "wins": 0,
          "winRate": null,
          "avgHoldMin": null,
          "holds": 0,
          "since": "2026-10-23T00:27:14.641Z"
        },
        "risk": {
          "maxDrawdownUsd": 36768839.21,
          "maxDrawdownPct": 0.140612079,
          "sharpe": 3.7726687757,
          "fetchedAt": "2026-10-28T20:24:52.214Z",
          "maxDrawdown": 0.140612079
        },
        "book": {
          "positionsUsd": 599438215.1,
          "positions": 33,
          "longShare": 0.0011046405,
          "avgLeverage": 4.568620596
        },
        "styles": [
          "mostly short"
        ],
        "sizeCohort": "whale",
        "pnlCohort": "top",
        "updatedAt": "2026-10-28T20:25:32.910Z"
      }
    ],
    "total": 15492,
    "updatedAt": "2026-10-28T20:25:32.910Z",
    "riskUpdatedAt": "2026-10-28T22:43:43.035Z",
    "full": true,
    "rules": "Listed: single accounts only (no vaults, no HLP), account value $100+, traded in the last 30 days, 30-day PnL at most 20× the 30-day volume.",
    "method": "Leaderboard numbers (PnL, ROI, volume, account value) are copied from the official Hyperliquid leaderboard (read every 6 h). Hyperliquid counts an account together with its sub-accounts and its spot balances: PnL is the change of that account in the window without deposits, withdrawals and transfers, so price changes of tokens held count too. ROI is Hyperliquid's own figure for the window. Names are self-chosen by the account owner (unverified) unless a public label with a source is shown. Win rate = closes in profit ÷ closes (in profit: the unrealised PnL at our last poll before the close was above 0; liquidations count as losses), from the opens and closes our position polls saw since we track the wallet, shown from 10 closes; average holding time from 3 positions we saw open and close. Max drawdown and Sharpe come from Hyperliquid's 30-day portfolio history of the address (about one point every 16 h): drawdown = largest fall of the cumulative PnL from an earlier high ÷ account value at that high; Sharpe = mean ÷ sample standard deviation of the returns r = PnL change ÷ account value at the start of each interval, × √(intervals per year), no risk-free rate. That history covers one address without its sub-accounts, so both are shown only where its 30-day PnL is within 25 % of the leaderboard PnL."
  },
  "meta": {
    "updatedAt": "2026-10-28T20:25:32.910Z",
    "source": "hyperliquid",
    "sources": [
      "hyperliquid"
    ],
    "plan": "api_dev",
    "delayMinutes": 0,
    "commercial": false,
    "license": {
      "id": "internal",
      "display": false,
      "attributionRequired": false,
      "attribution": null,
      "redistribution": false,
      "mauCap": null,
      "terms": "https://blockmetric.io/terms#api-license"
    },
    "attribution": {
      "text": "Data by Blockmetric · Source: Blockmetric Research",
      "url": "https://blockmetric.io/"
    },
    "access": {
      "historyDays": 365,
      "historyFrom": "2025-10-28T23:36:00.000Z"
    },
    "nextCursor": "<cursor>",
    "nextUrl": "https://api.blockmetric.io/v1/traders?cursor=<cursor>"
  }
}

More options: open in the explorer · SDK method traders() / traders()

Code snippets in these docs are licensed under MIT-0: copy them into your own code without attribution. The SDKs, CLI and MCP server will be, once published, Apache-2.0; the name Blockmetric is not licensed (forks must be renamed). Data from the API is governed by the API terms; third-party exchange data by the exchange’s terms.