Deribit
Deribit public data, including DVOL — the crypto volatility index — at one-second resolution, plus options instruments and index prices.
Book Summary
Top of book, open interest and 24h volume for every Deribit instrument in one
/v1/finance:deribit/book-summaryParameters
| Name | Type | In | Description |
|---|---|---|---|
| currency | enum | query | Settlement currency. Default BTC. One of BTC, ETH, USDC, USDT, EURR. |
| kind | enum | query | Instrument kind. Omit for every kind. One of future, option, spot, future_combo, option_combo. |
Example response
{"project":"finance:deribit", "data": {"kind":"future","count":13, "items": [ {"date":"2026-08-20T14:59:36.039Z","time":1787237976039,"low24h":66152.5,"markIv":null,"symbol":"BTC-30OCT26","volume":79.60912343,"high24h":72970,"askPrice":72350,"bidPrice":72327.5,"midPrice":72338.75,"lastPrice":72238.5,"markPrice":72348.81,"volumeUsd":5595640,"baseCurrency":"BTC","openInterest":8088840,"quoteCurrency":"USD","volumeNotional":5595640,"underlyingPrice":null,"priceChangePct24h":8.6579,"estimatedDeliveryPrice":71740.86 }, {"date":"2026-08-20T14:59:36.039Z","time":1787237976039,"low24h":68405,"markIv":null,"symbol":"BTC-25JUN27","volume":84.9230532,"high24h":75140,"askPrice":74415,"bidPrice":74355,"midPrice":74385,"lastPrice":74115,"markPrice":74392.24,"volumeUsd":6136400,"baseCurrency":"BTC","openInterest":10423000,"quoteCurrency":"USD","volumeNotional":6136400,"underlyingPrice":null,"priceChangePct24h":8.2484,"estimatedDeliveryPrice":71740.86 }, {"date":"2026-08-20T14:59:36.039Z","time":1787237976039,"low24h":65955,"markIv":null,"symbol":"BTC-23AUG26","volume":130.46758673,"high24h":72395,"askPrice":71740,"bidPrice":71715,"midPrice":71727.5,"lastPrice":71727.5,"markPrice":71737.15,"volumeUsd":9080690,"baseCurrency":"BTC","openInterest":8264000,"quoteCurrency":"USD","volumeNotional":9080690,"underlyingPrice":null,"priceChangePct24h":8.7522,"estimatedDeliveryPrice":71740.86 } ],"dataset":"book-summary","currency":"BTC","provider":"deribit" },"timestamp":"2026-08-20T14:59:35Z"}
Errors
- 401Missing or invalid x-api-key
- 404Not found or private
- 429Rate limit or monthly quota reached
Funding Rate History
Hourly funding for one Deribit perpetual, with the index it was struck on.
/v1/finance:deribit/funding-rate-historyParameters
| Name | Type | In | Description |
|---|---|---|---|
| symbol | string | query | Perpetual instrument name. |
| start | string | query | Oldest hour to include. Epoch ms/s or ISO date. Defaults to seven days back. |
| end | string | query | Newest hour to include. Epoch ms/s or ISO date. Defaults to now. |
Example response
{"project":"finance:deribit", "data": {"count":168, "items": [ {"date":"2026-08-13T01:00:00.000Z","time":1786582800000,"indexPrice":63495.11,"interest1h":0.000007511698674394949,"interest8h":0.00004911071730031578,"previousIndexPrice":63413.47 }, {"date":"2026-08-13T02:00:00.000Z","time":1786586400000,"indexPrice":63391.67,"interest1h":0.0000030121484716520185,"interest8h":0.00004117415585266742,"previousIndexPrice":63495.11 }, {"date":"2026-08-13T03:00:00.000Z","time":1786590000000,"indexPrice":63483.87,"interest1h":0.0000015973149776453194,"interest8h":0.00003248514867255686,"previousIndexPrice":63391.67 }, {"date":"2026-08-13T04:00:00.000Z","time":1786593600000,"indexPrice":63584,"interest1h":0.0000024490050545234122,"interest8h":0.000030038661823743066,"previousIndexPrice":63483.87 }, {"date":"2026-08-13T05:00:00.000Z","time":1786597200000,"indexPrice":63628.5,"interest1h":0.0000049281227417091035,"interest8h":0.00003133237488612422,"previousIndexPrice":63584 }, {"date":"2026-08-13T06:00:00.000Z","time":1786600800000,"indexPrice":63813.23,"interest1h":0.0000024846883603425967,"interest8h":0.00003232543799943846,"previousIndexPrice":63628.5 } ],"symbol":"BTC-PERPETUAL","dataset":"funding-rate-history","provider":"deribit" },"timestamp":"2026-08-20T14:59:35Z"}
Errors
- 401Missing or invalid x-api-key
- 404Not found or private
- 429Rate limit or monthly quota reached
Historical Volatility
Realised volatility for one Deribit currency — the backward-looking twin of
/v1/finance:deribit/historical-volatilityParameters
| Name | Type | In | Description |
|---|---|---|---|
| currency | enum | query | Index currency. Default BTC. One of BTC, ETH, USDC, USDT, EURR. |
Example response
{"project":"finance:deribit", "data": {"count":384, "items": [ {"date":"2026-08-04T17:00:00.000Z","time":1785862800000,"volatility":28.69387387574387 }, {"date":"2026-08-04T17:00:00.000Z","time":1785862800000,"volatility":28.69387387574387 }, {"date":"2026-08-04T18:00:00.000Z","time":1785866400000,"volatility":28.71583025957184 }, {"date":"2026-08-04T19:00:00.000Z","time":1785870000000,"volatility":28.70983568463423 }, {"date":"2026-08-04T20:00:00.000Z","time":1785873600000,"volatility":28.71183839968203 }, {"date":"2026-08-04T21:00:00.000Z","time":1785877200000,"volatility":28.70813156705442 } ],"dataset":"historical-volatility","currency":"BTC","provider":"deribit" },"timestamp":"2026-08-20T14:59:35Z"}
Errors
- 401Missing or invalid x-api-key
- 404Not found or private
- 429Rate limit or monthly quota reached
Index Price Names
Every index name Deribit publishes — the input vocabulary for index-price.
/v1/finance:deribit/index-price-namesParameters
| Name | Type | In | Description |
|---|---|---|---|
| query | string | query | Filter the names by substring. |
Example response
{"project":"finance:deribit", "data": {"count":10, "items": [ "btc_usd", "btc_usdc", "btc_usdt", "drbfix-btc_usdc", "eth_btc", "btc_eurr" ],"query":"btc","total":344,"dataset":"index-price-names","provider":"deribit" },"timestamp":"2026-08-20T14:59:35Z"}
Errors
- 401Missing or invalid x-api-key
- 404Not found or private
- 429Rate limit or monthly quota reached
Index Price
The spot index Deribit settles one contract family against.
/v1/finance:deribit/index-priceParameters
| Name | Type | In | Description |
|---|---|---|---|
| indexName | string | query | Index name. The full list is the index-price-names endpoint. |
Example response
{"project":"finance:deribit", "data": {"dataset":"index-price","provider":"deribit","indexName":"btc_usd","indexPrice":71770.14,"estimatedDeliveryPrice":71770.14 },"timestamp":"2026-08-20T14:59:35Z"}
Errors
- 401Missing or invalid x-api-key
- 404Not found or private
- 429Rate limit or monthly quota reached
Instruments
Contract specifications for one Deribit currency — futures, options or spot.
/v1/finance:deribit/instrumentsParameters
| Name | Type | In | Description |
|---|---|---|---|
| currency | enum | query | Settlement currency, or any for every one. Default BTC. One of BTC, ETH, USDC, USDT, EURR, any. |
| kind | enum | query | Instrument kind. Omit for every kind. One of future, option, spot, future_combo, option_combo. |
| expired | enum | query | Return expired instruments instead of live ones. Default false. One of true, false. |
Example response
{"project":"finance:deribit", "data": {"kind":"future","count":13, "items": [ {"kind":"future","state":"open","symbol":"BTC-PERPETUAL","tickSize":0.5,"expiryDate":"3000-01-01T08:00:00.000Z","expiryTime":32503708800000,"futureType":"reversed","priceIndex":"btc_usd","maxLeverage":50,"baseCurrency":"BTC","contractSize":10,"creationDate":"2018-08-14T10:24:47.000Z","creationTime":1534242287000,"quoteCurrency":"USD","instrumentType":"reversed","minTradeAmount":10,"counterCurrency":"USD","makerCommission":0.00015,"takerCommission":0.00035,"settlementPeriod":"perpetual","settlementCurrency":"BTC","blockTradeMinAmount":200000,"blockTradeCommission":0.00025 }, {"kind":"future","state":"open","symbol":"BTC-21AUG26","tickSize":2.5,"expiryDate":"2026-08-21T08:00:00.000Z","expiryTime":1787299200000,"futureType":"reversed","priceIndex":"btc_usd","maxLeverage":25,"baseCurrency":"BTC","contractSize":10,"creationDate":"2026-07-30T08:00:13.000Z","creationTime":1785398413000,"quoteCurrency":"USD","instrumentType":"reversed","minTradeAmount":10,"counterCurrency":"USD","makerCommission":0.00015,"takerCommission":0.00035,"settlementPeriod":"week","settlementCurrency":"BTC","blockTradeMinAmount":200000,"blockTradeCommission":0.00025 } ],"dataset":"instruments","expired":false,"currency":"BTC","provider":"deribit" },"timestamp":"2026-08-20T14:59:35Z"}
Errors
- 401Missing or invalid x-api-key
- 404Not found or private
- 429Rate limit or monthly quota reached
Order Book
Depth for one Deribit instrument, plus the funding, open interest, mark and
/v1/finance:deribit/order-bookParameters
| Name | Type | In | Description |
|---|---|---|---|
| symbol | string | query | Instrument name, Deribit's own form. |
| depth | enum | query | Levels per side. Default 10. One of 1, 5, 10, 20, 50, 100, 1000, 10000. |
Example response
{"project":"finance:deribit", "data": { "asks": [ {"size":7800,"price":72195 }, {"size":6000,"price":72195.5 }, {"size":1790,"price":72197 }, {"size":30580,"price":72198 }, {"size":42600,"price":72198.5 }, {"size":6000,"price":72199 } ], "bids": [ {"size":17160,"price":72194.5 }, {"size":10000,"price":72194 }, {"size":6000,"price":72192 }, {"size":350,"price":72190 }, {"size":580,"price":72188 }, {"size":1500,"price":72184.5 } ],"date":"2026-08-20T15:15:34.793Z","time":1787238934793,"state":"open","low24h":66546,"symbol":"BTC-PERPETUAL","dataset":"order-book","high24h":72511.5,"askCount":10,"bidCount":10,"changeId":170552772179,"maxPrice":73273.5,"minPrice":71107,"provider":"deribit","funding8h":0.00000879,"lastPrice":72187,"markPrice":72190.31,"volume24h":17388.78581996,"indexPrice":72188.68,"bestAskPrice":72195,"bestBidPrice":72194.5,"openInterest":822593720,"volumeUsd24h":1213453520,"bestAskAmount":7800,"bestBidAmount":17160,"interestValue":0.0011166989872886256,"currentFunding":0,"settlementPrice":69806.07,"priceChangePct24h":8.3637,"volumeNotional24h":1213453520,"estimatedDeliveryPrice":72188.68 },"timestamp":"2026-08-20T14:59:35Z"}
Errors
- 401Missing or invalid x-api-key
- 404Not found or private
- 429Rate limit or monthly quota reached
Ticker
Everything Deribit publishes about one instrument in a single call.
/v1/finance:deribit/tickerParameters
| Name | Type | In | Description |
|---|---|---|---|
| symbol | string | query | Instrument name, Deribit's own form. |
Example response
{"project":"finance:deribit", "data": {"date":"2026-08-20T15:00:24.798Z","time":1787238024798,"state":"open","low24h":65862.5,"symbol":"BTC-PERPETUAL","dataset":"ticker","high24h":72429,"maxPrice":72846,"minPrice":70692.5,"provider":"deribit","funding8h":0.00001004,"lastPrice":71755,"markPrice":71769.38,"volume24h":17682.42559782,"indexPrice":71765.41,"bestAskPrice":71755,"bestBidPrice":71754.5,"openInterest":822916570,"volumeUsd24h":1230962300,"bestAskAmount":361770,"bestBidAmount":255060,"interestValue":0.0011131102258984174,"currentFunding":0,"settlementPrice":69806.07,"priceChangePct24h":8.8838,"volumeNotional24h":1230962300,"estimatedDeliveryPrice":71765.41 },"timestamp":"2026-08-20T14:59:35Z"}
Errors
- 401Missing or invalid x-api-key
- 404Not found or private
- 429Rate limit or monthly quota reached
Trades
Recent public prints for one Deribit instrument.
/v1/finance:deribit/tradesParameters
| Name | Type | In | Description |
|---|---|---|---|
| symbol | string | query | Instrument name, Deribit's own form. |
| count | number | query | Prints to return. Default 100, max 1000. |
| sorting | enum | query | Order the exchange applies before the cap. Default desc. One of asc, desc, default. |
Example response
{"project":"finance:deribit", "data": {"count":100, "items": [ {"iv":null,"date":"2026-08-20T15:00:32.548Z","time":1787238032548,"price":71769,"amount":330,"symbol":"BTC-PERPETUAL","tradeId":"440863223","contracts":33,"direction":"buy","markPrice":71771,"indexPrice":71767.71,"tickDirection":1,"tradeSequence":296610088 }, {"iv":null,"date":"2026-08-20T15:00:30.853Z","time":1787238030853,"price":71769,"amount":1280,"symbol":"BTC-PERPETUAL","tradeId":"440863222","contracts":128,"direction":"buy","markPrice":71767.66,"indexPrice":71764.35,"tickDirection":0,"tradeSequence":296610087 }, {"iv":null,"date":"2026-08-20T15:00:30.099Z","time":1787238030099,"price":71768.5,"amount":1000,"symbol":"BTC-PERPETUAL","tradeId":"440863220","contracts":100,"direction":"sell","markPrice":71767.98,"indexPrice":71764.69,"tickDirection":3,"tradeSequence":296610086 } ],"symbol":"BTC-PERPETUAL","dataset":"trades","hasMore":true,"sorting":"desc","provider":"deribit" },"timestamp":"2026-08-20T14:59:35Z"}
Errors
- 401Missing or invalid x-api-key
- 404Not found or private
- 429Rate limit or monthly quota reached
Volatility Index
DVOL — Deribit's implied-volatility index, crypto's VIX — as OHLC candles.
/v1/finance:deribit/volatility-indexParameters
| Name | Type | In | Description |
|---|---|---|---|
| currency | enum | query | Index currency. BTC and ETH carry the deep history. Default BTC. One of BTC, ETH, USDC, USDT, EURR. |
| resolution | enum | query | Bar size in seconds, or 1D for a day. Default 60. One of 1, 60, 3600, 43200, 1D. |
| start | string | query | Oldest bar to include. Epoch ms/s or ISO date. |
| end | string | query | Newest bar to include. Epoch ms/s or ISO date. |
| page | number | query | Page number, walking backwards in time. Default 1, max 20. |
Example response
{"project":"finance:deribit", "data": {"page":1,"count":1000, "items": [ {"low":34.68,"date":"2026-08-19T07:21:00.000Z","high":34.68,"open":34.68,"close":34.68,"openTime":1787124060000,"closeTime":1787124119999 }, {"low":34.68,"date":"2026-08-19T07:22:00.000Z","high":34.69,"open":34.68,"close":34.69,"openTime":1787124120000,"closeTime":1787124179999 }, {"low":34.69,"date":"2026-08-19T07:23:00.000Z","high":34.7,"open":34.69,"close":34.7,"openTime":1787124180000,"closeTime":1787124239999 }, {"low":34.7,"date":"2026-08-19T07:24:00.000Z","high":34.7,"open":34.7,"close":34.7,"openTime":1787124240000,"closeTime":1787124299999 }, {"low":34.7,"date":"2026-08-19T07:25:00.000Z","high":34.73,"open":34.7,"close":34.73,"openTime":1787124300000,"closeTime":1787124359999 }, {"low":34.72,"date":"2026-08-19T07:26:00.000Z","high":34.72,"open":34.72,"close":34.72,"openTime":1787124360000,"closeTime":1787124419999 } ],"dataset":"volatility-index","hasMore":true,"currency":"BTC","nextPage":2,"provider":"deribit","resolution":"60" },"timestamp":"2026-08-20T14:59:35Z"}
Errors
- 401Missing or invalid x-api-key
- 404Not found or private
- 429Rate limit or monthly quota reached
Try it
Live request with your key
const data = await client.run( "finance:deribit", "book-summary", { currency: "BTC", kind: "future" });
Deribit
Deribit public data, including DVOL — the crypto volatility index — at one-second resolution, plus options instruments and index prices.
Top of book, open interest and 24h volume for every Deribit instrument in one
/v1/…deribit/book-summaryTry it
Parameters
currency
enum · query · optional
Settlement currency. Default BTC.
kind
enum · query · optional
Instrument kind. Omit for every kind.
Example response
{"project":"finance:deribit", "data": {"kind":"future","count":13, "items": [ {"date":"2026-08-20T14:59:36.039Z","time":1787237976039,"low24h":66152.5,"markIv":null,"symbol":"BTC-30OCT26","volume":79.60912343,"high24h":72970,"askPrice":72350,"bidPrice":72327.5,"midPrice":72338.75,"lastPrice":72238.5,"markPrice":72348.81,"volumeUsd":5595640,"baseCurrency":"BTC","openInterest":8088840,"quoteCurrency":"USD","volumeNotional":5595640,"underlyingPrice":null,"priceChangePct24h":8.6579,"estimatedDeliveryPrice":71740.86 }, {"date":"2026-08-20T14:59:36.039Z","time":1787237976039,"low24h":68405,"markIv":null,"symbol":"BTC-25JUN27","volume":84.9230532,"high24h":75140,"askPrice":74415,"bidPrice":74355,"midPrice":74385,"lastPrice":74115,"markPrice":74392.24,"volumeUsd":6136400,"baseCurrency":"BTC","openInterest":10423000,"quoteCurrency":"USD","volumeNotional":6136400,"underlyingPrice":null,"priceChangePct24h":8.2484,"estimatedDeliveryPrice":71740.86 }, {"date":"2026-08-20T14:59:36.039Z","time":1787237976039,"low24h":65955,"markIv":null,"symbol":"BTC-23AUG26","volume":130.46758673,"high24h":72395,"askPrice":71740,"bidPrice":71715,"midPrice":71727.5,"lastPrice":71727.5,"markPrice":71737.15,"volumeUsd":9080690,"baseCurrency":"BTC","openInterest":8264000,"quoteCurrency":"USD","volumeNotional":9080690,"underlyingPrice":null,"priceChangePct24h":8.7522,"estimatedDeliveryPrice":71740.86 } ],"dataset":"book-summary","currency":"BTC","provider":"deribit" },"timestamp":"2026-08-20T14:59:35Z"}
Errors
- 401Missing or invalid x-api-key
- 404Not found or private
- 429Rate limit or monthly quota reached
Code
const data = await client.run( "finance:deribit", "book-summary", { currency: "BTC", kind: "future" });