# Deribit

> 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.

App · 19 actions. Web page: https://docs.lodol.com/docs/integrations/deribit

## Actions

### 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**

- Currency (`currency`, text): 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`.
- Kind (`instrument_kind`, text): 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`.
- Instrument (`instrument`, text, required): 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_currency` (text): 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_percent` (number): For an option, the implied volatility of the best ask.
- `best_ask_amount` (number): How much is offered at that price, in the amount currency.
- `best_ask_price` (number): The lowest price someone is asking. Null when nobody is.
- `best_ask_price_usd` (number): 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_amount` (number): How much is bid at that price, in the amount currency.
- `best_bid_price` (number): The highest price someone is bidding. Null when nobody is.
- `best_bid_price_usd` (number): 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_percent` (number): For an option, the implied volatility of the best bid.
- `current_funding_rate` (number): For a perpetual, the funding rate right now, as a fraction (0.0001 is 0.01%). Null for the rest.
- `delivery_price` (number): The price it was delivered at, once it has expired. Null until then.
- `delta` (number): For an option, how much its price moves for a 1 dollar move in the coin, in coins.
- `estimated_delivery_price` (number): The price it would be delivered at if it expired now.
- `expires_at` (text): When it expires (null for perpetuals and spot pairs), as ISO 8601 in UTC, such as 2026-10-22T08:00:00.000Z.
- `expires_at_ms` (number): When it expires (null for perpetuals and spot pairs), in milliseconds since 1 January 1970 (UTC).
- `expiry` (text): The expiry as Deribit writes it in names, such as 27NOV26. Null for perpetuals and spot pairs.
- `funding_8h_rate` (number): For a perpetual, the funding over the last 8 hours, as a fraction. Positive means longs pay shorts. Null for the rest.
- `funding_annualized_percent` (number): The 8-hour funding carried over a year (three times a day), in percent.
- `gamma` (number): For an option, how fast delta changes as the coin's price moves.
- `high_24h` (number): The highest trade in the last 24 hours. Null with no trades.
- `index_price` (number): The price of its underlying index, in US dollars (or USDC).
- `instrument` (text): The Deribit instrument name, such as BTC-PERPETUAL.
- `kind` (text): The kind of instrument: future (futures and perpetuals), option, spot, future_combo or option_combo.
- `last_price` (number): The price of the last trade. Null when it has never traded.
- `last_price_usd` (number): 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_24h` (number): The lowest trade in the last 24 hours. Null with no trades.
- `mark_iv_percent` (number): For an option, the implied volatility of the mark price, in percent.
- `mark_price` (number): Deribit's fair price for it, which positions and liquidations are valued at.
- `mark_price_usd` (number): 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_price` (number): The highest price an order may be placed at right now.
- `mid_price` (number): Halfway between the best bid and the best ask.
- `min_price` (number): The lowest price an order may be placed at right now.
- `open_interest` (number): The size of every position still open, in the amount currency. Null for spot pairs.
- `option_type` (text): call or put. Null for anything but options.
- `price_change_24h_percent` (number): How much the price moved in the last 24 hours, in percent. Null with no trades.
- `price_currency` (text): 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.
- `rho` (number): For an option, how much its value changes for a 1 point rise in rates.
- `settlement_price` (number): The price at the last daily settlement (08:00 UTC).
- `spread` (number): The best ask minus the best bid, in the price currency.
- `spread_percent` (number): The spread as a percentage of the mid price.
- `state` (text): The order book's state, such as open.
- `strike` (number): The option's strike price, in US dollars. Null for anything but options.
- `theta` (number): For an option, how much value it loses in a day, in US dollars.
- `time` (text): When Deribit took the snapshot, as ISO 8601 in UTC, such as 2026-10-22T08:00:00.000Z.
- `timestamp_ms` (number): When Deribit took the snapshot, in milliseconds since 1 January 1970 (UTC).
- `underlying_index` (text): For an option, the future it is priced off, or index_price for the index.
- `underlying_price` (number): For an option, the price of what it is priced off (a future or the index).
- `vega` (number): For an option, how much its value changes, in US dollars, for a 1 point rise in implied volatility.
- `volume_24h` (number): What traded in the last 24 hours, in the base coin.
- `volume_24h_usd` (number): What traded in the last 24 hours, in US dollars (derivatives only).

**Example output**

```json
{
  "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**

- Index (`index`, text, required): 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_currency` (text): What the index prices, such as BTC.
- `estimated_delivery_price` (number): The price contracts on it would be delivered at if they expired now.
- `index` (text): The index name, such as btc_usd.
- `index_price` (number): The index price now.
- `price_currency` (text): What it is priced in, such as USD.
- `time` (text): When it was read, as ISO 8601 in UTC, such as 2026-10-22T08:00:00.000Z.
- `timestamp_ms` (number): When it was read, in milliseconds since 1 January 1970 (UTC).

**Example output**

```json
{
  "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**

- Currency (`currency`, text): 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`.
- Kind (`instrument_kind`, text): 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`.
- Instrument (`instrument`, text, required): 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_currency` (text): 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_currency` (text): The coin it is about, such as BTC.
- `contract_size` (number): The size of one contract, in the amount currency: 10 (USD) for BTC-PERPETUAL, 1 (BTC) for a BTC option.
- `contract_type` (text): 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_currency` (text): The other side of its currency pair, such as USD or USDC.
- `created_at` (text): When it was listed, as ISO 8601 in UTC, such as 2026-10-22T08:00:00.000Z.
- `created_at_ms` (number): When it was listed, in milliseconds since 1 January 1970 (UTC).
- `expires_at` (text): When it expires (null for perpetuals and spot pairs), as ISO 8601 in UTC, such as 2026-10-22T08:00:00.000Z.
- `expires_at_ms` (number): When it expires (null for perpetuals and spot pairs), in milliseconds since 1 January 1970 (UTC).
- `expiry` (text): The expiry as Deribit writes it in names, such as 27NOV26. Null for perpetuals and spot pairs.
- `instrument` (text): The Deribit instrument name, such as BTC-PERPETUAL.
- `instrument_id` (number): Deribit's number for the instrument.
- `is_active` (true/false): True while its order book is visible.
- `is_perpetual` (true/false): True for a perpetual, which never expires.
- `kind` (text): The kind of instrument: future (futures and perpetuals), option, spot, future_combo or option_combo.
- `maker_commission` (number): The fee for an order that rests on the book, as a fraction (0.0003 is 0.03%).
- `max_leverage` (number): The most leverage allowed, for futures. Null for the rest.
- `min_trade_amount` (number): The smallest order, and the step between order sizes, in the amount currency.
- `option_type` (text): call or put. Null for anything but options.
- `price_currency` (text): 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_index` (text): The index it settles against, such as btc_usd.
- `settlement_currency` (text): The currency profits and losses are paid in. Null for spot pairs.
- `settlement_period` (text): How long its expiry cycle is: day, week, month or perpetual. Null for spot pairs.
- `state` (text): Where the instrument is in its life: open (trading), settlement, delivered, inactive, locked, halted or archivized.
- `strike` (number): The option's strike price, in US dollars. Null for anything but options.
- `taker_commission` (number): The fee for an order that trades at once, as a fraction (0.0005 is 0.05%).
- `tick_size` (number): The smallest price step, in the price currency.
- `underlying_type` (text): What it tracks: crypto, equity, commodity, crypto_index and so on.

**Example output**

```json
{
  "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**

- Perpetual (`instrument`, text, required): The perpetual, such as BTC-PERPETUAL. Only perpetuals pay funding, so the list holds every perpetual and nothing else.
- From (`start`, date and time): The start of the window. Leave it empty for the 24 hours before To.
- To (`end`, date and time): The end of the window. Now if left empty.

**Outputs**

- `annualized_percent` (number): The total carried over a year at the same pace, in percent.
- `average_rate_8h` (number): The average 8-hour funding across the hours.
- `count` (number): How many hours came back.
- `end` (text): The end of the window, as ISO 8601 in UTC, such as 2026-10-22T08:00:00.000Z.
- `instrument` (text): The Deribit instrument name, such as BTC-PERPETUAL.
- `latest_rate_8h` (number): The 8-hour funding at the last hour, as a fraction.
- `rates` (list): The funding, hour by hour, oldest first.
- `start` (text): The start of the window, as ISO 8601 in UTC, such as 2026-10-22T08:00:00.000Z.
- `total_funding_percent` (number): The same total, in percent.
- `total_funding_rate` (number): 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**

```json
{
  "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**

- Currency (`currency`, text, required): 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_percent` (number): The average across the hours, in percent.
- `count` (number): How many hours came back.
- `currency` (text): The currency, such as BTC.
- `latest_at` (text): When the latest was measured, as ISO 8601 in UTC, such as 2026-10-22T08:00:00.000Z.
- `latest_percent` (number): The latest volatility, in percent.
- `maximum_percent` (number): The highest across the hours, in percent.
- `minimum_percent` (number): The lowest across the hours, in percent.
- `points` (list): Hour by hour, oldest first.

**Example output**

```json
{
  "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**

- Index (`index`, text, required): 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.
- Period (`period`, text): 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_currency` (text): What the index prices, such as BTC.
- `change` (number): The latest price minus the earliest.
- `change_percent` (number): The change as a percentage of the earliest price.
- `count` (number): How many prices came back.
- `end` (text): The latest price's time, as ISO 8601 in UTC, such as 2026-10-22T08:00:00.000Z.
- `first_price` (number): The earliest price.
- `high` (number): The highest price.
- `index` (text): The index name, such as btc_usd.
- `last_price` (number): The latest price.
- `low` (number): The lowest price.
- `period` (text): The period asked for: 1h, 1d, 2d, 1m, 1y or all.
- `points` (list): The prices, oldest first.
- `price_currency` (text): What it is priced in, such as USD.
- `start` (text): The earliest price's time, as ISO 8601 in UTC, such as 2026-10-22T08:00:00.000Z.

**Example output**

```json
{
  "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_open` (true/false): True when nothing is locked.
- `locked` (true/false): True when trading is locked in every currency.
- `locked_indices` (list): The indexes whose markets are locked, such as btc_usd.
- `partially_locked` (true/false): True when some currencies are locked.
- `server_time` (text): Deribit's clock, as ISO 8601 in UTC, such as 2026-10-22T08:00:00.000Z.
- `server_time_ms` (number): Deribit's clock, in milliseconds since 1 January 1970 (UTC).
- `status` (text): open, partially locked, or locked.

**Example output**

```json
{
  "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**

- Currency (`currency`, text): 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`.
- Kind (`instrument_kind`, text): 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`.
- Instrument (`instrument`, text, required): 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 size (`resolution`, text): 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`.
- From (`start`, date and time): The first candle to include. Leave it empty for the latest How many candles up to To.
- To (`end`, date and time): The last candle to include. Now if left empty.
- How many (`limit`, number): The most candles to return, up to 5,000 (the latest are kept). 100 if left empty. From 1 to 5000. Default: `100`.

**Outputs**

- `candles` (list): The candles, oldest first.
- `change` (number): The last close minus the first open.
- `change_percent` (number): The change as a percentage of the first open.
- `close` (number): The last candle's close.
- `count` (number): How many candles came back.
- `end` (text): The end of the window, as ISO 8601 in UTC, such as 2026-10-22T08:00:00.000Z.
- `high` (number): The highest price across the window.
- `instrument` (text): The Deribit instrument name, such as BTC-PERPETUAL.
- `low` (number): The lowest price across the window.
- `open` (number): The first candle's open.
- `price_currency` (text): 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.
- `resolution` (text): The candle size as Deribit names it, such as 60 or 1D.
- `resolution_label` (text): The candle size in words, such as 1 hour.
- `start` (text): The start of the window, as ISO 8601 in UTC, such as 2026-10-22T08:00:00.000Z.
- `status` (text): ok, or no_data when nothing traded in the window.
- `total_volume` (number): Everything traded across the window, in the base coin.
- `total_volume_quote` (number): Everything traded across the window, in the price currency.
- `truncated` (true/false): True when the window held more candles than came back (the latest are kept).
- `volume_currency` (text): The base coin each candle's volume is counted in.

**Example output**

```json
{
  "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**

- Currency (`currency`, text): 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`.
- Kind (`instrument_kind`, text): 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`.
- Instrument (`instrument`, text, required): 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 side (`levels`, number): 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_currency` (text): 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_count` (number): How many ask levels came back.
- `ask_total_amount` (number): Everything offered across the levels returned.
- `asks` (list): The asks, best (lowest) first.
- `best_ask_price` (number): The lowest ask. Null when there are no asks.
- `best_bid_price` (number): The highest bid. Null when there are no bids.
- `bid_count` (number): How many bid levels came back.
- `bid_total_amount` (number): Everything bid across the levels returned.
- `bids` (list): The bids, best (highest) first.
- `index_price` (number): The price of its underlying index.
- `instrument` (text): The Deribit instrument name, such as BTC-PERPETUAL.
- `last_price` (number): The price of the last trade.
- `levels_requested` (number): How many price levels a side were asked for.
- `mark_price` (number): Deribit's fair price for the instrument.
- `mid_price` (number): Halfway between the best bid and the best ask.
- `price_currency` (text): 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.
- `spread` (number): The best ask minus the best bid, in the price currency.
- `spread_percent` (number): The spread as a percentage of the mid price.
- `state` (text): The order book's state, such as open.
- `time` (text): When Deribit took the snapshot, as ISO 8601 in UTC, such as 2026-10-22T08:00:00.000Z.
- `timestamp_ms` (number): When Deribit took the snapshot, in milliseconds since 1 January 1970 (UTC).

**Example output**

```json
{
  "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**

- Currency (`currency`, text, required): The currency whose volatility index to get, such as BTC.
- Candle size (`resolution`, text): 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`.
- From (`start`, date and time): The first candle to include. Leave it empty for the latest How many candles up to To.
- To (`end`, date and time): The last candle to include. Now if left empty.
- How many (`limit`, number): 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**

- `candles` (list): The candles, oldest first.
- `change` (number): The latest value minus the first open, in points.
- `count` (number): How many candles came back.
- `currency` (text): The currency, such as BTC.
- `end` (text): The end of the window, as ISO 8601 in UTC, such as 2026-10-22T08:00:00.000Z.
- `high` (number): The highest across the window.
- `index` (text): The volatility index's name, such as btcdvol_usdc.
- `latest` (number): The latest value: the 30-day volatility the options market expects, yearly, in percent.
- `latest_at` (text): When the latest candle starts, as ISO 8601 in UTC, such as 2026-10-22T08:00:00.000Z.
- `low` (number): The lowest across the window.
- `open` (number): The first candle's open.
- `resolution` (text): The candle size as Deribit names it, such as 3600.
- `resolution_label` (text): The candle size in words, such as 1 hour.
- `start` (text): The start of the window, as ISO 8601 in UTC, such as 2026-10-22T08:00:00.000Z.
- `truncated` (true/false): True when the window held more candles than came back (the latest are kept).

**Example output**

```json
{
  "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 volume (`include_inactive`, true/false): Also list the currencies that traded nothing. Left out if left empty. Default: `false`.

**Outputs**

- `count` (number): How many currencies came back.
- `include_inactive` (true/false): True when currencies with no volume were kept.
- `time` (text): When the volumes were read, as ISO 8601 in UTC, such as 2026-10-22T08:00:00.000Z.
- `volumes` (list): One row per currency, BTC, ETH, USDC and USDT first.

**Example output**

```json
{
  "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**

- Currency (`currency`, text, required): The yield-bearing currency, such as STETH.
- Days (`days`, number): How many days back, up to 365. 30 if left empty. From 1 to 365. Default: `30`.

**Outputs**

- `average_apr_percent` (number): The average yield across the days.
- `count` (number): How many days came back.
- `currency` (text): The currency, such as STETH.
- `days` (list): Day by day, newest first.
- `latest_apr_percent` (number): The newest yield, as a yearly percentage.
- `latest_date` (text): The newest day returned.
- `maximum_apr_percent` (number): The highest yield across the days.
- `minimum_apr_percent` (number): The lowest yield across the days.

**Example output**

```json
{
  "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**

- Before (`before`, date and time): Only announcements published before this time, to look back. The newest if left empty.
- How many (`limit`, number): The most announcements to return, up to 50. 10 if left empty. From 1 to 50. Default: `10`.

**Outputs**

- `announcements` (list): The announcements, newest first.
- `before` (text): The latest time asked for (null for the most recent), as ISO 8601 in UTC, such as 2026-10-22T08:00:00.000Z.
- `count` (number): How many came back.
- `latest_published_at` (text): When the newest was published, as ISO 8601 in UTC, such as 2026-10-22T08:00:00.000Z.
- `latest_title` (text): The newest announcement's headline.

**Example output**

```json
{
  "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**

- `count` (number): How many currencies came back.
- `currencies` (list): Every currency, BTC, ETH, USDC and USDT first, then the rest A to Z.

**Example output**

```json
{
  "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**

- Index (`index`, text, required): 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 many (`limit`, number): The most prices to return, up to 1,000. 30 if left empty. From 1 to 1000. Default: `30`.
- Skip (`skip`, number): How many of the newest prices to skip, to page back. None if left empty. From 0 to 1000000. Default: `0`.

**Outputs**

- `base_currency` (text): What the index prices, such as BTC.
- `count` (number): How many prices came back.
- `has_more` (true/false): True when older prices remain.
- `index` (text): The index name, such as btc_usd.
- `latest_date` (text): The newest day returned.
- `latest_price` (number): The newest price returned.
- `price_currency` (text): What the prices are in, such as USD.
- `prices` (list): The delivery prices, newest first.
- `skipped` (number): How many of the newest were skipped.
- `total` (number): How many delivery prices Deribit has for the index.

**Example output**

```json
{
  "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**

- Currency (`currency`, text, required): 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.
- Kind (`instrument_kind`, text): 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`.
- Expiry (`expiry`, text): 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 type (`option_type`, text): 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 instead (`include_expired`, true/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 many (`limit`, number): The most instruments to return, soonest expiry first. 100 if left empty. From 1 to 5000. Default: `100`.

**Outputs**

- `count` (number): How many instruments came back.
- `currency` (text): The currency asked about, such as BTC.
- `expiry` (text): The expiry asked for, such as 27NOV26, or null for every expiry.
- `has_more` (true/false): True when more matched than came back.
- `include_expired` (true/false): True when recently expired instruments were listed.
- `instruments` (list): The instruments, soonest expiry first, then by strike; perpetuals and spot pairs last.
- `kind` (text): The kind asked for, or any for every kind.
- `total` (number): How many matched before the How many cut.

**Example output**

```json
{
  "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**

- Currency (`currency`, text, required): 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.
- Kind (`instrument_kind`, text): 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`.
- Expiry (`expiry`, text): 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 type (`option_type`, text): 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 by (`sort`, text): 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 many (`limit`, number): The most rows to return. 100 if left empty. From 1 to 5000. Default: `100`.

**Outputs**

- `count` (number): How many summaries came back.
- `currency` (text): The currency asked about, such as BTC.
- `expiry` (text): The expiry asked for, such as 27NOV26, or null for every one.
- `has_more` (true/false): True when more matched than came back.
- `kind` (text): The kind asked for, such as option.
- `sort` (text): How the rows are ordered: volume, open_interest, expiry or name.
- `summaries` (list): One summary per instrument, in the order asked for.
- `total` (number): How many instruments matched before the How many cut.
- `total_volume_24h_usd` (number): The 24-hour volume of every matching instrument added up, in US dollars.

**Example output**

```json
{
  "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**

- Currency (`currency`, text, required): The currency whose settlements to list, such as BTC. It also fills the Instrument list.
- Kind (`instrument_kind`, text): 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`.
- Instrument (`instrument`, text): Only this instrument, such as BTC-PERPETUAL. Leave it empty for every instrument of the currency.
- Type (`settlement_type`, text): 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`.
- Before (`before`, date and time): Only events at or before this time, to look back. The most recent if left empty.
- How many (`limit`, number): The most events to return, up to 1,000. 20 if left empty. From 1 to 1000. Default: `20`.

**Outputs**

- `before` (text): The latest time asked for (null for the most recent), as ISO 8601 in UTC, such as 2026-10-22T08:00:00.000Z.
- `count` (number): How many events came back.
- `currency` (text): The currency asked about.
- `has_more` (true/false): True when older events remain.
- `instrument` (text): The instrument asked about, or null for the whole currency.
- `settlement_type` (text): The type asked for: all, settlement, delivery or bankruptcy.
- `settlements` (list): The events, newest first.

**Example output**

```json
{
  "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**

- Currency (`currency`, text, required): The currency whose trades to list, such as BTC. It also fills the Instrument list.
- Kind (`instrument_kind`, text): 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`.
- Instrument (`instrument`, text): Only this instrument, such as BTC-PERPETUAL. Leave it empty for every instrument of the currency and kind.
- From (`start`, date and time): The earliest trade to include. Leave From and To empty for the latest trades; with only To set, the day before it.
- To (`end`, date and time): The latest trade to include. Now if left empty.
- How many (`limit`, number): The most trades to return, up to 1,000. 100 if left empty. From 1 to 1000. Default: `100`.
- Order (`order`, text): 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_currency` (text): The instrument's amount currency, or null for a whole currency.
- `average_price` (number): For one instrument, the size-weighted average price of the trades.
- `buy_amount` (number): The size of the trades taken by buyers, added up.
- `count` (number): How many trades came back.
- `currency` (text): The currency asked about.
- `end` (text): 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_at` (text): When the earliest trade returned happened, as ISO 8601 in UTC, such as 2026-10-22T08:00:00.000Z.
- `has_more` (true/false): True when more trades match than came back.
- `high_price` (number): For one instrument, the highest price traded.
- `instrument` (text): The instrument listed, or null for a whole currency and kind.
- `kind` (text): The kind listed, or null when one instrument was listed.
- `last_trade_at` (text): When the latest trade returned happened, as ISO 8601 in UTC, such as 2026-10-22T08:00:00.000Z.
- `low_price` (number): For one instrument, the lowest price traded.
- `price_currency` (text): The instrument's price currency, or null for a whole currency.
- `sell_amount` (number): The size of the trades taken by sellers, added up.
- `source` (text): live when read from Deribit's main service (which keeps a day), history when read from its archive of every trade.
- `start` (text): The start of the window (null for the latest trades), as ISO 8601 in UTC, such as 2026-10-22T08:00:00.000Z.
- `trades` (list): The trades, in the order asked for.

**Example output**

```json
{
  "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
    }
  ]
}
```
