Deribit

App · 19 actions

Read public market data from Deribit, the largest crypto options exchange: live tickers with implied volatility and greeks, order books, trades, price candles, futures and options listings, option chains, perpetual funding, the DVOL volatility index, realized volatility, index and delivery prices, settlements, exchange volumes and announcements. No account or API key, and no access to anyone's balances or orders.

Actions

ActionWhat it does
Get a tickerGet a live snapshot of one instrument: the last, mark and index prices, the best bid and ask with their sizes and the spread, the 24-hour high, low, change and volume, and open interest.
Get an index priceGet a Deribit index price now, such as Bitcoin in US dollars (btc_usd): the reference price, averaged across several exchanges, that Deribit's contracts are marked and settled against, with the price they would be delivered at if they expired now.
Get an instrumentGet one instrument's details: what it is, when it expires, its strike for an option, the size of a contract, the smallest order and price step, which currency it is priced, sized and settled in, and its fees.
Get funding rate historyGet what funding cost on a perpetual, hour by hour, over a window of up to 30 days, with the total for the window as Deribit counts it and the same pace over a year.
Get historical volatilityGet how much a currency's price has actually been moving: its realized volatility, yearly, in percent, hour by hour for about the last two weeks, with the latest, average, lowest and highest.
Get index price historyGet a Deribit index's price over the last hour, day, two days, month or year, or its whole history, with the change, high and low across it.
Get platform statusCheck whether Deribit is open, or locked in all or some currencies (as it is during an incident), with Deribit's own clock.
Get price candlesGet an instrument's price over time as candles, from 1 minute to 1 day: open, high, low, close and volume for each, plus the change, high, low and volume across the window.
Get the order bookGet the bids and asks resting on one instrument, best first, with the amount at each price and the running total, plus the spread, the mid price and the mark and index prices.
Get the volatility index (DVOL)Get DVOL, Deribit's volatility index: how much the options market expects the currency to move over the next 30 days, yearly, in percent (the crypto counterpart of the VIX).
Get trade volumesGet how much traded on Deribit, per currency, over the last 24 hours, 7 days and 30 days: futures, calls, puts and spot, each in the currency's own units.
Get yield historyGet the daily yield of a yield-bearing currency held on Deribit, such as staked ETH (stETH), USDe or USDC, as a yearly percentage, newest first, with the latest and the average.
List announcementsList Deribit's platform announcements, newest first: new listings, maintenance, changes to indexes and rules.
List currenciesList every currency Deribit supports, BTC, ETH, USDC and USDT first: its name, whether it counts as collateral, its yield when it earns one, and its withdrawal fee and networks.
List delivery pricesList the prices an index's contracts were settled at when they expired, day by day, newest first (Deribit's contracts expire at 08:00 UTC).
List instrumentsList what Deribit has listed for a currency: futures, perpetuals, options, spot pairs and combos, soonest expiry first, each with its expiry, strike, contract size, tick size, units and fees.
List market summariesGet a summary of every instrument of one kind at once: mark, bid, ask and last prices, 24-hour volume and change, open interest, and implied volatility for options or funding for perpetuals.
List settlementsList settlement events, newest first: the daily 08:00 UTC settlements of futures and perpetuals, deliveries and exercises at expiry, and bankruptcies, each with the mark and index prices and the exchange-wide profit and loss.
List tradesList trades on one instrument, or on every instrument of a currency and kind: the latest, or those in a window of any age.

Get a ticker

Get a live snapshot of one instrument: the last, mark and index prices, the best bid and ask with their sizes and the spread, the 24-hour high, low, change and volume, and open interest. A perpetual adds its funding rate; an option adds its implied volatility and greeks, and its prices in US dollars. Each answer says which currency its prices and sizes are in. No API key required.

Inputs

Currencycurrencytext
Fills the Instrument list with this currency's instruments. Leave it as it is when you type the instrument or take it from an earlier step.Default: BTC.
Kindinstrument_kindtext
Fills the Instrument list with this kind of instrument. Leave it as it is when you type the instrument or take it from an earlier step.One of: future (Futures and perpetuals), option (Options), spot (Spot pairs), future_combo (Future spreads), option_combo (Option strategies). Default: future.
InstrumentinstrumenttextRequired
The instrument, such as BTC-PERPETUAL, the future BTC-27NOV26 or the option BTC-27NOV26-90000-C (a call at 90,000 expiring 27 November 2026). Pick one from the list, soonest expiry first, or type any name; List instruments finds them.

Outputs

amount_currencytext
The currency its sizes, amounts and open interest are counted in: USD for BTC and ETH futures and perpetuals, and the base coin for options, linear contracts and spot pairs.
ask_iv_percentnumber
For an option, the implied volatility of the best ask.
best_ask_amountnumber
How much is offered at that price, in the amount currency.
best_ask_pricenumber
The lowest price someone is asking. Null when nobody is.
best_ask_price_usdnumber
The best ask in US dollars: the price itself when it is in USD, USDC or USDT, and the coin price times the index price for an option priced in its coin. Null when it can't be worked out (a spot pair priced in BTC).
best_bid_amountnumber
How much is bid at that price, in the amount currency.
best_bid_pricenumber
The highest price someone is bidding. Null when nobody is.
best_bid_price_usdnumber
The best bid in US dollars: the price itself when it is in USD, USDC or USDT, and the coin price times the index price for an option priced in its coin. Null when it can't be worked out (a spot pair priced in BTC).
bid_iv_percentnumber
For an option, the implied volatility of the best bid.
current_funding_ratenumber
For a perpetual, the funding rate right now, as a fraction (0.0001 is 0.01%). Null for the rest.
delivery_pricenumber
The price it was delivered at, once it has expired. Null until then.
deltanumber
For an option, how much its price moves for a 1 dollar move in the coin, in coins.
estimated_delivery_pricenumber
The price it would be delivered at if it expired now.
expires_attext
When it expires (null for perpetuals and spot pairs), as ISO 8601 in UTC, such as 2026-10-22T08:00:00.000Z.
expires_at_msnumber
When it expires (null for perpetuals and spot pairs), in milliseconds since 1 January 1970 (UTC).
expirytext
The expiry as Deribit writes it in names, such as 27NOV26. Null for perpetuals and spot pairs.
funding_8h_ratenumber
For a perpetual, the funding over the last 8 hours, as a fraction. Positive means longs pay shorts. Null for the rest.
funding_annualized_percentnumber
The 8-hour funding carried over a year (three times a day), in percent.
gammanumber
For an option, how fast delta changes as the coin's price moves.
high_24hnumber
The highest trade in the last 24 hours. Null with no trades.
index_pricenumber
The price of its underlying index, in US dollars (or USDC).
instrumenttext
The Deribit instrument name, such as BTC-PERPETUAL.
kindtext
The kind of instrument: future (futures and perpetuals), option, spot, future_combo or option_combo.
last_pricenumber
The price of the last trade. Null when it has never traded.
last_price_usdnumber
The last price in US dollars: the price itself when it is in USD, USDC or USDT, and the coin price times the index price for an option priced in its coin. Null when it can't be worked out (a spot pair priced in BTC).
low_24hnumber
The lowest trade in the last 24 hours. Null with no trades.
mark_iv_percentnumber
For an option, the implied volatility of the mark price, in percent.
mark_pricenumber
Deribit's fair price for it, which positions and liquidations are valued at.
mark_price_usdnumber
The mark price in US dollars: the price itself when it is in USD, USDC or USDT, and the coin price times the index price for an option priced in its coin. Null when it can't be worked out (a spot pair priced in BTC).
max_pricenumber
The highest price an order may be placed at right now.
mid_pricenumber
Halfway between the best bid and the best ask.
min_pricenumber
The lowest price an order may be placed at right now.
open_interestnumber
The size of every position still open, in the amount currency. Null for spot pairs.
option_typetext
call or put. Null for anything but options.
price_change_24h_percentnumber
How much the price moved in the last 24 hours, in percent. Null with no trades.
price_currencytext
The currency its prices are in: USD for BTC and ETH futures and perpetuals, the coin itself (BTC, ETH) for their options, and the quote currency (such as USDC) for linear contracts and spot pairs.
rhonumber
For an option, how much its value changes for a 1 point rise in rates.
settlement_pricenumber
The price at the last daily settlement (08:00 UTC).
spreadnumber
The best ask minus the best bid, in the price currency.
spread_percentnumber
The spread as a percentage of the mid price.
statetext
The order book's state, such as open.
strikenumber
The option's strike price, in US dollars. Null for anything but options.
thetanumber
For an option, how much value it loses in a day, in US dollars.
timetext
When Deribit took the snapshot, as ISO 8601 in UTC, such as 2026-10-22T08:00:00.000Z.
timestamp_msnumber
When Deribit took the snapshot, in milliseconds since 1 January 1970 (UTC).
underlying_indextext
For an option, the future it is priced off, or index_price for the index.
underlying_pricenumber
For an option, the price of what it is priced off (a future or the index).
veganumber
For an option, how much its value changes, in US dollars, for a 1 point rise in implied volatility.
volume_24hnumber
What traded in the last 24 hours, in the base coin.
volume_24h_usdnumber
What traded in the last 24 hours, in US dollars (derivatives only).
Example output
{
  "amount_currency": "BTC",
  "ask_iv_percent": 27.2,
  "best_ask_amount": 31.8,
  "best_ask_price": 0.0125,
  "best_ask_price_usd": 1035.2835,
  "best_bid_amount": 18.1,
  "best_bid_price": 0.0115,
  "best_bid_price_usd": 952.46082,
  "bid_iv_percent": 24.45,
  "current_funding_rate": null,
  "delivery_price": null,
  "delta": 0.5796,
  "estimated_delivery_price": 82822.68,
  "expires_at": "2026-10-25T08:00:00.000Z",
  "expires_at_ms": 1792915200000,
  "expiry": "25OCT26",
  "funding_8h_rate": null,
  "funding_annualized_percent": null,
  "gamma": 0.00019,
  "high_24h": null,
  "index_price": 82822.68,
  "instrument": "BTC-25OCT26-82500-C",
  "kind": "option",
  "last_price": null,
  "last_price_usd": null,
  "low_24h": null,
  "mark_iv_percent": 26.1,
  "mark_price": 0.0121,
  "mark_price_usd": 1002.154428,
  "max_price": 0.043,
  "mid_price": 0.012,
  "min_price": 0.0001,
  "open_interest": 0.0,
  "option_type": "call",
  "price_change_24h_percent": null,
  "price_currency": "BTC",
  "rho": 4.05458,
  "settlement_price": null,
  "spread": 0.001,
  "spread_percent": 8.333333,
  "state": "open",
  "strike": 82500.0,
  "theta": -124.78586,
  "time": "2026-10-22T04:29:16.395Z",
  "timestamp_ms": 1792643356395,
  "underlying_index": "BTC-25OCT26",
  "underlying_price": 82878.25,
  "vega": 30.08558,
  "volume_24h": 0.0,
  "volume_24h_usd": 0.0
}

Get an index price

Get a Deribit index price now, such as Bitcoin in US dollars (btc_usd): the reference price, averaged across several exchanges, that Deribit's contracts are marked and settled against, with the price they would be delivered at if they expired now. No API key required.

Inputs

IndexindextextRequired
The price index, such as btc_usd (Bitcoin in US dollars). Indexes are Deribit's reference prices, averaged across several exchanges, that its contracts are marked and settled against.

Outputs

base_currencytext
What the index prices, such as BTC.
estimated_delivery_pricenumber
The price contracts on it would be delivered at if they expired now.
indextext
The index name, such as btc_usd.
index_pricenumber
The index price now.
price_currencytext
What it is priced in, such as USD.
timetext
When it was read, as ISO 8601 in UTC, such as 2026-10-22T08:00:00.000Z.
timestamp_msnumber
When it was read, in milliseconds since 1 January 1970 (UTC).
Example output
{
  "base_currency": "BTC",
  "estimated_delivery_price": 82822.04,
  "index": "btc_usd",
  "index_price": 82822.04,
  "price_currency": "USD",
  "time": "2026-10-22T04:29:22.244Z",
  "timestamp_ms": 1792643362244
}

Get an instrument

Get one instrument's details: what it is, when it expires, its strike for an option, the size of a contract, the smallest order and price step, which currency it is priced, sized and settled in, and its fees. Works for expired instruments too. No API key required.

Inputs

Currencycurrencytext
Fills the Instrument list with this currency's instruments. Leave it as it is when you type the instrument or take it from an earlier step.Default: BTC.
Kindinstrument_kindtext
Fills the Instrument list with this kind of instrument. Leave it as it is when you type the instrument or take it from an earlier step.One of: future (Futures and perpetuals), option (Options), spot (Spot pairs), future_combo (Future spreads), option_combo (Option strategies). Default: future.
InstrumentinstrumenttextRequired
The instrument, such as BTC-PERPETUAL, the future BTC-27NOV26 or the option BTC-27NOV26-90000-C (a call at 90,000 expiring 27 November 2026). Pick one from the list, soonest expiry first, or type any name; List instruments finds them.

Outputs

amount_currencytext
The currency its sizes, amounts and open interest are counted in: USD for BTC and ETH futures and perpetuals, and the base coin for options, linear contracts and spot pairs.
base_currencytext
The coin it is about, such as BTC.
contract_sizenumber
The size of one contract, in the amount currency: 10 (USD) for BTC-PERPETUAL, 1 (BTC) for a BTC option.
contract_typetext
inverse (sized in dollars, settled in the coin, like BTC-PERPETUAL) or linear (sized in the coin, settled in the quote currency, like BTC_USDC-PERPETUAL).
counter_currencytext
The other side of its currency pair, such as USD or USDC.
created_attext
When it was listed, as ISO 8601 in UTC, such as 2026-10-22T08:00:00.000Z.
created_at_msnumber
When it was listed, in milliseconds since 1 January 1970 (UTC).
expires_attext
When it expires (null for perpetuals and spot pairs), as ISO 8601 in UTC, such as 2026-10-22T08:00:00.000Z.
expires_at_msnumber
When it expires (null for perpetuals and spot pairs), in milliseconds since 1 January 1970 (UTC).
expirytext
The expiry as Deribit writes it in names, such as 27NOV26. Null for perpetuals and spot pairs.
instrumenttext
The Deribit instrument name, such as BTC-PERPETUAL.
instrument_idnumber
Deribit's number for the instrument.
is_activetrue/false
True while its order book is visible.
is_perpetualtrue/false
True for a perpetual, which never expires.
kindtext
The kind of instrument: future (futures and perpetuals), option, spot, future_combo or option_combo.
maker_commissionnumber
The fee for an order that rests on the book, as a fraction (0.0003 is 0.03%).
max_leveragenumber
The most leverage allowed, for futures. Null for the rest.
min_trade_amountnumber
The smallest order, and the step between order sizes, in the amount currency.
option_typetext
call or put. Null for anything but options.
price_currencytext
The currency its prices are in: USD for BTC and ETH futures and perpetuals, the coin itself (BTC, ETH) for their options, and the quote currency (such as USDC) for linear contracts and spot pairs.
price_indextext
The index it settles against, such as btc_usd.
settlement_currencytext
The currency profits and losses are paid in. Null for spot pairs.
settlement_periodtext
How long its expiry cycle is: day, week, month or perpetual. Null for spot pairs.
statetext
Where the instrument is in its life: open (trading), settlement, delivered, inactive, locked, halted or archivized.
strikenumber
The option's strike price, in US dollars. Null for anything but options.
taker_commissionnumber
The fee for an order that trades at once, as a fraction (0.0005 is 0.05%).
tick_sizenumber
The smallest price step, in the price currency.
underlying_typetext
What it tracks: crypto, equity, commodity, crypto_index and so on.
Example output
{
  "amount_currency": "USD",
  "base_currency": "BTC",
  "contract_size": 10.0,
  "contract_type": "inverse",
  "counter_currency": "USD",
  "created_at": "2018-08-14T10:24:47.000Z",
  "created_at_ms": 1534242287000,
  "expires_at": null,
  "expires_at_ms": null,
  "expiry": null,
  "instrument": "BTC-PERPETUAL",
  "instrument_id": 210838,
  "is_active": true,
  "is_perpetual": true,
  "kind": "future",
  "maker_commission": 0.00015,
  "max_leverage": 50.0,
  "min_trade_amount": 10.0,
  "option_type": null,
  "price_currency": "USD",
  "price_index": "btc_usd",
  "settlement_currency": "BTC",
  "settlement_period": "perpetual",
  "state": "open",
  "strike": null,
  "taker_commission": 0.00035,
  "tick_size": 0.5,
  "underlying_type": "crypto"
}

Get funding rate history

Get what funding cost on a perpetual, hour by hour, over a window of up to 30 days, with the total for the window as Deribit counts it and the same pace over a year. Positive funding means longs paid shorts. The last 24 hours if no dates are picked. No API key required.

Inputs

PerpetualinstrumenttextRequired
The perpetual, such as BTC-PERPETUAL. Only perpetuals pay funding, so the list holds every perpetual and nothing else.
Fromstartdate and time
The start of the window. Leave it empty for the 24 hours before To.
Toenddate and time
The end of the window. Now if left empty.

Outputs

annualized_percentnumber
The total carried over a year at the same pace, in percent.
average_rate_8hnumber
The average 8-hour funding across the hours.
countnumber
How many hours came back.
endtext
The end of the window, as ISO 8601 in UTC, such as 2026-10-22T08:00:00.000Z.
instrumenttext
The Deribit instrument name, such as BTC-PERPETUAL.
latest_rate_8hnumber
The 8-hour funding at the last hour, as a fraction.
rateslist
The funding, hour by hour, oldest first.
starttext
The start of the window, as ISO 8601 in UTC, such as 2026-10-22T08:00:00.000Z.
total_funding_percentnumber
The same total, in percent.
total_funding_ratenumber
The funding over the whole window, as Deribit totals it, as a fraction. A position worth 10,000 dollars paid (or, when negative, earned) this times 10,000.
Example output
{
  "annualized_percent": 0.046725,
  "average_rate_8h": 3.360763e-06,
  "count": 2,
  "end": "2026-10-01T05:00:00.000Z",
  "instrument": "ETH-PERPETUAL",
  "latest_rate_8h": 3.120482517507316e-06,
  "rates": [
    {
      "index_price": 2683.16,
      "previous_index_price": 2684.19,
      "rate_1h": 2.341213663676227e-08,
      "rate_8h": 3.484810106332089e-06,
      "time": "2026-10-01T01:00:00.000Z",
      "timestamp_ms": 1790816400000
    },
    {
      "index_price": 2688.25,
      "previous_index_price": 2683.16,
      "rate_1h": 1.4456997572274162e-09,
      "rate_8h": 3.470034557967718e-06,
      "time": "2026-10-01T02:00:00.000Z",
      "timestamp_ms": 1790820000000
    }
  ],
  "start": "2026-10-01T00:00:00.000Z",
  "total_funding_percent": 2.667e-05,
  "total_funding_rate": 2.6669704286491777e-07
}

Get historical volatility

Get how much a currency's price has actually been moving: its realized volatility, yearly, in percent, hour by hour for about the last two weeks, with the latest, average, lowest and highest. Compare it with the volatility index to see whether options are dear or cheap. No API key required.

Inputs

CurrencycurrencytextRequired
The currency, such as BTC or ETH. BTC, ETH and USDC carry Deribit's futures and options (USDC holds the linear ones, such as SOL_USDC-PERPETUAL); most other currencies have no markets of their own.

Outputs

average_percentnumber
The average across the hours, in percent.
countnumber
How many hours came back.
currencytext
The currency, such as BTC.
latest_attext
When the latest was measured, as ISO 8601 in UTC, such as 2026-10-22T08:00:00.000Z.
latest_percentnumber
The latest volatility, in percent.
maximum_percentnumber
The highest across the hours, in percent.
minimum_percentnumber
The lowest across the hours, in percent.
pointslist
Hour by hour, oldest first.
Example output
{
  "average_percent": 32.034783,
  "count": 2,
  "currency": "BTC",
  "latest_at": "2026-10-22T05:00:00.000Z",
  "latest_percent": 32.419152,
  "maximum_percent": 33.873869,
  "minimum_percent": 30.592135,
  "points": [
    {
      "time": "2026-10-06T07:00:00.000Z",
      "timestamp_ms": 1791270000000,
      "volatility_percent": 33.828134
    },
    {
      "time": "2026-10-06T08:00:00.000Z",
      "timestamp_ms": 1791273600000,
      "volatility_percent": 33.845861
    }
  ]
}

Get index price history

Get a Deribit index's price over the last hour, day, two days, month or year, or its whole history, with the change, high and low across it. The points are closer together for shorter periods, from every 6 seconds to every 6 hours. No API key required.

Inputs

IndexindextextRequired
The price index, such as btc_usd (Bitcoin in US dollars). Indexes are Deribit's reference prices, averaged across several exchanges, that its contracts are marked and settled against.
Periodperiodtext
How far back to go. The last day if left empty.One of: 1h (The last hour (every 6 seconds)), 1d (The last day (every minute)), 2d (The last 2 days (every minute)), 1m (The last month (every hour)), 1y (The last year (every 6 hours)), all (All history (every 6 hours)). Default: 1d.

Outputs

base_currencytext
What the index prices, such as BTC.
changenumber
The latest price minus the earliest.
change_percentnumber
The change as a percentage of the earliest price.
countnumber
How many prices came back.
endtext
The latest price's time, as ISO 8601 in UTC, such as 2026-10-22T08:00:00.000Z.
first_pricenumber
The earliest price.
highnumber
The highest price.
indextext
The index name, such as btc_usd.
last_pricenumber
The latest price.
lownumber
The lowest price.
periodtext
The period asked for: 1h, 1d, 2d, 1m, 1y or all.
pointslist
The prices, oldest first.
price_currencytext
What it is priced in, such as USD.
starttext
The earliest price's time, as ISO 8601 in UTC, such as 2026-10-22T08:00:00.000Z.
Example output
{
  "base_currency": "ETH",
  "change": 8.3,
  "change_percent": 0.340773,
  "count": 3,
  "end": "2026-10-22T04:29:24.000Z",
  "first_price": 2435.64,
  "high": 2444.5466667,
  "index": "eth_usd",
  "last_price": 2443.94,
  "low": 2431.9766667,
  "period": "1h",
  "points": [
    {
      "price": 2435.64,
      "time": "2026-10-22T03:29:30.000Z",
      "timestamp_ms": 1792639770000
    },
    {
      "price": 2435.59,
      "time": "2026-10-22T03:29:36.000Z",
      "timestamp_ms": 1792639776000
    },
    {
      "price": 2435.5316667,
      "time": "2026-10-22T03:29:42.000Z",
      "timestamp_ms": 1792639782000
    }
  ],
  "price_currency": "USD",
  "start": "2026-10-22T03:29:30.000Z"
}

Get platform status

Check whether Deribit is open, or locked in all or some currencies (as it is during an incident), with Deribit's own clock. The answer has plain true or false flags, so a workflow can hold off without reading text. No API key required.

Inputs

None.

Outputs

is_opentrue/false
True when nothing is locked.
lockedtrue/false
True when trading is locked in every currency.
locked_indiceslist
The indexes whose markets are locked, such as btc_usd.
partially_lockedtrue/false
True when some currencies are locked.
server_timetext
Deribit's clock, as ISO 8601 in UTC, such as 2026-10-22T08:00:00.000Z.
server_time_msnumber
Deribit's clock, in milliseconds since 1 January 1970 (UTC).
statustext
open, partially locked, or locked.
Example output
{
  "is_open": true,
  "locked": false,
  "locked_indices": [],
  "partially_locked": false,
  "server_time": "2026-10-22T04:29:24.464Z",
  "server_time_ms": 1792643364464,
  "status": "open"
}

Get price candles

Get an instrument's price over time as candles, from 1 minute to 1 day: open, high, low, close and volume for each, plus the change, high, low and volume across the window. Leave the dates empty for the latest candles, or pick a window in the past. Works for expired contracts too. No API key required.

Inputs

Currencycurrencytext
Fills the Instrument list with this currency's instruments. Leave it as it is when you type the instrument or take it from an earlier step.Default: BTC.
Kindinstrument_kindtext
Fills the Instrument list with this kind of instrument. Leave it as it is when you type the instrument or take it from an earlier step.One of: future (Futures and perpetuals), option (Options), spot (Spot pairs), future_combo (Future spreads), option_combo (Option strategies). Default: future.
InstrumentinstrumenttextRequired
The instrument, such as BTC-PERPETUAL, the future BTC-27NOV26 or the option BTC-27NOV26-90000-C (a call at 90,000 expiring 27 November 2026). Pick one from the list, soonest expiry first, or type any name; List instruments finds them.
Candle sizeresolutiontext
How long each candle is. 1 hour if left empty.One of: 1 (1 minute), 3 (3 minutes), 5 (5 minutes), 10 (10 minutes), 15 (15 minutes), 30 (30 minutes), 60 (1 hour), 120 (2 hours), 180 (3 hours), 360 (6 hours), 720 (12 hours), 1D (1 day). Default: 60.
Fromstartdate and time
The first candle to include. Leave it empty for the latest How many candles up to To.
Toenddate and time
The last candle to include. Now if left empty.
How manylimitnumber
The most candles to return, up to 5,000 (the latest are kept). 100 if left empty.From 1 to 5000. Default: 100.

Outputs

candleslist
The candles, oldest first.
changenumber
The last close minus the first open.
change_percentnumber
The change as a percentage of the first open.
closenumber
The last candle's close.
countnumber
How many candles came back.
endtext
The end of the window, as ISO 8601 in UTC, such as 2026-10-22T08:00:00.000Z.
highnumber
The highest price across the window.
instrumenttext
The Deribit instrument name, such as BTC-PERPETUAL.
lownumber
The lowest price across the window.
opennumber
The first candle's open.
price_currencytext
The currency its prices are in: USD for BTC and ETH futures and perpetuals, the coin itself (BTC, ETH) for their options, and the quote currency (such as USDC) for linear contracts and spot pairs.
resolutiontext
The candle size as Deribit names it, such as 60 or 1D.
resolution_labeltext
The candle size in words, such as 1 hour.
starttext
The start of the window, as ISO 8601 in UTC, such as 2026-10-22T08:00:00.000Z.
statustext
ok, or no_data when nothing traded in the window.
total_volumenumber
Everything traded across the window, in the base coin.
total_volume_quotenumber
Everything traded across the window, in the price currency.
truncatedtrue/false
True when the window held more candles than came back (the latest are kept).
volume_currencytext
The base coin each candle's volume is counted in.
Example output
{
  "candles": [
    {
      "close": 83475.5,
      "high": 83634.0,
      "low": 83382.0,
      "open": 83588.5,
      "time": "2026-10-01T00:00:00.000Z",
      "timestamp_ms": 1790812800000,
      "volume": 377.90827535,
      "volume_quote": 31547260.0
    },
    {
      "close": 83484.5,
      "high": 83660.0,
      "low": 83440.0,
      "open": 83471.0,
      "time": "2026-10-01T01:00:00.000Z",
      "timestamp_ms": 1790816400000,
      "volume": 265.71625325,
      "volume_quote": 22201010.0
    },
    {
      "close": 83456.0,
      "high": 83644.5,
      "low": 83375.0,
      "open": 83484.0,
      "time": "2026-10-01T02:00:00.000Z",
      "timestamp_ms": 1790820000000,
      "volume": 273.55489074,
      "volume_quote": 22837000.0
    }
  ],
  "change": 513.5,
  "change_percent": 0.614319,
  "close": 84102.0,
  "count": 3,
  "end": "2026-10-01T06:00:00.000Z",
  "high": 84401.0,
  "instrument": "BTC-PERPETUAL",
  "low": 83375.0,
  "open": 83588.5,
  "price_currency": "USD",
  "resolution": "60",
  "resolution_label": "1 hour",
  "start": "2026-10-01T00:00:00.000Z",
  "status": "ok",
  "total_volume": 2687.25883348,
  "total_volume_quote": 225301330.0,
  "truncated": false,
  "volume_currency": "BTC"
}

Get the order book

Get the bids and asks resting on one instrument, best first, with the amount at each price and the running total, plus the spread, the mid price and the mark and index prices. Use it to see how much can trade before the price moves. No API key required.

Inputs

Currencycurrencytext
Fills the Instrument list with this currency's instruments. Leave it as it is when you type the instrument or take it from an earlier step.Default: BTC.
Kindinstrument_kindtext
Fills the Instrument list with this kind of instrument. Leave it as it is when you type the instrument or take it from an earlier step.One of: future (Futures and perpetuals), option (Options), spot (Spot pairs), future_combo (Future spreads), option_combo (Option strategies). Default: future.
InstrumentinstrumenttextRequired
The instrument, such as BTC-PERPETUAL, the future BTC-27NOV26 or the option BTC-27NOV26-90000-C (a call at 90,000 expiring 27 November 2026). Pick one from the list, soonest expiry first, or type any name; List instruments finds them.
Levels a sidelevelsnumber
How many price levels to return on each side, from 1 to 10,000. 20 if left empty.From 1 to 10000. Default: 20.

Outputs

amount_currencytext
The currency its sizes, amounts and open interest are counted in: USD for BTC and ETH futures and perpetuals, and the base coin for options, linear contracts and spot pairs.
ask_countnumber
How many ask levels came back.
ask_total_amountnumber
Everything offered across the levels returned.
askslist
The asks, best (lowest) first.
best_ask_pricenumber
The lowest ask. Null when there are no asks.
best_bid_pricenumber
The highest bid. Null when there are no bids.
bid_countnumber
How many bid levels came back.
bid_total_amountnumber
Everything bid across the levels returned.
bidslist
The bids, best (highest) first.
index_pricenumber
The price of its underlying index.
instrumenttext
The Deribit instrument name, such as BTC-PERPETUAL.
last_pricenumber
The price of the last trade.
levels_requestednumber
How many price levels a side were asked for.
mark_pricenumber
Deribit's fair price for the instrument.
mid_pricenumber
Halfway between the best bid and the best ask.
price_currencytext
The currency its prices are in: USD for BTC and ETH futures and perpetuals, the coin itself (BTC, ETH) for their options, and the quote currency (such as USDC) for linear contracts and spot pairs.
spreadnumber
The best ask minus the best bid, in the price currency.
spread_percentnumber
The spread as a percentage of the mid price.
statetext
The order book's state, such as open.
timetext
When Deribit took the snapshot, as ISO 8601 in UTC, such as 2026-10-22T08:00:00.000Z.
timestamp_msnumber
When Deribit took the snapshot, in milliseconds since 1 January 1970 (UTC).
Example output
{
  "amount_currency": "USD",
  "ask_count": 3,
  "ask_total_amount": 5030.0,
  "asks": [
    {
      "amount": 10.0,
      "price": 82846.5,
      "total_amount": 10.0
    },
    {
      "amount": 10.0,
      "price": 82847.5,
      "total_amount": 20.0
    },
    {
      "amount": 5010.0,
      "price": 82853.5,
      "total_amount": 5030.0
    }
  ],
  "best_ask_price": 82846.5,
  "best_bid_price": 82846.0,
  "bid_count": 3,
  "bid_total_amount": 227640.0,
  "bids": [
    {
      "amount": 128740.0,
      "price": 82846.0,
      "total_amount": 128740.0
    },
    {
      "amount": 96900.0,
      "price": 82845.5,
      "total_amount": 225640.0
    },
    {
      "amount": 2000.0,
      "price": 82845.0,
      "total_amount": 227640.0
    }
  ],
  "index_price": 82822.68,
  "instrument": "BTC-PERPETUAL",
  "last_price": 82846.0,
  "levels_requested": 3,
  "mark_price": 82849.8,
  "mid_price": 82846.25,
  "price_currency": "USD",
  "spread": 0.5,
  "spread_percent": 0.000604,
  "state": "open",
  "time": "2026-10-22T04:29:18.173Z",
  "timestamp_ms": 1792643358173
}

Get the volatility index (DVOL)

Get DVOL, Deribit's volatility index: how much the options market expects the currency to move over the next 30 days, yearly, in percent (the crypto counterpart of the VIX). Candles from 1 minute to 1 day over a window, with the latest value. The last week of hourly candles if left as it is. No API key required.

Inputs

CurrencycurrencytextRequired
The currency whose volatility index to get, such as BTC.
Candle sizeresolutiontext
How long each candle is. 1 hour if left empty.One of: 60 (1 minute), 3600 (1 hour), 43200 (12 hours), 1D (1 day). Default: 3600.
Fromstartdate and time
The first candle to include. Leave it empty for the latest How many candles up to To.
Toenddate and time
The last candle to include. Now if left empty.
How manylimitnumber
The most candles to return, up to 5,000 (the latest are kept). 168 (a week of hours) if left empty.From 1 to 5000. Default: 168.

Outputs

candleslist
The candles, oldest first.
changenumber
The latest value minus the first open, in points.
countnumber
How many candles came back.
currencytext
The currency, such as BTC.
endtext
The end of the window, as ISO 8601 in UTC, such as 2026-10-22T08:00:00.000Z.
highnumber
The highest across the window.
indextext
The volatility index's name, such as btcdvol_usdc.
latestnumber
The latest value: the 30-day volatility the options market expects, yearly, in percent.
latest_attext
When the latest candle starts, as ISO 8601 in UTC, such as 2026-10-22T08:00:00.000Z.
lownumber
The lowest across the window.
opennumber
The first candle's open.
resolutiontext
The candle size as Deribit names it, such as 3600.
resolution_labeltext
The candle size in words, such as 1 hour.
starttext
The start of the window, as ISO 8601 in UTC, such as 2026-10-22T08:00:00.000Z.
truncatedtrue/false
True when the window held more candles than came back (the latest are kept).
Example output
{
  "candles": [
    {
      "close": 51.83,
      "high": 52.06,
      "low": 50.0,
      "open": 51.31,
      "time": "2026-09-01T00:00:00.000Z",
      "timestamp_ms": 1788220800000
    },
    {
      "close": 50.92,
      "high": 51.85,
      "low": 50.75,
      "open": 51.83,
      "time": "2026-09-02T00:00:00.000Z",
      "timestamp_ms": 1788307200000
    }
  ],
  "change": -1.66,
  "count": 2,
  "currency": "ETH",
  "end": "2026-10-01T00:00:00.000Z",
  "high": 57.29,
  "index": "ethdvol_usdc",
  "latest": 49.65,
  "latest_at": "2026-10-01T00:00:00.000Z",
  "low": 47.9,
  "open": 51.31,
  "resolution": "1D",
  "resolution_label": "1 day",
  "start": "2026-09-01T00:00:00.000Z",
  "truncated": false
}

Get trade volumes

Get how much traded on Deribit, per currency, over the last 24 hours, 7 days and 30 days: futures, calls, puts and spot, each in the currency's own units. Use it for a market report or to compare weeks. No API key required.

Inputs

Include currencies with no volumeinclude_inactivetrue/false
Also list the currencies that traded nothing. Left out if left empty.Default: false.

Outputs

countnumber
How many currencies came back.
include_inactivetrue/false
True when currencies with no volume were kept.
timetext
When the volumes were read, as ISO 8601 in UTC, such as 2026-10-22T08:00:00.000Z.
volumeslist
One row per currency, BTC, ETH, USDC and USDT first.
Example output
{
  "count": 2,
  "include_inactive": false,
  "time": "2026-10-22T04:29:23.838Z",
  "volumes": [
    {
      "calls_volume_24h": 20850.5,
      "calls_volume_30d": 394247.9,
      "calls_volume_7d": 102042.2,
      "currency": "BTC",
      "futures_volume_24h": 18590.19545339,
      "futures_volume_30d": 455868.72876297,
      "futures_volume_7d": 110003.59383858,
      "index": "btc_usd",
      "options_volume_24h": 37721.3,
      "options_volume_30d": 731793.3,
      "options_volume_7d": 184172.3,
      "puts_volume_24h": 16870.8,
      "puts_volume_30d": 337545.4,
      "puts_volume_7d": 82130.1,
      "spot_volume_24h": 0.0,
      "spot_volume_30d": 0.0,
      "spot_volume_7d": 0.0
    },
    {
      "calls_volume_24h": 37681.0,
      "calls_volume_30d": 1780849.0,
      "calls_volume_7d": 387719.0,
      "currency": "ETH",
      "futures_volume_24h": 59704.112938,
      "futures_volume_30d": 1954705.45916,
      "futures_volume_7d": 404651.107639,
      "index": "eth_usd",
      "options_volume_24h": 71498.0,
      "options_volume_30d": 3286413.0,
      "options_volume_7d": 684406.0,
      "puts_volume_24h": 33817.0,
      "puts_volume_30d": 1505564.0,
      "puts_volume_7d": 296687.0,
      "spot_volume_24h": 0.0,
      "spot_volume_30d": 0.0,
      "spot_volume_7d": 0.0
    }
  ]
}

Get yield history

Get the daily yield of a yield-bearing currency held on Deribit, such as staked ETH (stETH), USDe or USDC, as a yearly percentage, newest first, with the latest and the average. No API key required.

Inputs

CurrencycurrencytextRequired
The yield-bearing currency, such as STETH.
Daysdaysnumber
How many days back, up to 365. 30 if left empty.From 1 to 365. Default: 30.

Outputs

average_apr_percentnumber
The average yield across the days.
countnumber
How many days came back.
currencytext
The currency, such as STETH.
dayslist
Day by day, newest first.
latest_apr_percentnumber
The newest yield, as a yearly percentage.
latest_datetext
The newest day returned.
maximum_apr_percentnumber
The highest yield across the days.
minimum_apr_percentnumber
The lowest yield across the days.
Example output
{
  "average_apr_percent": 2.2178,
  "count": 3,
  "currency": "STETH",
  "days": [
    {
      "apr_percent": 2.232,
      "date": "2026-10-21"
    },
    {
      "apr_percent": 2.225,
      "date": "2026-10-20"
    },
    {
      "apr_percent": 2.22,
      "date": "2026-10-19"
    }
  ],
  "latest_apr_percent": 2.232,
  "latest_date": "2026-10-21",
  "maximum_apr_percent": 2.232,
  "minimum_apr_percent": 2.204
}

List announcements

List Deribit's platform announcements, newest first: new listings, maintenance, changes to indexes and rules. Each comes with its title, when it was published, whether it is marked important, and its text, as plain text and as HTML. No API key required.

Inputs

Beforebeforedate and time
Only announcements published before this time, to look back. The newest if left empty.
How manylimitnumber
The most announcements to return, up to 50. 10 if left empty.From 1 to 50. Default: 10.

Outputs

announcementslist
The announcements, newest first.
beforetext
The latest time asked for (null for the most recent), as ISO 8601 in UTC, such as 2026-10-22T08:00:00.000Z.
countnumber
How many came back.
latest_published_attext
When the newest was published, as ISO 8601 in UTC, such as 2026-10-22T08:00:00.000Z.
latest_titletext
The newest announcement's headline.
Example output
{
  "announcements": [
    {
      "html": "Effective Wednesday 4 November 2026 14:00 UTC, Deribit will implement a change to the Coinbase crypto index calculation used for crypto perpetual contracts.<br><br>",
      "id": 1792603823913,
      "important": true,
      "published_at": "2026-10-21T17:23:06.813Z",
      "published_at_ms": 1792603386813,
      "text": "Effective Wednesday 4 November 2026 14:00 UTC, Deribit will implement a change to the Coinbase crypto index calculation used for crypto perpetual contracts.",
      "title": "Coinbase Index Price Methodology Update"
    }
  ],
  "before": null,
  "count": 1,
  "latest_published_at": "2026-10-21T17:23:06.813Z",
  "latest_title": "Coinbase Index Price Methodology Update"
}

List currencies

List every currency Deribit supports, BTC, ETH, USDC and USDT first: its name, whether it counts as collateral, its yield when it earns one, and its withdrawal fee and networks. Use a code in any Currency field. No API key required.

Inputs

None.

Outputs

countnumber
How many currencies came back.
currencieslist
Every currency, BTC, ETH, USDC and USDT first, then the rest A to Z.
Example output
{
  "count": 2,
  "currencies": [
    {
      "coin_type": "BTC",
      "currency": "BTC",
      "decimals": 8,
      "in_cross_collateral_pool": true,
      "min_confirmations": 1,
      "min_withdrawal_fee": 1e-05,
      "name": "Bitcoin",
      "network_currency": "BTC",
      "network_fee": 3.072e-06,
      "networks": [
        "Bitcoin"
      ],
      "withdrawal_fee": 1e-05,
      "yield_apr_percent": null
    },
    {
      "coin_type": "STETH",
      "currency": "STETH",
      "decimals": 6,
      "in_cross_collateral_pool": true,
      "min_confirmations": 1,
      "min_withdrawal_fee": 0.0001,
      "name": "Staked ETH",
      "network_currency": "ETH",
      "network_fee": 1.6605233e-06,
      "networks": [],
      "withdrawal_fee": 0.0001,
      "yield_apr_percent": 2.2243
    }
  ]
}

List delivery prices

List the prices an index's contracts were settled at when they expired, day by day, newest first (Deribit's contracts expire at 08:00 UTC). Skip the newest to page back through years of them. No API key required.

Inputs

IndexindextextRequired
The price index, such as btc_usd (Bitcoin in US dollars). Indexes are Deribit's reference prices, averaged across several exchanges, that its contracts are marked and settled against.
How manylimitnumber
The most prices to return, up to 1,000. 30 if left empty.From 1 to 1000. Default: 30.
Skipskipnumber
How many of the newest prices to skip, to page back. None if left empty.From 0 to 1000000. Default: 0.

Outputs

base_currencytext
What the index prices, such as BTC.
countnumber
How many prices came back.
has_moretrue/false
True when older prices remain.
indextext
The index name, such as btc_usd.
latest_datetext
The newest day returned.
latest_pricenumber
The newest price returned.
price_currencytext
What the prices are in, such as USD.
priceslist
The delivery prices, newest first.
skippednumber
How many of the newest were skipped.
totalnumber
How many delivery prices Deribit has for the index.
Example output
{
  "base_currency": "BTC",
  "count": 3,
  "has_more": true,
  "index": "btc_usd",
  "latest_date": "2026-10-21",
  "latest_price": 83029.21,
  "price_currency": "USD",
  "prices": [
    {
      "date": "2026-10-21",
      "delivery_price": 83029.21
    },
    {
      "date": "2026-10-20",
      "delivery_price": 81459.59
    },
    {
      "date": "2026-10-19",
      "delivery_price": 82749.79
    }
  ],
  "skipped": 0,
  "total": 2645
}

List instruments

List what Deribit has listed for a currency: futures, perpetuals, options, spot pairs and combos, soonest expiry first, each with its expiry, strike, contract size, tick size, units and fees. Narrow it to one expiry or to calls or puts, or list the contracts that expired recently instead. The first future in the list is the nearest to expiry. No API key required.

Inputs

CurrencycurrencytextRequired
The currency, such as BTC or ETH. BTC, ETH and USDC carry Deribit's futures and options (USDC holds the linear ones, such as SOL_USDC-PERPETUAL); most other currencies have no markets of their own.
Kindinstrument_kindtext
Which kind of instrument to list. Every kind if left empty.One of: any (Every kind), future (Futures and perpetuals), option (Options), spot (Spot pairs), future_combo (Future spreads), option_combo (Option strategies). Default: any.
Expiryexpirytext
Only instruments expiring on this date, such as 27NOV26 (or Perpetual). The list holds the currency's expiries; a date such as 2026-11-27 works too. Leave it empty for every expiry.
Option typeoption_typetext
Calls, puts, or both. Both if left empty.Only when Kind is Options. One of: both (Calls and puts), call (Calls only), put (Puts only). Default: both.
Recently expired insteadinclude_expiredtrue/false
List the contracts that expired recently instead of the live ones. Older ones can still be read one at a time with Get an instrument.Default: false.
How manylimitnumber
The most instruments to return, soonest expiry first. 100 if left empty.From 1 to 5000. Default: 100.

Outputs

countnumber
How many instruments came back.
currencytext
The currency asked about, such as BTC.
expirytext
The expiry asked for, such as 27NOV26, or null for every expiry.
has_moretrue/false
True when more matched than came back.
include_expiredtrue/false
True when recently expired instruments were listed.
instrumentslist
The instruments, soonest expiry first, then by strike; perpetuals and spot pairs last.
kindtext
The kind asked for, or any for every kind.
totalnumber
How many matched before the How many cut.
Example output
{
  "count": 2,
  "currency": "BTC",
  "expiry": null,
  "has_more": false,
  "include_expired": false,
  "instruments": [
    {
      "amount_currency": "USD",
      "base_currency": "BTC",
      "contract_size": 10.0,
      "contract_type": "inverse",
      "counter_currency": "USD",
      "created_at": "2026-10-18T08:00:10.000Z",
      "created_at_ms": 1792310410000,
      "expires_at": "2026-10-22T08:00:00.000Z",
      "expires_at_ms": 1792656000000,
      "expiry": "22OCT26",
      "instrument": "BTC-22OCT26",
      "instrument_id": 716688,
      "is_active": true,
      "is_perpetual": false,
      "kind": "future",
      "maker_commission": 0.00015,
      "max_leverage": 25.0,
      "min_trade_amount": 10.0,
      "option_type": null,
      "price_currency": "USD",
      "price_index": "btc_usd",
      "settlement_currency": "BTC",
      "settlement_period": "day",
      "state": "open",
      "strike": null,
      "taker_commission": 0.00035,
      "tick_size": 2.5,
      "underlying_type": "crypto"
    },
    {
      "amount_currency": "USD",
      "base_currency": "BTC",
      "contract_size": 10.0,
      "contract_type": "inverse",
      "counter_currency": "USD",
      "created_at": "2018-08-14T10:24:47.000Z",
      "created_at_ms": 1534242287000,
      "expires_at": null,
      "expires_at_ms": null,
      "expiry": null,
      "instrument": "BTC-PERPETUAL",
      "instrument_id": 210838,
      "is_active": true,
      "is_perpetual": true,
      "kind": "future",
      "maker_commission": 0.00015,
      "max_leverage": 50.0,
      "min_trade_amount": 10.0,
      "option_type": null,
      "price_currency": "USD",
      "price_index": "btc_usd",
      "settlement_currency": "BTC",
      "settlement_period": "perpetual",
      "state": "open",
      "strike": null,
      "taker_commission": 0.00035,
      "tick_size": 0.5,
      "underlying_type": "crypto"
    }
  ],
  "kind": "future",
  "total": 2
}

List market summaries

Get a summary of every instrument of one kind at once: mark, bid, ask and last prices, 24-hour volume and change, open interest, and implied volatility for options or funding for perpetuals. Narrow it to one expiry for an option chain, or list the futures for the curve, sorted by volume, open interest, expiry or name. No API key required.

Inputs

CurrencycurrencytextRequired
The currency, such as BTC or ETH. BTC, ETH and USDC carry Deribit's futures and options (USDC holds the linear ones, such as SOL_USDC-PERPETUAL); most other currencies have no markets of their own.
Kindinstrument_kindtext
Which kind of instrument to summarise. Futures and perpetuals if left empty.One of: future (Futures and perpetuals), option (Options), spot (Spot pairs), future_combo (Future spreads), option_combo (Option strategies). Default: future.
Expiryexpirytext
Only instruments expiring on this date, such as 27NOV26 (or Perpetual). The list holds the currency's expiries; a date such as 2026-11-27 works too. Leave it empty for every expiry.
Option typeoption_typetext
Calls, puts, or both. Both if left empty.Only when Kind is Options. One of: both (Calls and puts), call (Calls only), put (Puts only). Default: both.
Order bysorttext
How to order the rows. Busiest first if left empty.One of: volume (24-hour volume in US dollars (busiest first)), open_interest (Open interest (largest first)), expiry (Expiry, then strike (soonest first)), name (Instrument name (A to Z)). Default: volume.
How manylimitnumber
The most rows to return. 100 if left empty.From 1 to 5000. Default: 100.

Outputs

countnumber
How many summaries came back.
currencytext
The currency asked about, such as BTC.
expirytext
The expiry asked for, such as 27NOV26, or null for every one.
has_moretrue/false
True when more matched than came back.
kindtext
The kind asked for, such as option.
sorttext
How the rows are ordered: volume, open_interest, expiry or name.
summarieslist
One summary per instrument, in the order asked for.
totalnumber
How many instruments matched before the How many cut.
total_volume_24h_usdnumber
The 24-hour volume of every matching instrument added up, in US dollars.
Example output
{
  "count": 2,
  "currency": "BTC",
  "expiry": "27NOV26",
  "has_more": false,
  "kind": "option",
  "sort": "expiry",
  "summaries": [
    {
      "ask_price": 0.3065,
      "base_currency": "BTC",
      "bid_price": 0.304,
      "current_funding_rate": null,
      "estimated_delivery_price": 82822.68,
      "expiry": "27NOV26",
      "funding_8h_rate": null,
      "high_24h": null,
      "instrument": "BTC-27NOV26-58000-C",
      "is_perpetual": false,
      "kind": "option",
      "last_price": 0.3065,
      "low_24h": null,
      "mark_iv_percent": 58.31,
      "mark_price": 0.30501192,
      "mid_price": 0.30525,
      "open_interest": 1.7,
      "option_type": "call",
      "price_change_24h_percent": null,
      "price_currency": "BTC",
      "strike": 58000.0,
      "time": "2026-10-22T04:29:18.012Z",
      "timestamp_ms": 1792643358012,
      "underlying_index": "BTC-27NOV26",
      "underlying_price": 83287.11,
      "volume_24h": 0.0,
      "volume_24h_usd": 0.0
    },
    {
      "ask_price": 0.0015,
      "base_currency": "BTC",
      "bid_price": 0.0013,
      "current_funding_rate": null,
      "estimated_delivery_price": 82822.68,
      "expiry": "27NOV26",
      "funding_8h_rate": null,
      "high_24h": 0.0015,
      "instrument": "BTC-27NOV26-58000-P",
      "is_perpetual": false,
      "kind": "option",
      "last_price": 0.0013,
      "low_24h": 0.0013,
      "mark_iv_percent": 58.31,
      "mark_price": 0.00139602,
      "mid_price": 0.0014,
      "open_interest": 338.8,
      "option_type": "put",
      "price_change_24h_percent": -13.3333,
      "price_currency": "BTC",
      "strike": 58000.0,
      "time": "2026-10-22T04:29:18.014Z",
      "timestamp_ms": 1792643358014,
      "underlying_index": "BTC-27NOV26",
      "underlying_price": 83287.11,
      "volume_24h": 3.1,
      "volume_24h_usd": 373.86
    }
  ],
  "total": 2,
  "total_volume_24h_usd": 373.86
}

List settlements

List settlement events, newest first: the daily 08:00 UTC settlements of futures and perpetuals, deliveries and exercises at expiry, and bankruptcies, each with the mark and index prices and the exchange-wide profit and loss. For a currency, or one instrument still listed. No API key required.

Inputs

CurrencycurrencytextRequired
The currency whose settlements to list, such as BTC. It also fills the Instrument list.
Kindinstrument_kindtext
Fills the Instrument list with this kind of instrument. Leave it as it is when you type the instrument or take it from an earlier step.One of: future (Futures and perpetuals), option (Options), spot (Spot pairs), future_combo (Future spreads), option_combo (Option strategies). Default: future.
Instrumentinstrumenttext
Only this instrument, such as BTC-PERPETUAL. Leave it empty for every instrument of the currency.
Typesettlement_typetext
Which events to list. Every type if left empty.One of: all (Every type), settlement (Daily settlements), delivery (Deliveries at expiry), bankruptcy (Bankruptcies). Default: all.
Beforebeforedate and time
Only events at or before this time, to look back. The most recent if left empty.
How manylimitnumber
The most events to return, up to 1,000. 20 if left empty.From 1 to 1000. Default: 20.

Outputs

beforetext
The latest time asked for (null for the most recent), as ISO 8601 in UTC, such as 2026-10-22T08:00:00.000Z.
countnumber
How many events came back.
currencytext
The currency asked about.
has_moretrue/false
True when older events remain.
instrumenttext
The instrument asked about, or null for the whole currency.
settlement_typetext
The type asked for: all, settlement, delivery or bankruptcy.
settlementslist
The events, newest first.
Example output
{
  "before": null,
  "count": 2,
  "currency": "BTC",
  "has_more": true,
  "instrument": null,
  "settlement_type": "all",
  "settlements": [
    {
      "funded": null,
      "funding": null,
      "index_price": 83029.21,
      "instrument": "BTC-21OCT26",
      "mark_price": 83029.21,
      "position": 36139020.0,
      "profit_loss": -0.6780749280000005,
      "session_bankruptcy": null,
      "session_profit_loss": 31508.975485240084,
      "session_tax": null,
      "session_tax_rate": null,
      "socialized": null,
      "time": "2026-10-21T08:00:00.124Z",
      "timestamp_ms": 1792569600124,
      "type": "delivery"
    },
    {
      "funded": null,
      "funding": null,
      "index_price": 83029.21,
      "instrument": "BTC-21OCT26-72000-P",
      "mark_price": 0.0,
      "position": 50.0,
      "profit_loss": -0.0015100000000000005,
      "session_bankruptcy": null,
      "session_profit_loss": 4383.857458815999,
      "session_tax": null,
      "session_tax_rate": null,
      "socialized": null,
      "time": "2026-10-21T08:00:00.124Z",
      "timestamp_ms": 1792569600124,
      "type": "exercise"
    }
  ]
}

List trades

List trades on one instrument, or on every instrument of a currency and kind: the latest, or those in a window of any age. Each has its time, price, size, side and the index price then, and the answer adds up what buyers and sellers took. Trades older than a day come from Deribit's history service. No API key required.

Inputs

CurrencycurrencytextRequired
The currency whose trades to list, such as BTC. It also fills the Instrument list.
Kindinstrument_kindtext
Which kind of instrument's trades to list, and fills the Instrument list. Futures and perpetuals if left empty. Deribit publishes no trades for spot pairs it routes to Coinbase (such as BTC_USDC).One of: future (Futures and perpetuals), option (Options), spot (Spot pairs), future_combo (Future spreads), option_combo (Option strategies), combo (Every combo). Default: future.
Instrumentinstrumenttext
Only this instrument, such as BTC-PERPETUAL. Leave it empty for every instrument of the currency and kind.
Fromstartdate and time
The earliest trade to include. Leave From and To empty for the latest trades; with only To set, the day before it.
Toenddate and time
The latest trade to include. Now if left empty.
How manylimitnumber
The most trades to return, up to 1,000. 100 if left empty.From 1 to 1000. Default: 100.
Orderordertext
Newest or oldest first. Newest first if left empty; with a window, oldest first starts from its beginning.One of: desc (Newest first), asc (Oldest first). Default: desc.

Outputs

amount_currencytext
The instrument's amount currency, or null for a whole currency.
average_pricenumber
For one instrument, the size-weighted average price of the trades.
buy_amountnumber
The size of the trades taken by buyers, added up.
countnumber
How many trades came back.
currencytext
The currency asked about.
endtext
The end of the window (null for the latest trades), as ISO 8601 in UTC, such as 2026-10-22T08:00:00.000Z.
first_trade_attext
When the earliest trade returned happened, as ISO 8601 in UTC, such as 2026-10-22T08:00:00.000Z.
has_moretrue/false
True when more trades match than came back.
high_pricenumber
For one instrument, the highest price traded.
instrumenttext
The instrument listed, or null for a whole currency and kind.
kindtext
The kind listed, or null when one instrument was listed.
last_trade_attext
When the latest trade returned happened, as ISO 8601 in UTC, such as 2026-10-22T08:00:00.000Z.
low_pricenumber
For one instrument, the lowest price traded.
price_currencytext
The instrument's price currency, or null for a whole currency.
sell_amountnumber
The size of the trades taken by sellers, added up.
sourcetext
live when read from Deribit's main service (which keeps a day), history when read from its archive of every trade.
starttext
The start of the window (null for the latest trades), as ISO 8601 in UTC, such as 2026-10-22T08:00:00.000Z.
tradeslist
The trades, in the order asked for.
Example output
{
  "amount_currency": "USD",
  "average_price": 83909.01113496,
  "buy_amount": 22650.0,
  "count": 2,
  "currency": "BTC",
  "end": "2026-10-01T12:05:00.000Z",
  "first_trade_at": "2026-10-01T12:00:00.604Z",
  "has_more": true,
  "high_price": 83912.5,
  "instrument": "BTC-PERPETUAL",
  "kind": null,
  "last_trade_at": "2026-10-01T12:00:00.612Z",
  "low_price": 83906.5,
  "price_currency": "USD",
  "sell_amount": 14620.0,
  "source": "history",
  "start": "2026-10-01T12:00:00.000Z",
  "trades": [
    {
      "amount": 16780.0,
      "block_trade_id": null,
      "combo_id": null,
      "contracts": 1678.0,
      "direction": "buy",
      "index_price": 83885.99,
      "instrument": "BTC-PERPETUAL",
      "iv_percent": null,
      "liquidation": null,
      "mark_price": 83904.54,
      "price": 83906.5,
      "tick_direction": "plus",
      "time": "2026-10-01T12:00:00.604Z",
      "timestamp_ms": 1790856000604,
      "trade_id": "448560604",
      "trade_seq": 302466329
    },
    {
      "amount": 5870.0,
      "block_trade_id": null,
      "combo_id": null,
      "contracts": 587.0,
      "direction": "buy",
      "index_price": 83885.99,
      "instrument": "BTC-PERPETUAL",
      "iv_percent": null,
      "liquidation": null,
      "mark_price": 83904.54,
      "price": 83907.5,
      "tick_direction": "plus",
      "time": "2026-10-01T12:00:00.606Z",
      "timestamp_ms": 1790856000606,
      "trade_id": "448560605",
      "trade_seq": 302466330
    }
  ]
}

On this page