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
Market data

Funding rate history

get/v1/market/funding

https://data.decryptr.ai/v1/market/funding

  • API planStarter and above
  • Scopederivatives:read
  • Cost1 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. How units are counted
  • CreditIncludes data derived from Hyperliquid and Binance USD-M public market 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

Funding rate history for one perpetual, newest first, from Hyperliquid (hourly, with premium) or Binance USD-M (every 8 hours, with the mark price). Not found when the archive holds none.

Served during Decryptr's friends-only testing: the exchange, CoinGecko and Coinalyze data behind it is used on Decryptr's own risk acceptance of those sources' terms, so this endpoint may be restricted or withdrawn before general availability. Keep the attribution line and meta.source with the data.

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.

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}$
source?string

The venue: hyperliquid (default) or binance (Binance USD-M).

Value in"hyperliquid""binance"
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 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
next_cursor*|

Pass as cursor for the next page. null when this is the last page.

attribution*string

Attribution you must keep with this data.

disclaimer*string

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

meta*

Where the figures come from.

curl -X GET 'https://data.decryptr.ai/v1/market/funding?asset=BTC&source=hyperliquid&since=2026-10-20T00%3A00%3A00Z&until=2026-10-23T12%3A00%3A00Z&cursor=eyJ0IjoiMjAyNi0xMC0yM1QxMDowMDowMC4wMDBaIn0&limit=10'
Example Response
{  "data": [    {      "asset": "BTC",      "source": "hyperliquid",      "at": "2026-10-23T11:00:00.000Z",      "funding_rate": 0.0000125,      "premium": 0.0001,      "mark_price": null    },    {      "asset": "BTC",      "source": "hyperliquid",      "at": "2026-10-23T10:00:00.000Z",      "funding_rate": 0.00001,      "premium": 0.0001,      "mark_price": null    }  ],  "as_of": "2026-10-23T12:12:30.000Z",  "next_cursor": null,  "attribution": "Includes data derived from Hyperliquid and Binance USD-M public market data.",  "disclaimer": "Information only, not financial advice.",  "meta": {    "source": "Hyperliquid public data, from the Decryptr permanent archive"  }}

Candles (OHLCV) GET

Open, high, low, close and volume candles for one asset, newest first. timeframe is 1m, 5m, 15m, 1h (default), 4h or 1d; source is hyperliquid (default) or binance (Binance USD-M). A page reads at most limit candles, so large histories are paged with next_cursor; next_cursor can be set even when a page holds fewer than limit candles (a gap in trading). History is limited by plan (developer 7 days, starter 30, pro 365, business all). Not found when the archive holds no such candles. Served during Decryptr's friends-only testing: the exchange, CoinGecko and Coinalyze data behind it is used on Decryptr's own risk acceptance of those sources' terms, so this endpoint may be restricted or withdrawn before general availability. Keep the attribution line and meta.source with the data. 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 `coins:read` and the developer plan or above.

Open interest history GET

Open interest for one perpetual every 5 minutes, newest first, in the coin's units and in US dollars, from Hyperliquid (dollars at the mark price) or Binance USD-M. Not found when the archive holds none. Served during Decryptr's friends-only testing: the exchange, CoinGecko and Coinalyze data behind it is used on Decryptr's own risk acceptance of those sources' terms, so this endpoint may be restricted or withdrawn before general availability. Keep the attribution line and meta.source with the data. 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.