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

Liquidation levels

get/v1/liquidations/{asset}

https://data.decryptr.ai/v1/liquidations/{asset}

  • API planStarter and above
  • Scopeliquidations:read
  • Cost3 units, also when not found. How units are counted
  • CreditIncludes data derived from Hyperliquid public data.

Rate limits by plan

PlanUnits a monthPer secondPer minuteMost per request
Starter50,00056025
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.
  • 404No such item. A lookup is still charged what it asked for.
  • 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. Where open positions on one asset would be liquidated, summed into equal price buckets, from positions read in the last 30 minutes. Not found when fewer than 5 accounts hold the asset.

Cost: 3 units, also when not found.

Needs scope liquidations:read and the starter 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_....

Path Parameters

asset*string

Asset symbol, letters and digits, case-insensitive.

Match^[A-Za-z0-9]{1,15}$

Query Parameters

buckets?integer

Number of price buckets, 5 to 200. Default 50.

Range5 <= value <= 200

Response Body

OK.

application/json
  1. response
data*

Where open Hyperliquid positions would be liquidated, summed into equal price buckets, computed from positions read in the last 30 minutes. Never includes Decryptr users' own wallets. Derived from Hyperliquid public data.

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/liquidations/BTC?buckets=50'
Example Response
{  "data": {    "asset": "BTC",    "as_of": "2026-10-23T12:26:00.000Z",    "price_floor": 1000,    "bucket_size": 10,    "long_usd": [      150000,      100000,      50000,      0,      0,      0    ],    "short_usd": [      0,      0,      0,      40000,      80000,      120000    ],    "positions": 420,    "accounts": 96  },  "as_of": "2026-10-23T12:26:30.000Z",  "attribution": "Includes data derived from Hyperliquid public data.",  "disclaimer": "Information only, not financial advice or a recommendation."}