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

get/v1/whales/positioning

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

  • API planPro and above
  • Scopewhales:read
  • Cost2 units per item returned, at least one item's worth. The request first reserves limit x 2 units (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
Pro300,0001530050
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. 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 units per item returned, at least one item's worth. The request first reserves limit x 2 units (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.

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 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
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.

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