Don't invest unless you're prepared to lose all the money you invest. This is a high-risk investment and you should not expect to be protected if something goes wrong. Take 2 mins to learn more.

DecryptrDevelopers
Derivatives

Hyperliquid leaderboard

get/v1/whales/leaderboard

https://data.decryptr.ai/v1/whales/leaderboard

  • API planBusiness and above
  • Scopewhales:read
  • Cost1 unit per item returned, at least one item's worth. The request first reserves limit x 1 unit (and is refused with 429 if that many are not available), then pays only for what came back. How units are counted
  • CreditIncludes data derived from Hyperliquid public data.

Rate limits by plan

PlanUnits a monthPer secondPer minuteMost per request
Business1,500,00040900100
EnterpriseAgreedAgreedAgreedAgreed

A 429 carries the full rate-limit header set and a Retry-After. Rate limits

Errors

  • 400The request was refused before any data was read. Nothing is charged.
  • 401No usable key. Nothing is charged.
  • 402The account cannot use the API until billing is sorted. Nothing is charged.
  • 403The key may not use this endpoint. Nothing is charged.
  • 429A limit was reached (units or streams). Nothing was read and nothing is charged. Wait Retry-After seconds, back off with jitter, or ask for fewer items.
  • 500Something failed on our side. Nothing is charged. Retry with backoff.
  • 503The API is switched off, busy, or a query ran too long. Nothing is charged. Retry after Retry-After seconds.

Errors follow RFC 9457. Every error code

Derived from Hyperliquid public data; keep the attribution line with it. Hyperliquid's public leaderboard for a window with pseudonymous wallet ids: account value, profit, return and volume. Never addresses, display names or Decryptr users' own wallets.

Cost: 1 unit per item returned, at least one item's worth. The request first reserves limit x 1 unit (and is refused with 429 if that many are not available), then pays only for what came back.

Needs scope whales:read and the business plan or above.

Authorization

headerAuthorizationBearer <dcr_live_<8 hex>_<43 base64url> or dcr_test_...>

Your API key as a Bearer token: Authorization: Bearer dcr_live_....

Query Parameters

window?string

Hyperliquid's window. Default week.

Value in"day""week""month""allTime"
limit?integer

Items to return, 1 to 100. Your plan allows max_page units per request (Developer 10, Starter 25, Pro 50, Business 100), so at most max_page divided by this endpoint's units per item. Default 20, or that maximum if lower. The request reserves limit x units per item before it runs: ask only for what you need.

Range1 <= value <= 100

Response Body

OK.

application/json
  1. response
data*array<>
as_of*string

When the response was made.

Formatdate-time
window*string

The window asked for.

attribution*string

Attribution you must keep with this data.

disclaimer*string

Plain-language notice. Information only, not financial advice.

curl -X GET 'https://data.decryptr.ai/v1/whales/leaderboard?window=week&limit=10'
Example Response
{  "data": [    {      "rank": 1,      "source_rank": 1,      "wallet_id": "whl_000000000000000000000001",      "account_value_usd": 9000000,      "pnl_usd": 2400000,      "roi_pct": 24.5,      "volume_usd": 310000000,      "updated_at": "2026-10-23T12:00:00.000Z"    },    {      "rank": 2,      "source_rank": 2,      "wallet_id": "whl_000000000000000000000002",      "account_value_usd": 8880000,      "pnl_usd": 2360000,      "roi_pct": 24.2,      "volume_usd": 306000000,      "updated_at": "2026-10-23T12:00:00.000Z"    },    {      "rank": 3,      "source_rank": 3,      "wallet_id": "whl_000000000000000000000003",      "account_value_usd": 8760000,      "pnl_usd": 2320000,      "roi_pct": 23.9,      "volume_usd": 302000000,      "updated_at": "2026-10-23T12:00:00.000Z"    }  ],  "as_of": "2026-10-23T12:40:30.000Z",  "window": "week",  "attribution": "Includes data derived from Hyperliquid public data.",  "disclaimer": "Information only, not financial advice or a recommendation."}