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 price (for options), and other instrument parameters.

This method is useful for obtaining instrument metadata needed for trading operations and calculations.

Try in API console

cURL

cURL

curl --request GET \
  --url https://test.deribit.com/api/v2/public/get_instrument \
  --header 'Content-Type: application/json' \
  --data '
{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "public/get_instrument",
  "params": {
    "instrument_name": "BTC-13JAN23-16000-P"
  }
}
'

200

{
  "jsonrpc": "2.0",
  "id": 2,
  "result": {
    "tick_size": 0.0005,
    "tick_size_steps": [
      {
        "above_price": 120,
        "tick_size": 0.001
      },
      {
        "above_price": 200,
        "tick_size": 0.003
      }
    ],
    "taker_commission": 0.0003,
    "strike": 16000,
    "settlement_period": "week",
    "settlement_currency": "BTC",
    "quote_currency": "BTC",
    "price_index": "btc_usd",
    "option_type": "put",
    "min_trade_amount": 0.1,
    "maker_commission": 0.0003,
    "kind": "option",
    "is_active": true,
    "instrument_name": "BTC-13JAN23-16000-P",
    "instrument_id": 144613,
    "expiration_timestamp": 1673596800000,
    "creation_timestamp": 1671696002000,
    "counter_currency": "USD",
    "contract_size": 1,
    "block_trade_tick_size": 0.0001,
    "block_trade_min_trade_amount": 25,
    "block_trade_commission": 0.00015,
    "base_currency": "BTC",
    "state": "open"
  }
}

Query Parameters

instrument_name · string · required

Instrument name Unique instrument identifier

Example:

"BTC-PERPETUAL"

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 · enum<string> · required

The underlying currency being traded.

Available options: BTC, ETH

result. quote_currency · enum<string> · required

The currency in which the instrument prices are quoted.

Available options: USD

result. min_trade_amount · number · required

Minimum amount for trading. For perpetual and inverse futures the amount is in USD units. For options and linear futures it is the underlying base currency coin.

Example:

0.1

result. instrument_name · string · required

Unique instrument identifier

Example:

"BTC-PERPETUAL"

result. is_active · boolean · required

Indicates if the instrument can currently be traded.

result. settlement_period · enum<string> · required

Optional (not added for spot). The settlement period.

Available options: month, week, perpetual

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).

result. contract_size · integer · required

Contract size for instrument.

Example:

1

result. price_index · string · required

Name of price index that is used for this instrument

Example:

"btc_usdc"

result. settlement_currency · enum<string>

Optional (not added for spot). Settlement currency for the instrument.

Available options: BTC, ETH

result. counter_currency · enum<string>

Counter currency for the instrument.

Available options: USD, USDC

result. instrument_id · integer

Instrument ID

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

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. block_trade_commission · number

Block Trade commission for instrument.

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 instrument (only for futures).

Example:

100

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

id · integer

The id that was sent in the request