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

Footprint candles

Derived from Hyperliquid public data; keep the attribution line with it. Never includes Decryptr users' own wallets. Footprint candles: volume bought and sold at each price level with the point of control, newest first. No open, high, low or close. Kept for 3 days.

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 orderflow: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

asset*string

Asset symbol, letters and digits, case-insensitive (required).

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

Candle length in minutes: 1 (default) or 5. Kept for 3 days.

Value in"1""5"
since?string

Only items at or after this time (ISO 8601 with offset). Must be inside your plan's history (Developer 7 days, Starter 30, Pro 365, Business all). Defaults to the start of your history.

Formatdate-time
until?string

Only items at or before this time (ISO 8601 with offset). Defaults to now; on Developer it is capped 60 minutes before now.

Formatdate-time
cursor?string

next_cursor from the previous page, passed back as it is. Opaque: do not build or change it.

Lengthlength <= 300
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
next_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.

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/orderflow/footprint?asset=BTC&tf=1&since=2026-10-20T00%3A00%3A00Z&until=2026-10-23T12%3A00%3A00Z&cursor=eyJ0IjoiMjAyNi0xMC0yM1QxMDowMDowMC4wMDBaIn0&limit=10'
Example Response
{  "data": [    {      "asset": "BTC",      "timeframe_minutes": 1,      "open_time": "2026-10-23T12:30:00.000Z",      "taker_bought": 100,      "taker_sold": 90,      "delta": 10,      "trades": 40,      "partial": false,      "tick": 0.5,      "poc": 2001,      "bins": [        [          4001,          30,          25        ],        [          4002,          40,          35        ],        [          4003,          30,          30        ]      ]    },    {      "asset": "BTC",      "timeframe_minutes": 1,      "open_time": "2026-10-23T12:29:00.000Z",      "taker_bought": 103,      "taker_sold": 94,      "delta": 9,      "trades": 41,      "partial": false,      "tick": 0.5,      "poc": 2001.5,      "bins": [        [          4001,          30,          25        ],        [          4002,          41,          35        ],        [          4003,          30,          30        ]      ]    },    {      "asset": "BTC",      "timeframe_minutes": 1,      "open_time": "2026-10-23T12:28:00.000Z",      "taker_bought": 106,      "taker_sold": 98,      "delta": 8,      "trades": 42,      "partial": false,      "tick": 0.5,      "poc": 2002,      "bins": [        [          4001,          30,          25        ],        [          4002,          42,          35        ],        [          4003,          30,          30        ]      ]    }  ],  "next_cursor": "eyJ0IjoiMjAyNi0xMC0yM1QxMjoyODowMC4wMDBaIn0",  "as_of": "2026-10-23T12:30:30.000Z",  "attribution": "Includes data derived from Hyperliquid public data.",  "disclaimer": "Information only, not financial advice or a recommendation."}

Order flow delta per candle GET

Derived from Hyperliquid public data; keep the attribution line with it. Never includes Decryptr users' own wallets. Per candle: volume bought and sold by takers, delta and trade count, newest first. No prices. Candles are kept for 3 days. 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 `orderflow:read` and the starter plan or above.

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 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 `derivatives:read` and the starter plan or above.