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

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 call per item returned, at least one item's worth. The request first reserves limit x 1 calls (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.

How calls are counted

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 calls per request (Developer 10, Starter 25, Pro 50, Business 100), so at most max_page divided by this endpoint's calls per item. Default 20, or that maximum if lower. The request reserves limit x calls 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.

Example Request
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."}

Whale positioning per coin GET

Derived from Hyperliquid public data; keep the attribution line with it. Never includes Decryptr users' own wallets. Long and short USD held by large traders per coin, biggest first. A coin needs at least 3 wallets. Cost: 2 calls per item returned, at least one item's worth. The request first reserves limit x 2 calls (and is refused with 429 if that many are not available), then pays only for what came back. Needs scope `whales:read` and the pro plan or above.

Verified traders who share their record GET

Person-level data (on since 23 Oct 2026): only public accounts that have not opted out (API visibility), never private, banned or suspended accounts, and only content created on or after Decryptr's content date. Authors carry a pseudonymous id (trd_). When content is deleted, hidden or its author leaves, /v1/tombstones lists it: delete your copy within 24 hours. Verified traders who switched on Share my record through the API: verification, 30-day and all-time return on a verified wallet, win rate, calls and Levels, newest listing first. Cost: 3 calls per item returned, at least one item's worth. The request first reserves limit x 3 calls (and is refused with 429 if that many are not available), then pays only for what came back. Needs scope `traders:read` and the pro plan or above.