Whale positions
get/v1/whales/positions
https://data.decryptr.ai/v1/whales/positions
- API planPro and above
- Scope
whales: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
| Plan | Units a month | Per second | Per minute | Most per request |
|---|---|---|---|---|
| Pro | 300,000 | 15 | 300 | 50 |
| Business | 1,500,000 | 40 | 900 | 100 |
| Enterprise | Agreed | Agreed | Agreed | Agreed |
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. Open positions held by large traders, with pseudonymous wallet ids, side and size in USD. No addresses, names or entry prices.
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.
AuthorizationBearer <dcr_live_<8 hex>_<43 base64url> or dcr_test_...>Your API key as a Bearer token: Authorization: Bearer dcr_live_....
asset?stringAsset symbol, letters and digits, case-insensitive (BTC, ETH, SOL).
^[A-Za-z0-9]{1,15}$cursor?stringnext_cursor from the previous page, passed back as it is. Opaque: do not build or change it.
length <= 300limit?integerItems 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.
1 <= value <= 100OK.
application/json- response
data*array<>as_of*stringWhen the response was made.
date-timenext_cursor*|Pass as cursor for the next page. null when this is the last page.
attribution*"Includes data derived from Hyperliquid public data."Attribution you must keep with this data.
"Includes data derived from Hyperliquid public data."disclaimer*stringPlain-language notice. Information only, not financial advice.
curl -X GET 'https://data.decryptr.ai/v1/whales/positions?asset=BTC&cursor=eyJ0IjoiMjAyNi0xMC0yM1QxMDowMDowMC4wMDBaIn0&limit=10'{ "data": [ { "wallet_id": "whl_000000000000000000000001", "asset": "BTC", "side": "long", "notional_usd": 2000000, "seen_at": "2026-10-23T12:34:00.000Z" }, { "wallet_id": "whl_000000000000000000000002", "asset": "ETH", "side": "short", "notional_usd": 2150000, "seen_at": "2026-10-23T12:33:00.000Z" }, { "wallet_id": "whl_000000000000000000000003", "asset": "SOL", "side": "long", "notional_usd": 2300000, "seen_at": "2026-10-23T12:32:00.000Z" } ], "next_cursor": "eyJoIjoid2hsXzAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMy5TT0wifQ", "as_of": "2026-10-23T12:34:30.000Z", "attribution": "Includes data derived from Hyperliquid public data.", "disclaimer": "Information only, not financial advice or a recommendation."}Funding and open interest GET
Derived from Hyperliquid public data; keep the attribution line with it. Never includes Decryptr users' own wallets. Hourly funding rate, premium and open interest for one perpetual, newest first. No prices. 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 `derivatives:read` and the starter plan or above.
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 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.