Deribit Public API
Public methods can be used without authentication.
Deribit Public API is one of 19 APIs that Deribit publishes on the APIs.io network, described by a machine-readable OpenAPI specification.
Tagged areas include Public. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, authentication docs, and rate-limit docs.
This API exposes 46 operations across 46 paths, and defines 110 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.
46 operations
46 paths
110 schemas
46 GET
Metadata
The identity and technical contract details declared by the specification.
Paths & Operations 46
Across 46 paths, the API surfaces 46 operations — 46 GET. Each is listed below with its method, path, parameters, and response codes.
Public 46
Public methods can be used without authentication.
GET
/public/get_announcements
Retrieves platform announcements and important notices. Announcements include system updates, maintenance schedules, new features, policy changes, and other important information. Results are returne…
GET
/public/auth
Retrieve an OAuth access token, to be used for authentication of 'private' requests. 📖 Related Article: [Authentication](https://docs.deribit.com/articles/authentication) Authentication Methods: Thre…
GET
/public/exchange_token
Generates a token for a new subject id. This method can be used to switch between subaccounts. 📖 Related Articles: - [Fork and Exchange Tokens](https://docs.deribit.com/articles/authenticationfork-an…
GET
/public/fork_token
Generates a token for a new named session. This method can be used only with session scoped tokens. 📖 More Details: [Fork and Exchange Tokens](https://docs.deribit.com/articles/authenticationfork-and…
GET
/public/get_block_rfq_trades
Returns a list of recent Block RFQ trades. Can be optionally filtered by currency. This is a public method that provides market data about completed Block RFQ trades. For private Block RFQ informatio…
GET
/public/get_combos
Retrieves information about active combos for the specified currency. Returns detailed information including leg structures and combo properties. For a list of combo IDs only, use [public/getcomboids…
GET
/public/get_combo_ids
Retrieves available combo IDs. This method can be used to get the list of all combos, or only the list of combos in the given state. Use [public/getcombodetails](https://docs.deribit.com/api-referenc…
GET
/public/get_combo_details
Retrieves detailed information about a specific combo, including its leg structure, state, and other properties. Use [public/getcomboids](https://docs.deribit.com/api-reference/combo-books/public-get…
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/set_heartbeat
Signals the WebSocket connection to send and request heartbeats. Heartbeats can be used to detect stale connections. When heartbeats have been set up, the API server will send heartbeat messages and…
GET
/public/disable_heartbeat
Stop sending heartbeat messages. This method takes no parameters. WebSocket Only: This method is designed exclusively for WebSocket connections. Attempting to use it via REST/HTTP will result in an e…
GET
/public/subscribe
Subscribe to one or more channels. This is the same method as /private/subscribe, but it can only be used for 'public' channels. For a complete list of available subscription channels and their notif…
GET
/public/unsubscribe
Unsubscribe from one or more channels. The response contains only the channels that were successfully unsubscribed in this request. For a complete list of available subscription channels and their no…
GET
/public/unsubscribe_all
Unsubscribe from all the channels subscribed so far. This method takes no parameters. [Try in API console](https://test.deribit.com/apiconsole?method=%2Fpublic%2Funsubscribeall)
GET
/public/hello
Method used to introduce the client software connected to Deribit platform over websocket. Provided data may have an impact on the maintained connection and will be collected for internal statistical…
GET
/public/status
Method used to get information about locked currencies [Try in API console](https://test.deribit.com/apiconsole?method=%2Fpublic%2Fstatus)
GET
/public/test
Tests the connection to the API server, and returns its version. You can use this to make sure the API is reachable, and matches the expected version. [Try in API console](https://test.deribit.com/ap…
GET
/public/get_time
Retrieves the current time (in milliseconds). This API endpoint can be used to check the clock skew between your software and Deribit's systems. [Try in API console](https://test.deribit.com/apiconso…
Schemas 110
The contract defines 110 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.
PublicGetComboIdsResponse
object
3 properties
2 required
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…
PublicGetTimeResponse
object
3 properties
2 required
combo_id
string
Unique combo identifier
currency_with_any_and_grouped
string
Currency name or "any" if don't care or "grouped" if grouped by currencies
api_key_features
array
List of enabled advanced on-key features. Available options: - restrictedblocktrades : Limit the blocktrade read the scope of the API key to block trades that…
kind_with_combo_all
string
Instrument kind: "future", "option", "spot", "futurecombo", "optioncombo", "combo" for any combo or "any" for all
PublicGetBlockRfqTradesResponse
object
3 properties
2 required
PublicTestResponse
object
3 properties
2 required
PublicGetCombosResponse
object
3 properties
2 required
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
combo_state
string
Combo state: "active", "inactive"
price
number
Price in base currency
PublicGetFundingRateValueResponse
object
3 properties
2 required
PublicGetIndexPriceNamesResponse
object
3 properties
2 required
stats
object
5 properties
3 required
PublicGetAnnouncementsResponse
object
3 properties
2 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
block_rfq_trade_tape_continuation
string
Continuation token for pagination. NULL when no continuation. Consists of timestamp and blockrfqid.
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
currency_with_any
string
Currency name or "any" if don't care
PrivateSubscribeResponse
object
3 properties
2 required
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
combo_leg
object
2 properties
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
PublicGetComboDetailsResponse
object
3 properties
2 required
combo_leg_amount
integer
Size multiplier of a leg. A negative value indicates that the trades on given leg are in opposite direction to the combo trades they originate from
PublicAuthResponse
object
3 properties
2 required
tick_direction
integer
Direction of the "tick" (0 = Plus Tick, 1 = Zero-Plus Tick, 2 = Minus Tick, 3 = Zero-Minus Tick).
block_rfq_hedge_leg
object
4 properties
currency_with_apr
object
12 properties
6 required
PublicGetInstrumentResponse
object
3 properties
2 required
PublicGetExpirationsResponse
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
ErrorMessageResponse
object
4 properties
3 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
PublicTokenResponse
object
3 properties
2 required
public_trade
object
18 properties
10 required
Getunsubscribe200response
object
3 properties
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
combo
object
6 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.
OkResponse
object
3 properties
2 required
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
leg_structure
array
PublicStatusResponse
object
3 properties
2 required
quote_price
number
Price in quote currency
asks
array
index_price
number
Current index price
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 Market Data API
Deribit Matching Engine API
Deribit Portfolio Management API
Deribit Private API
#Public
Where this information came from
This is an independent, third-party profile of Deribit Public 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.