Deribit Market Data API
The Market Data API from Deribit — 31 operation(s) for market data.
Deribit Market Data API is one of 19 APIs that Deribit publishes on the APIs.io network, described by a machine-readable OpenAPI specification.
Tagged areas include Market Data. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, authentication docs, and rate-limit docs.
This API exposes 31 operations across 31 paths, and defines 92 schemas. It is described by OpenAPI 3.0.0, at version 2.1.1.
Requests are made against a single base URL, https://test.deribit.com/api/v2.
31 operations
31 paths
92 schemas
31 GET
Metadata
The identity and technical contract details declared by the specification.
Paths & Operations 31
Across 31 paths, the API surfaces 31 operations — 31 GET. Each is listed below with its method, path, parameters, and response codes.
Market Data 31
GET
/public/get_order_book
Retrieves the order book (bids and asks) for a given instrument, along with other market values such as best bid/ask prices, last trade price, mark price, and index price. The order book depth can be…
GET
/public/get_order_book_by_instrument_id
Retrieves the order book (bids and asks) for a given instrument ID, along with other market values such as best bid/ask prices, last trade price, mark price, and index price. This method is similar t…
GET
/public/get_last_settlements_by_currency
Retrieves historical settlement, delivery, and bankruptcy events from all instruments within a given currency. Settlements occur when futures or options contracts expire and are settled at the delive…
GET
/public/get_book_summary_by_currency
Retrieves summary information such as open interest, 24-hour volume, best bid/ask prices, last trade price, and other market statistics for all instruments in a given currency. Results can be filtere…
GET
/public/get_book_summary_by_instrument
Retrieves summary information such as open interest, 24-hour volume, best bid/ask prices, last trade price, mark price, and other market statistics for a specific instrument. This method provides a q…
GET
/public/get_last_settlements_by_instrument
Retrieves historical settlement, delivery, and bankruptcy events for a specific instrument. Settlements occur when futures or options contracts expire and are settled at the delivery price. Results c…
GET
/public/get_contract_size
Retrieves the contract size (also known as contract multiplier) for a given instrument. The contract size determines how many units of the underlying asset one contract represents. This value is esse…
GET
/public/get_trade_volumes
Retrieves aggregated 24-hour trade volumes for different instrument types and currencies. The volume statistics include all executed trades across the platform. Note: Position moves are not included…
GET
/public/get_index_price
Retrieves the current index price value for a given index name. Index prices are used as reference prices for mark price calculations and settlement. Use getindexpricenames or getsupportedindexnames…
GET
/public/get_index_price_names
Retrieves the identifiers (names) of all supported price indexes. Price indexes are reference prices used for mark price calculations, settlement, and other market operations. When the extended param…
GET
/public/get_supported_index_names
Retrieves the identifiers (names) of all supported price indexes, optionally filtered by index type. Price indexes are reference prices used for mark price calculations, settlement, and other market…
GET
/public/get_instruments
Retrieves available trading instruments. This method can be used to see which instruments are available for trading, or which instruments have recently expired. Note - This method has distinct API ra…
GET
/public/get_instrument
Retrieves detailed information about a specific instrument, including instrument specifications, contract details, tick size, settlement currency, expiration date (for futures and options), strike pr…
GET
/public/get_historical_volatility
Provides historical volatility data for a given cryptocurrency. Historical volatility measures the degree of price variation over a past period and is useful for risk assessment and option pricing. T…
GET
/public/get_funding_rate_history
Retrieves hourly historical funding rate (interest rate) data for a PERPETUAL instrument over a specified time period. Funding rates are periodic payments exchanged between long and short positions i…
GET
/public/get_funding_rate_value
Retrieves the funding rate (interest rate) value for a perpetual instrument over a specified time period. Funding rates are periodic payments exchanged between long and short positions in perpetual c…
GET
/public/get_index_chart_data
Returns historical price index chart data for the specified index name and time range. The data is formatted for use in charting applications and shows price index values over time. Use the range par…
GET
/public/get_mark_price_history
Retrieves 5-minute historical mark price data for an instrument. Mark prices are used for margin calculations and position valuations. Note: Currently, mark price history is available only for a subs…
GET
/public/get_expirations
Retrieves all available expiration timestamps for instruments. This method can be used to discover which expiration dates are available for trading, which is useful for finding instruments with speci…
GET
/public/get_apr_history
Retrieves historical Annual Percentage Rate (APR) data for yield-generating tokens. APR represents the annualized return rate for holding these tokens on Deribit. This method is only applicable to yi…
GET
/public/get_last_trades_by_instrument
Retrieves the latest trades that have occurred for a specific instrument. Returns trade details including price, amount, direction, timestamp, and trade ID. Results can be filtered by sequence number…
GET
/public/get_last_trades_by_instrument_and_time
Retrieves the latest trades that have occurred for a specific instrument within a specified time range. Returns trade details including price, amount, direction, timestamp, and trade ID. Use the coun…
GET
/public/get_last_trades_by_currency
Retrieves the latest trades that have occurred for instruments in a specific currency. Returns trade details including price, amount, direction, timestamp, and trade ID for all instruments in the cur…
GET
/public/get_last_trades_by_currency_and_time
Retrieves the latest trades that have occurred for instruments in a specific currency within a specified time range. Returns trade details including price, amount, direction, timestamp, and trade ID.…
GET
/public/get_currencies
Retrieves all cryptocurrencies supported by the Deribit API. Returns a list of available currencies with their codes and basic information. This method takes no parameters and is useful for discoveri…
GET
/public/get_funding_chart_data
Retrieves funding rate chart data points for a PERPETUAL instrument within a given time period. The data is formatted for use in charting applications and includes funding rate values at regular inte…
GET
/public/get_tradingview_chart_data
Retrieves publicly available market data formatted for generating TradingView-compatible candle charts. The data includes open, high, low, close (OHLC) prices and volume for specified time intervals.…
GET
/public/get_volatility_index_data
Retrieves volatility index (VIX) chart data formatted as candles. Volatility indexes measure market expectations of future volatility and are useful for risk assessment and trading strategies. Use th…
GET
/public/ticker
Retrieves the ticker (24-hour statistics) for a specific instrument. The ticker includes the last trade price, best bid/ask prices, 24-hour high/low, 24-hour volume, open interest, mark price, and ot…
GET
/public/get_delivery_prices
Retrieves historical delivery prices for a given index. Delivery prices are the settlement prices used when futures or options contracts expire and are settled. Results can be paginated using the off…
GET
/api/v2/public/get_instruments
List Instruments
Schemas 92
The contract defines 92 schemas that model the data the API accepts and returns. The most detailed are instrument (28 properties), TickerNotificationWithBidsAndAsks (27 properties), TickerNotification (27 properties), book_summary (23 properties). Each schema is shown below with its type and property counts.
bids
array
PublicTradesHistoryResponse
object
3 properties
2 required
settlement_type
string
The type of settlement. settlement, delivery or bankruptcy.
trades_volumes
object
13 properties
4 required
continuation
string
Continuation token for pagination.
PublicGetIndexPriceResponse
object
3 properties
2 required
book_state
string
The state of the order book. Represents the current lifecycle stage of the instrument. State Lifecycle and Meanings: - open: Default state for running books. I…
currency_with_any_and_grouped
string
Currency name or "any" if don't care or "grouped" if grouped by currencies
kind_with_combo_all
string
Instrument kind: "future", "option", "spot", "futurecombo", "optioncombo", "combo" for any combo or "any" for all
open_interest
number
The total amount of outstanding contracts in the corresponding amount units. For perpetual and inverse futures the amount is in USD units. For options and line…
sorting
string
price
number
Price in base currency
Instrument
object
A tradeable instrument's reference data.
19 properties
4 required
PublicGetFundingRateValueResponse
object
3 properties
2 required
PublicGetIndexPriceNamesResponse
object
3 properties
2 required
date
string
The event date with year, month and day
stats
object
5 properties
3 required
PublicGetIndexChartDataResponse
object
3 properties
2 required
block_trade_id_in_result
string
Block trade id - when trade was part of a block trade
best_ask_amount
number
It represents the requested order size of all best asks
PublicGetTradesVolumesResponse
object
3 properties
2 required
PublicGetVolatilityIndexDataResponse
object
3 properties
2 required
trade_id
string
Unique (per currency) trade identifier
settlement_price
number
Optional (not added for spot). The settlement price for the instrument. Only when state = open
TickerNotificationWithBidsAndAsks
object
27 properties
16 required
interest_rate
number
Interest rate used in implied volatility calculations (options only)
timestamp
integer
The timestamp (milliseconds since the Unix epoch)
instrument_id
integer
Instrument ID
underlying_price
number
Underlying price for implied volatility calculations (options only)
contract_size
integer
Contract size, for futures in USD, for options in base currency of the instrument (BTC, ETH, ...)
PublicGetBookSummaryResponse
object
3 properties
2 required
currency
string
Currency, i.e "BTC", "ETH", "USDC"
bid_iv
number
(Only for option) implied volatility for best bid
settlement
object
14 properties
7 required
direction
string
Direction: buy, or sell
GetInstrumentsResponse
object
3 properties
2 required
currency_with_any
string
Currency name or "any" if don't care
PublicGetOrderBookResponse
object
3 properties
2 required
block_trade_leg_count
integer
Block trade leg count - when trade was part of a block trade
volume_usd
number
Volume in usd (futures only)
book_summary
object
23 properties
13 required
instrument_name
string
Unique instrument identifier
mark_iv
number
(Only for option) implied volatility for mark price
current_funding
number
Current funding (perpetual only)
funding_8h
number
Funding 8h (perpetual only)
PublicGetMarkPriceHistoryResponse
object
3 properties
2 required
PublicGetInstrumentsResponse
object
3 properties
2 required
delivery_price
number
The settlement price for the instrument. Only when state = closed
price_index
string
Name of price index that is used for this instrument
mark_price
number
The mark price for the instrument
instrument
object
28 properties
12 required
settlement_currency_with_any_and_grouped
string
Currency name or "any" if don't care or "grouped" if grouped by currencies
best_bid_amount
number
It represents the requested order size of all best bids
kind_future_or_option_with_any
string
Instrument kind: "future", "option" or "any" for all
tick_direction
integer
Direction of the "tick" (0 = Plus Tick, 1 = Zero-Plus Tick, 2 = Minus Tick, 3 = Zero-Minus Tick).
currency_with_apr
object
12 properties
6 required
PublicGetInstrumentResponse
object
3 properties
2 required
PublicGetExpirationsResponse
object
3 properties
2 required
PublicGetDeliveryPricesResponse
object
3 properties
2 required
trade_timestamp
integer
The timestamp of the trade (milliseconds since the UNIX epoch)
PublicGetFundingChartDataResponse
object
3 properties
2 required
PublicGetHistoricalVolatilityResponse
object
3 properties
2 required
greeks
object
Only for options. Greeks are risk measures that describe how the option's price changes with respect to various factors. Delta (Δ) Deribit uses two different D…
5 properties
5 required
max_price
number
The maximum price for the future. Any buy orders you submit higher than this price, will be clamped to this maximum.
PublicGetContractSizeResponse
object
3 properties
2 required
PublicGetFundingRateHistoryResponse
object
3 properties
2 required
key_number_pair
object
2 properties
2 required
PublicTickerResponse
object
3 properties
2 required
best_ask_price
number
The current best ask price, null if there aren't any asks
best_bid_price
number
The current best bid price, null if there aren't any bids
trade_seq
integer
The sequence number of the trade within instrument
index_name
string
Index identifier, matches (base) cryptocurrency with quote currency
public_trade
object
18 properties
10 required
ask_iv
number
(Only for option) implied volatility for best ask
PublicSettlementResponse
object
3 properties
2 required
kind
string
Instrument kind: "future", "option", "spot", "futurecombo", "optioncombo"
tick_size_step
object
2 properties
min_price
number
The minimum price for the future. Any sell orders you submit lower than this price will be clamped to this minimum.
underlying_index
number
Name of the underlying future, or indexprice (options only)
TickerNotification
object
27 properties
15 required
expirations
object
A map where each key is valid currency (e.g. btc, eth, usdc), and the value is a list of expirations or a map where each key is a valid kind (future or options…
2 properties
estimated_delivery_price
number
Estimated delivery price for the market. For more details, see Contract Specification General Documentation Expiration Price
PublicGetTradingviewChartDataResponse
object
3 properties
2 required
last_price
number
The price for the last trade
PublicGetCurrenciesResponse
object
3 properties
2 required
quote_price
number
Price in quote currency
asks
array
index_price
number
Current index price
JsonRpcError
object
JSON-RPC 2.0 error envelope returned for failed requests.
3 properties
2 required
chart_volume
number
// todo
PublicGetAprHistoryResponse
object
3 properties
2 required
interest_value
number
Value used to calculate realizedfunding in positions (perpetual only)
Specification
The full machine-readable OpenAPI contract behind this narrative.
Source
More from Deribit 12
Other APIs Deribit publishes across the network.
Deribit WebSocket API
Deribit FIX API
Deribit Account Management API
Deribit Authentication API
Deribit Block RFQ API
Deribit Block Trade API
Deribit Combo Books API
Deribit Mark Price API
Deribit Matching Engine API
Deribit Portfolio Management API
Deribit Private API
Deribit Public API
#Market Data
Where this information came from
This is an independent, third-party profile of Deribit Market Data API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.
The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.
Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.
info@apievangelist.com
·
Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and
you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.