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

Whale positioning per coin

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.

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

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
attribution*"Includes data derived from Hyperliquid public data."

Attribution you must keep with this data.

Value in"Includes data derived from Hyperliquid public data."
disclaimer*string

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

Example Request
curl -X GET 'https://data.decryptr.ai/v1/whales/positioning?limit=10'
Example Response
{  "data": [    {      "rank": 1,      "asset": "BTC",      "long_usd": 90000000,      "short_usd": 60000000,      "long_wallets": 30,      "short_wallets": 22,      "as_of": "2026-10-23T12:36:00.000Z"    },    {      "rank": 2,      "asset": "ETH",      "long_usd": 70000000,      "short_usd": 50000000,      "long_wallets": 25,      "short_wallets": 18,      "as_of": "2026-10-23T12:36:00.000Z"    },    {      "rank": 3,      "asset": "SOL",      "long_usd": 50000000,      "short_usd": 40000000,      "long_wallets": 20,      "short_wallets": 14,      "as_of": "2026-10-23T12:36:00.000Z"    }  ],  "as_of": "2026-10-23T12:36:30.000Z",  "attribution": "Includes data derived from Hyperliquid public data.",  "disclaimer": "Information only, not financial advice or a recommendation."}

Whale positions GET

Derived from Hyperliquid public data; keep the attribution line with it. Never includes Decryptr users' own wallets. Open positions held by large traders, with pseudonymous wallet ids, side and size in USD. No addresses, names or entry prices. 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.

Hyperliquid leaderboard GET

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.