cURL

curl --request GET \
  --url https://test.deribit.com/api/v2/public/get_instruments \
  --header 'Content-Type: application/json' \
  --data '
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "public/get_instruments",
  "params": {
    "currency": "BTC",
    "kind": "future"
  }
}
'

import requests

url = "https://test.deribit.com/api/v2/public/get_instruments"

payload = {
    "jsonrpc": "2.0",
    "id": 1,
    "method": "public/get_instruments",
    "params": {
        "currency": "BTC",
        "kind": "future"
    }
}
headers = {"Content-Type": "application/json"}

response = requests.get(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'GET',
  headers: {'Content-Type': 'application/json'},
  body: JSON.stringify({
    jsonrpc: '2.0',
    id: 1,
    method: 'public/get_instruments',
    params: {currency: 'BTC', kind: 'future'}
  })
};

fetch('https://test.deribit.com/api/v2/public/get_instruments', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://test.deribit.com/api/v2/public/get_instruments",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_POSTFIELDS => json_encode([
    'jsonrpc' => '2.0',
    'id' => 1,
    'method' => 'public/get_instruments',
    'params' => [
        'currency' => 'BTC',
        'kind' => 'future'
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://test.deribit.com/api/v2/public/get_instruments"

	payload := strings.NewReader("{\n  \"jsonrpc\": \"2.0\",\n  \"id\": 1,\n  \"method\": \"public/get_instruments\",\n  \"params\": {\n    \"currency\": \"BTC\",\n    \"kind\": \"future\"\n  }\n}")

	req, _ := http.NewRequest("GET", url, payload)

	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.get("https://test.deribit.com/api/v2/public/get_instruments")
  .header("Content-Type", "application/json")
  .body("{\n  \"jsonrpc\": \"2.0\",\n  \"id\": 1,\n  \"method\": \"public/get_instruments\",\n  \"params\": {\n    \"currency\": \"BTC\",\n    \"kind\": \"future\"\n  }\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://test.deribit.com/api/v2/public/get_instruments")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n  \"jsonrpc\": \"2.0\",\n  \"id\": 1,\n  \"method\": \"public/get_instruments\",\n  \"params\": {\n    \"currency\": \"BTC\",\n    \"kind\": \"future\"\n  }\n}"

response = http.request(request)
puts response.read_body

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": [
    {
      "tick_size": 2.5,
      "tick_size_steps": [],
      "taker_commission": 0.0005,
      "settlement_period": "month",
      "settlement_currency": "BTC",
      "quote_currency": "USD",
      "price_index": "btc_usd",
      "min_trade_amount": 10,
      "max_liquidation_commission": 0.0075,
      "max_leverage": 50,
      "maker_commission": 0,
      "kind": "future",
      "is_active": true,
      "instrument_name": "BTC-29SEP23",
      "instrument_id": 138583,
      "instrument_type": "reversed",
      "expiration_timestamp": 1695974400000,
      "creation_timestamp": 1664524802000,
      "counter_currency": "USD",
      "contract_size": 10,
      "lot_size": 1,
      "block_trade_tick_size": 0.01,
      "block_trade_min_trade_amount": 200000,
      "block_trade_commission": 0.00025,
      "base_currency": "BTC",
      "state": "open",
      "index_id": 1000033,
      "product_group": "BTC",
      "underlying_type": "crypto"
    },
    {
      "tick_size": 0.5,
      "tick_size_steps": [],
      "taker_commission": 0.0005,
      "settlement_period": "perpetual",
      "settlement_currency": "BTC",
      "quote_currency": "USD",
      "price_index": "btc_usd",
      "min_trade_amount": 10,
      "max_liquidation_commission": 0.0075,
      "max_leverage": 50,
      "maker_commission": 0,
      "kind": "future",
      "is_active": true,
      "instrument_name": "BTC-PERPETUAL",
      "instrument_id": 124972,
      "instrument_type": "reversed",
      "expiration_timestamp": 32503708800000,
      "creation_timestamp": 1534167754000,
      "counter_currency": "USD",
      "contract_size": 10,
      "lot_size": 1,
      "block_trade_tick_size": 0.01,
      "block_trade_min_trade_amount": 200000,
      "block_trade_commission": 0.00025,
      "base_currency": "BTC",
      "state": "open",
      "index_id": 1000033,
      "product_group": "BTC",
      "underlying_type": "crypto"
    }
  ]
}

Market Data

public/get_instruments

Retrieves trading instruments, filtered by currency and optional kind. Responses are cached for about 1 minute and can be stale relative to live book state.

Note - This method has distinct API rate limiting requirements: Sustained rate: 1 request/second. To avoid rate limits, we recommend using either the REST requests for server-cached data or the WebSocket subscription to instrument_state.. for real-time updates. For more information, see Rate Limits.

With expired=false (default) the list is not limited to tradable books. It includes visible instruments (open, settlement, locked, halted) plus inactive non-combo instruments. Inactive combos are omitted; combo kinds (future_combo, option_combo) return only visible books. is_active can therefore be false on this default list. Only state open accepts new orders.

With expired=true the list is instruments still in the live table with state delivered — recently expired, not archivized. Older expired or archivized names are looked up with public/get_instrument, not this method.

currency matches derivatives by settlement currency: inverse (reversed) contracts settle in the base coin (BTC for BTC-PERPETUAL), linear contracts typically settle in the quote coin (USDC for BTC_USDC-PERPETUAL). currency=any returns every settlement currency.

Spot matching is different. A spot’s settlement field is the pair symbol (for example BTC_USDC), not BTC or USDC. When expired=false and kind is omitted/any for a specific currency, the response unions (1) derivatives with that settlement currency and (2) spots whose base or quote is that currency. kind=spot with a specific currency matches spots on either side of the pair. expired=true does not apply that extra spot union, so recently delivered spots are not returned under currency=BTC.

Results are sorted with perpetuals first, then by expiration. Each instrument includes underlying_type. Spot routed to Coinbase Exchange includes is_cbe_routed / is_csr. Set extended=true for extra commission and (on futures) margin/perpetual fields that public/get_instrument does not return.

📖 Related Articles:

Try in API console

cURL

curl --request GET \
  --url https://test.deribit.com/api/v2/public/get_instruments \
  --header 'Content-Type: application/json' \
  --data '
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "public/get_instruments",
  "params": {
    "currency": "BTC",
    "kind": "future"
  }
}
'

import requests

url = "https://test.deribit.com/api/v2/public/get_instruments"

payload = {
    "jsonrpc": "2.0",
    "id": 1,
    "method": "public/get_instruments",
    "params": {
        "currency": "BTC",
        "kind": "future"
    }
}
headers = {"Content-Type": "application/json"}

response = requests.get(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'GET',
  headers: {'Content-Type': 'application/json'},
  body: JSON.stringify({
    jsonrpc: '2.0',
    id: 1,
    method: 'public/get_instruments',
    params: {currency: 'BTC', kind: 'future'}
  })
};

fetch('https://test.deribit.com/api/v2/public/get_instruments', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://test.deribit.com/api/v2/public/get_instruments",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_POSTFIELDS => json_encode([
    'jsonrpc' => '2.0',
    'id' => 1,
    'method' => 'public/get_instruments',
    'params' => [
        'currency' => 'BTC',
        'kind' => 'future'
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://test.deribit.com/api/v2/public/get_instruments"

	payload := strings.NewReader("{\n  \"jsonrpc\": \"2.0\",\n  \"id\": 1,\n  \"method\": \"public/get_instruments\",\n  \"params\": {\n    \"currency\": \"BTC\",\n    \"kind\": \"future\"\n  }\n}")

	req, _ := http.NewRequest("GET", url, payload)

	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.get("https://test.deribit.com/api/v2/public/get_instruments")
  .header("Content-Type", "application/json")
  .body("{\n  \"jsonrpc\": \"2.0\",\n  \"id\": 1,\n  \"method\": \"public/get_instruments\",\n  \"params\": {\n    \"currency\": \"BTC\",\n    \"kind\": \"future\"\n  }\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://test.deribit.com/api/v2/public/get_instruments")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n  \"jsonrpc\": \"2.0\",\n  \"id\": 1,\n  \"method\": \"public/get_instruments\",\n  \"params\": {\n    \"currency\": \"BTC\",\n    \"kind\": \"future\"\n  }\n}"

response = http.request(request)
puts response.read_body

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": [
    {
      "tick_size": 2.5,
      "tick_size_steps": [],
      "taker_commission": 0.0005,
      "settlement_period": "month",
      "settlement_currency": "BTC",
      "quote_currency": "USD",
      "price_index": "btc_usd",
      "min_trade_amount": 10,
      "max_liquidation_commission": 0.0075,
      "max_leverage": 50,
      "maker_commission": 0,
      "kind": "future",
      "is_active": true,
      "instrument_name": "BTC-29SEP23",
      "instrument_id": 138583,
      "instrument_type": "reversed",
      "expiration_timestamp": 1695974400000,
      "creation_timestamp": 1664524802000,
      "counter_currency": "USD",
      "contract_size": 10,
      "lot_size": 1,
      "block_trade_tick_size": 0.01,
      "block_trade_min_trade_amount": 200000,
      "block_trade_commission": 0.00025,
      "base_currency": "BTC",
      "state": "open",
      "index_id": 1000033,
      "product_group": "BTC",
      "underlying_type": "crypto"
    },
    {
      "tick_size": 0.5,
      "tick_size_steps": [],
      "taker_commission": 0.0005,
      "settlement_period": "perpetual",
      "settlement_currency": "BTC",
      "quote_currency": "USD",
      "price_index": "btc_usd",
      "min_trade_amount": 10,
      "max_liquidation_commission": 0.0075,
      "max_leverage": 50,
      "maker_commission": 0,
      "kind": "future",
      "is_active": true,
      "instrument_name": "BTC-PERPETUAL",
      "instrument_id": 124972,
      "instrument_type": "reversed",
      "expiration_timestamp": 32503708800000,
      "creation_timestamp": 1534167754000,
      "counter_currency": "USD",
      "contract_size": 10,
      "lot_size": 1,
      "block_trade_tick_size": 0.01,
      "block_trade_min_trade_amount": 200000,
      "block_trade_commission": 0.00025,
      "base_currency": "BTC",
      "state": "open",
      "index_id": 1000033,
      "product_group": "BTC",
      "underlying_type": "crypto"
    }
  ]
}

Query Parameters

currency

enum<string>

required

The currency symbol or "any" for all.

📖 Related Article: Using the currency Parameter

Currency name or "any" if don't care

Available options:

BTC,

ETH,

USDC,

USDT,

EURR,

any

kind

enum<string>

Instrument kind. Omit the parameter or pass "any" for every kind.

Combos are selected with "future_combo" or "option_combo". "combo" (all combos) is not accepted here.

Instrument kind: "future", "option", "spot", "future_combo", "option_combo" or "any" for all

Available options:

future,

option,

spot,

future_combo,

option_combo,

any

expired

boolean

default:false

When false (default), return visible instruments plus inactive non-combo instruments. When true, return only instruments still in the live table with state delivered (recently expired, not archivized). Does not include the extra spot union used for a named currency when expired=false.

extended

boolean

default:false

When true, each instrument also includes maker_max_commission, taker_max_commission, liquidation_max_commission, and settlement_max_commission. Futures additionally include margin_params and trading_bandwidth_fraction; perpetuals also include perpetual_dempener and perpetual_max_funding. Default false. public/get_instrument does not accept this parameter.

Response

200 - application/json

Success response

jsonrpc

enum<string>

required

The JSON-RPC version (2.0)

Available options:

2.0

result

object[]

required

Hide child attributes

result.kind

enum<string>

required

Instrument kind: "future", "option", "spot", "future_combo", "option_combo"

Available options:

future,

option,

spot,

future_combo,

option_combo

result.base_currency

string

required

The underlying currency being traded. Not limited to BTC/ETH — altcoins, RWAs, and other listed bases are returned as their currency symbol.

result.quote_currency

string

required

The currency in which the instrument prices are quoted. Inverse options and futures are typically quoted in USD; linear and spot instruments are typically quoted in USDC or the quote coin.

result.min_trade_amount

number

required

Minimum amount for trading and the quantity increment (step size) for order amounts. For perpetual and inverse futures the amount is in USD units. For options and linear futures it is the underlying base currency coin.

This is the JSON-RPC name for the Starbase quantity increment (qty_tick_size on Starbase REST, SBE minOrderQuantity × 10^quantityExponent). JSON-RPC does not return a qty_tick_size field. Distinct from contract_size; do not assume the two values are equal.

Example:

0.1

result.instrument_name

string

required

Unique instrument identifier

Example:

"BTC-PERPETUAL"

result.is_active

boolean

required

true while the order book is visible (open, settlement, locked, or halted). false for delivered, inactive, and archivized.

This is not the same as tradable. Only state open accepts new orders; locked allows cancels only, and settlement / halted reject new orders even when is_active is true.

result.creation_timestamp

integer

required

The time when the instrument was first created (milliseconds since the UNIX epoch).

Example:

1536569522277

result.tick_size

number

required

Specifies minimal price change and, as follows, the number of decimal places for instrument prices.

Example:

0.0001

result.expiration_timestamp

integer

required

The time when the instrument will expire (milliseconds since the UNIX epoch). Present for perpetuals as well (a far-future timestamp); do not treat a non-zero value as proof the instrument is dated.

result.contract_size

number

required

Contract size for the instrument, expressed in the same unit as the order amount. For inverse (reversed) futures and perpetuals this is USD — BTC-PERPETUAL has a contract size of 10 USD. For options, spots, and for linear futures and perpetuals it is the base currency coin — BTC_USDC-PERPETUAL has a contract size of 0.0001 BTC. Note that on an inverse instrument base_currency identifies the underlying and settlement coin and does not indicate the unit of contract_size.

Distinct from min_trade_amount. contract_size converts between amount and contracts. Starbase matching uses the quantity increment, which JSON-RPC exposes as min_trade_amount (Starbase REST name: qty_tick_size). The two values may currently coincide on some instruments, but that is not a guarantee.

Example:

1

result.price_index

string

required

Name of price index that is used for this instrument

Example:

"btc_usdc"

result.underlying_type

enum<string>

required

The type of the underlying asset.

Available options:

crypto,

equity,

commodity,

preipo,

equity_etf,

crypto_index,

adr,

foreign_equity,

equity_index,

commodity_index,

commodity_etf,

otc

result.index_id

integer

required

Numeric identifier of the price index used by this instrument. Derived from the index currency pair, so all instruments sharing the same price_index also share the same index_id.

Example:

1000004

result.product_group

enum<string>

required

Product group classification of the instrument's base currency. Determines gateway and multicast channel assignment — see Underlying Tiers.

Available options:

BTC,

ETH,

TIER_2,

TIER_3,

RWA

Example:

"BTC"

result.settlement_currency

string

Optional (omitted for spot). Settlement currency for the instrument. For inverse (reversed) contracts this is the base coin (e.g. BTC); for linear contracts it is typically the quote currency (e.g. USDC).

result.counter_currency

string

Counter currency of the instrument's currency pair (e.g. USD or USDC).

result.instrument_id

integer

Instrument ID

result.settlement_period

enum<string>

Optional (omitted for spot). Calendar unit of the instrument's settlement/expiration period (minute, hour, day, week, month, or perpetual). Biweekly contracts still report week.

Available options:

minute,

hour,

day,

week,

month,

perpetual

result.tick_size_steps

object

Hide child attributes

result.tick_size_steps.above_price

number

The price from which the increased tick size applies

result.tick_size_steps.tick_size

number

Tick size to be used above the price. It must be multiple of the minimum tick size.

result.strike

number

The strike value (only for options).

result.option_type

enum<string>

The option type (only for options).

Available options:

call,

put

result.future_type

enum<string>

Future type (only for futures)(field is deprecated and will be removed in the future, instrument_type should be used instead).

Available options:

linear,

reversed

result.instrument_type

string

Type of the instrument. linear or reversed. Present for options and spots as well as futures; do not assume it is futures-only.

result.lot_size

number

Lot size for instrument, used as the unit for fee lot counting. Omitted when the instrument has no configured lot size.

Example:

1

result.maker_commission

number

Maker commission for instrument.

Example:

0.0001

result.taker_commission

number

Taker commission for instrument.

Example:

0.0005

result.max_liquidation_commission

number

Maximal liquidation trade commission for instrument (only for futures).

Example:

0.001

result.maker_max_commission

number

Optional. Maximum maker commission. Returned only when extended=true on public/get_instruments.

result.taker_max_commission

number

Optional. Maximum taker commission. Returned only when extended=true on public/get_instruments.

result.liquidation_max_commission

number

Optional. Maximum liquidation commission. Returned only when extended=true on public/get_instruments. Distinct from max_liquidation_commission, which is present on futures without extended.

result.settlement_max_commission

number

Optional. Maximum settlement commission. Returned only when extended=true on public/get_instruments.

result.margin_params

object

Optional (futures only). Formatted margin parameters. Returned only when extended=true on public/get_instruments.

Hide child attributes

result.margin_params.i_inc

number

result.margin_params.m_fee

number

result.margin_params.m_inc

number

result.margin_params.m_init

number

result.margin_params.m_pow

number

result.trading_bandwidth_fraction

number

Optional (futures only). Trading bandwidth fraction used in mark-price logic. Returned only when extended=true on public/get_instruments.

result.perpetual_dempener

number

Optional (perpetual futures only). Perpetual funding dampener. Returned only when extended=true on public/get_instruments. The JSON field name is spelled dempener.

result.perpetual_max_funding

number

Optional (perpetual futures only). Maximum funding rate. Returned only when extended=true on public/get_instruments.

result.block_trade_commission

number

Block Trade commission for instrument. Omitted for spot routed to Coinbase Exchange (CSR), which does not support block trades.

Example:

0.0005

result.block_trade_tick_size

number

Specifies minimal price change for block trading.

Example:

0.01

result.block_trade_min_trade_amount

number

Minimum amount for block trading.

Example:

25

result.max_leverage

integer

Maximal leverage for the default risk profile. Present on futures. Also present on some USDC spot pairs when spot margin loans are enabled (borrowable base, USDC quote); other spots omit the field. Not present on options.

Example:

100

result.max_non_default_leverage

integer

Maximal leverage for the non-default risk profile (futures only). Omitted on options and spots.

result.state

enum<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. In this state book is accepting new orders, edits, cancels; prices should be updated, trading is live.
settlement: Books enters to this state during settlement/delivery. New orders, edits, cancels are not accepted. After this state normally next state should be open if it was settlement, or delivered if it was delivery. On enter to this state good till day orders in book are canceled.
delivered: Final state of book that has been delivered. New orders, edits, cancels are not accepted. After some time book process will be terminated and, instrument moved to expired_instruments and its instrument_state will become archivized. On enter to this all open orders in book are canceled.
inactive: After a book is deactivated, this state is set on book. New orders, edits, cancels are not accepted. On enter to this all open orders in book are canceled. Book in this state is not considered as open. This can be also final state for book.
locked: New orders, edits, are not accepted, only cancels ARE accepted. In some cases when configured books can start as locked or it may become locked on admin request. Settlement is possible on locked books.
halted: The state that books enter as a result of an error. Settlement is not possible when there is at least one book in this state.
archivized: Set when instrument is moved to expired_instruments table, final state.

Available options:

open,

settlement,

delivered,

inactive,

locked,

halted,

archivized

result.base_currency_uuid

string

Internal identifier for the base currency. Absent if the base currency does not have an assigned identifier.

Example:

"5b71fc48-3dd3-540c-809b-f8c94d0e68b5"

result.quote_currency_uuid

string

Internal identifier for the quote currency. Absent if the quote currency does not have an assigned identifier.

Example:

"2b92315d-eab7-5bef-84fa-089a131333f5"

result.is_csr

boolean

Optional (only for spot routed to Coinbase Exchange). When present it is always true, meaning orders on this instrument are routed to Coinbase Exchange (CBE) for matching instead of the native Deribit matching engine. The field is omitted for every other instrument, so test for its presence rather than for a false value.

result.is_cbe_routed

boolean

Optional (only for spot routed to Coinbase Exchange). Alias of is_csr added by public/get_instrument and public/get_instruments; other surfaces that return instrument metadata, such as the instrument.creation.{kind}.{currency} notification, carry is_csr only. When present it is always true and is omitted for every other instrument, so test for its presence rather than for a false value.

integer

The id that was sent in the request

Methods overview

Methods

public/get_instruments

Query Parameters

Response