Derivatives contract details V3

Beta version for Beta users.

What is this endpoint for?

This endpoint provides details of the contracts, including base asset, quote asset, contract size, contract size unit, listing_timestamp, expiry, strike price, and underlying index.

This is a new beta endpoint only supporting the following Exchanges:

• Binance, BitMEX, Bybit, Deribit, and Okex.

Endpoint

https://<eu|us>.market-api.kaiko.io/v3/data/derivatives/reference

Path parameters

Parameter	Required?	Example
region	Yes	Choose between eu and us.

Query parameters

Parameter	Required	Description	Example
exchange	Yes	Should be one of the exchanges currently supported.	okex
instrument_class	Yes	future, perpetual-future, option, future_combo or option_combo	future
contract_type	No	linear, inverse, or quanto If not used, all per default For finding either the Linear or Inverse contracts.	linear
instrument	No	Instrument code. (kaiko_legacy_code) See Exchange trading pair codes (instruments)	ethusd220624, btc*220624, *usdt, btc*may22*
base_assets	No	For finding the instruments with the certain base asset	btc, eth
quote_assets	No	For finding the instruments with the certain quote asset	usd, usdt
option_type	No	option only. For finding either only the call options or put options	C, P
min_strike	No	option only. Used to retrieve options whose strike price is above this minimum value (exclusive/inclusive)	10000
max_strike	No	option only. Used to retrieve options whose strike price is below this maximum value (exclusive/inclusive)	90000
start_time	No	future & option only. Used to retrieve futures and options that expire after this date and time (inclusive)	2022-06-23T00:01:00.000Z
end_time	No	future & option only. Used to retrieve futures and options that are listed before this date and time (exclusive)	2022-06-25T23:59:00.000Z
page_size	No	Number of snapshots to return data for. (default: 1000, min: 1, max: 10000). See Pagination	500

Fields: Perpetual-Future

Field	Description	Example
exchange	The exchange where the specified instrument is being traded	drbt
instrument_class	Shows the specified instrument class.	perpetual-future
instrument	The specified instrument	btc-usd
base	The base asset of the instrument	btc
quote	The unit in which the instrument is quoted	usd
settle_currency	Currency used for settlement	btc
settle_method	Always cash (for future use)	cash
contract_type	Type of the contract	inverse
contract_periodicity	Possible values: perpetual	perpetual
contract_size	Size of the contract	10
contract_size_unit	Unit in which contract is denominated	usd
contract_multiplier		1
listing_timestamp	(UTC) Date listed by exchange	2018-09-14T10:24:47Z
funding_rate_frequency	Interval at which the funding rate is calculated (paid) for payoff.	8h
status	Status of the Derivative Contract. Possible values: listed, tradable, delisted	tradable
last_updated	Date and time of the last update.	2018-09-21T10:20:00Z

Fields: Future

Field	Description	Example
exchange	The exchange where the specified instrument is being traded	drbt
instrument_class	Shows the specified instrument class.	future
instrument	The specified instrument	btcusdc29may26
base	The base asset of the instrument	btc
quote	The unit in which the instrument is quoted	usdc
settle_currency	Currency used for settlement	usdc
settle_timestamp	Date and time of the settlement if provided by the Exchange (expiry per default)	2026-03-31T08:00:00Z
settle_method	For future use. Default = cash	cash
contract_type	Type of the contract	linear
contract_periodicity	Possible values: daily, monthly, quarterly	monthly
contract_size	Size of the contract	0.0001
contract_size_unit	Unit in which contract is denominated	btc
contract_multiplier		1
listing_timestamp	The timestamp (UTC) when the contract is listed on the exchange	2026-03-31T10:43:48Z
expiry	Expiration date of the contract	2026-03-31T08:00:00Z
status	Status of the Derivative Contract. Possible values: listed, tradable, expired, delisted	delisted
last_updated	Date and time of the last update.	2026-03-31T11:01:20Z

Fields: Option

Field	Description	Example
exchange	The exchange where the specified instrument is being traded	drbt
instrument_class	Shows wether the specified instrument is	option
instrument	The specified instrument	btcusdc21jan2686000c
base	The base asset of the instrument	btc
quote	The unit in which the instrument is quoted	usdc
settle_currency	Currency used for settlement	usdc
settle_timestamp	Date and time of the settlement if provided by the Exchange (expiry per default)	2026-01-20T08:00:00Z
settle_method	Always cash (for future use)	cash
contract_type	Type of the contract	linear
contract_periodicity	Possible values: daily, monthly, quarterly	daily
contract_size	Size of the contract	1
contract_size_unit	Unit in which contract is denominated	btc
contract_multiplier		1
listing_timestamp	The (UTC) timestamp when a certain option instrument is listed on the exchange	2026-01-20T15:09:00Z
expiry	Expiration (UTC) date of the contract	2026-01-20T08:00:00Z
strike_price	The strike price of the contract in USD.	30000
kind	It explains what the option does, the direction of the right. Note: it reflects the option_type from the Query parameters.	call
option_type	This defines when the option can be exercised. In other words, it is the exercise period. european american	european
underlying_type	For future use. Default = index	index
underlying_index	Name of the underlying asset	btc_usdc
status	Status of the Derivative Contract. Possible values: listed, tradable, expired, delisted	expired
last_updated	Date and time of the last update.	2026-01-20T15:09:00Z

Fields: future_combo & option_combo

Field	Description	Example
exchange	The exchange where the specified instrument is being traded	drbt
instrument_class	Shows wether the specified instrument is	option_combo
instrument	The specified instrument	btcps27mar263000020000
base	The base asset of the instrument	btc
quote	The unit in which the instrument is quoted	usdc
settle_currency	Currency used for settlement	usdc
settle_timestamp	Date and time of the settlement if provided by the Exchange (expiry per default)	2026-01-20T08:00:00Z
settle_method	Always cash (for future use)	cash
contract_type	Type of the contract	linear
contract_periodicity	Possible values: daily, monthly, quarterly	daily
contract_size	Size of the contract	1
contract_size_unit	Unit in which contract is denominated	btc
contract_multiplier
listing_timestamp	The (UTC) timestamp when a certain option instrument is listed on the exchange	2026-02-05T23:08:33Z
expiry	Expiration (UTC) date of the contract. The expiry should be the latest in time from the various legs.	2026-03-27T08:00:00Z
underlying_type	For future use. Default = index	index
underlying_index	Name of the underlying asset	btc_usdc
combo_type	type of the combo (strategy)	straddle
leg_symbol	Exchange contract (instrument) related to the leg	BTC-27MAR26-30000-P
leg_side	Side of the leg buy or sell	buy
leg_multiplier	Number of contract in involved in the related leg.	1
status	Status of the Derivative Contract. Possible values: listed, tradable, expired, delisted	expired
last_updated	Date and time of the last update.	2026-01-20T15:09:00Z

Request example

Not the final Url.

cURL

curl --compressed -H 'Accept: application/json' -H 'X-Api-Key: <client-api-key>' \
'https://us.market-api.kaiko.io/https://nicole-preprod.k8s.kaiko.ovh/v3/data/derivatives/reference?exchange=drbt&instrument_class=perpetual-future&base_assets=btc&quote_assets=usd&page_size=50'```python

Tab 2

Reponse example

Depending on the Instrument class.

Perpetual-future

{
    "result": "success",
    "time": "2026-05-22T14:23:32Z",
    "timestamp": 1779459812625,
    "query": {
        "base_assets": "btc",
        "contract_type": "",
        "end_time": "0001-01-01T00:00:00Z",
        "exchange": "drbt",
        "instrument_class": "perpetual-future",
        "max_strike": "0",
        "min_strike": "0",
        "offset": "0",
        "option_type": "",
        "page_size": "1",
        "request_time": "2026-05-22T14:23:32.25632683Z",
        "start_time": "0001-01-01T00:00:00Z"
    },
    "data": [
        {
            "exchange": "drbt",
            "instrument_class": "perpetual-future",
            "instrument": "btc-usd",
            "metadata": null,
            "contract_details": {
                "base": "btc",
                "quote": "usd",
                "settle_method": "cash",
                "settle_timestamp": null,
                "settle_currency": "btc",
                "contract_type": "inverse",
                "contract_periodicity": "perpetual",
                "contract_size": "10",
                "contract_size_unit": "usd",
                "contract_multiplier": "1",
                "funding_rate_frequency": "8h",
                "listing_timestamp": "2018-08-14T10:24:47Z",
                "underlying_type": "index",
                "underlying_index": "btc_usd"
            },
            "status_details": {
                "status": "tradable",
                "last_updated": "2026-03-19T14:02:01Z",
                "created_at": "2026-03-19T14:02:01Z"
            }
        }
    ],
    "continuation_token": "2jtw7jtDEqGviMXUbzCyPMYCregKKZdhgxaB9DNJkoUPV3oYiFzkVi6V1YfyQx4vHaNtqWxE5rQq6yyj5SNp32T1etHnAn5ErCAkp6oyyqZ8PCZ2TsyFrQoCspu8R65fG",
    "next_url": "https://nicole-preprod.k8s.kaiko.ovh/v3/data/derivatives/reference?continuation_token=2jtw7jtDEqGviMXUbzCyPMYCregKKZdhgxaB9DNJkoUPV3oYiFzkVi6V1YfyQx4vHaNtqWxE5rQq6yyj5SNp32T1etHnAn5ErCAkp6oyyqZ8PCZ2TsyFrQoCspu8R65fG",
    "links": {
        "next": "/v3/data/derivatives/reference?base_assets=btc&exchange=drbt&instrument_class=perpetual-future&offset=1&page_size=1&sort=desc"
    },
    "access": {
        "access_range": {
            "start_timestamp": 1688428800000,
            "end_timestamp": 2177539199000
        },
        "data_range": {
            "start_timestamp": null,
            "end_timestamp": null
        }
    }
}

Future

Option

Future_combo or Option_combo