List Instruments - Deribit API Documentation

Query Parameters

currency

string

Filter by the base currency of the instrument's currency pair (e.g. BTC, ETH, AVAX). Case-insensitive.

kind

enum<string>

Filter by instrument kind. Case-insensitive.

Available options:

perp_future,

option,

spot,

future_combo,

option_combo,

dated_future

expired

boolean

When true, return only expired instruments. When false, return only currently-active (non-expired) instruments. Omit to return both.

Response

List of instruments matching the supplied filters.

jsonrpc

enum<string>

required

The JSON-RPC version (2.0)

Available options:

2.0

result

object[]

required

Array of instruments matching the supplied filters. May be empty.

Hide child attributes

result.instrument_id

integer<int64>

required

Stable numeric identifier for the instrument.

Example:

124942

result.instrument_name

string

required

Human-readable instrument symbol (e.g. ETH-PERPETUAL, BTC-30MAY26-70000-C).

Example:

"ETH-PERPETUAL"

result.kind

enum<string>

required

Instrument category.

Available options:

perp_future,

option,

spot,

future_combo,

option_combo,

dated_future

result.is_active

boolean

required

Whether the instrument is currently enabled for trading.

result.product_group

string | null

Product grouping resolved from the base symbol of the instrument's currency pair.

Example:

"ETH"

result.base_currency

string | null

Base currency of the instrument's currency pair.

Example:

"ETH"

result.quote_currency

string | null

Quote currency of the instrument's currency pair.

Example:

"USDC"

result.settlement_currency

string | null

Settlement currency for the instrument. Currently equal to quote_currency.

Example:

"USDC"

result.tick_size

number

Minimum price increment for the instrument.

Example:

0.01

result.strike

number | null

Strike price (options only). null for non-option instruments.

Example:

70000

result.option_type

enum<string> | null

Option type (options only). null for non-option instruments.

Available options:

call,

put

result.expiration_timestamp

integer<int64> | null

Instrument expiration time in milliseconds since the Unix epoch. null for perpetuals and other non-expiring instruments.

Example:

1779148800000

result.creation_timestamp

integer<int64> | null

Instrument creation/listing time in milliseconds since the Unix epoch.

Example:

1747500000000

result.min_trade_amount

number | null

Minimum allowed order quantity. May be null if not yet populated.

result.contract_size

number | null

Contract size for the instrument. May be null if not yet populated.

result.settlement_period

string | null

Settlement period descriptor. May be null if not yet populated.

result.maker_commission

number | null

Maker commission rate. May be null if not yet populated.

result.taker_commission

number | null

Taker commission rate. May be null if not yet populated.

result.block_trade_commission

number | null

Block trade commission rate. May be null if not yet populated.

integer

The id that was sent in the request