Market Data
Public

Changed on

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), underlying type, and other instrument parameters.

Looks up by instrument_name, including combo IDs and expired or archivized instruments that public/get_instruments no longer lists. Unknown names fail with instrument not found. For live combo legs and combo-book state, use public/get_combo_details / public/get_combos instead of this method.

is_active is true while the order book is visible (open, settlement, locked, or halted). It is not the same as tradable: only state open accepts new orders. After delivery the book becomes delivered (is_active false) and is later archivized.

Spot instruments omit settlement_currency and settlement_period. Spot routed to Coinbase Exchange also omit block-trade fields and include is_cbe_routed / is_csr (present only when true). Futures include max_leverage and max_non_default_leverage. Some USDC spot pairs that support margin loans also include max_leverage. Perpetuals still have expiration_timestamp.

📖 Related Article: Spot Trading: Deribit and Coinbase-Routed Instruments

Try in API console

get/public/get_instrument

Request

  • Base URL
    https://test.deribit.com/api/v2
  • URL
    https://test.deribit.com/api/v2/public/get_instrument
  • Auth
    none declared

Query parameters

instrument_namestring required

Unique instrument identifier

Example:BTC-PERPETUAL

Instrument name

Response

Success response

jsonrpc'2.0' required

The JSON-RPC version (2.0)

idinteger

The id that was sent in the request

Example response

{
  "result": {
    "min_trade_amount": 0.1,
    "instrument_name": "BTC-PERPETUAL",
    "creation_timestamp": 1536569522277,
    "tick_size": 0.0001,
    "contract_size": 1,
    "lot_size": 1,
    "maker_commission": 0.0001,
    "taker_commission": 0.0005,
    "max_liquidation_commission": 0.001,
    "block_trade_commission": 0.0005,
    "block_trade_tick_size": 0.01,
    "block_trade_min_trade_amount": 25,
    "max_leverage": 100,
    "price_index": "btc_usdc",
    "base_currency_uuid": "5b71fc48-3dd3-540c-809b-f8c94d0e68b5",
    "quote_currency_uuid": "2b92315d-eab7-5bef-84fa-089a131333f5",
    "index_id": 1000004,
    "product_group": "BTC"
  }
}

Changes

  • 78543b1b2259Revision changes
    • breaking

      the response property / became optional for the status

    • warning

      added the new RWA enum value to the / response property for the response status

    • warning

      added the new day enum value to the / response property for the response status

    • warning

      added the new hour enum value to the / response property for the response status

    • warning

      added the new minute enum value to the / response property for the response status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      removed the BTC enum value from the / response property for the response status

    • info

      removed the BTC enum value from the / response property for the response status

    • info

      removed the ETH enum value from the / response property for the response status

    • info

      removed the ETH enum value from the / response property for the response status

    • info

      removed the USD enum value from the / response property for the response status

    • info

      removed the USD enum value from the / response property for the response status

    • info

      removed the USDC enum value from the / response property for the response status

  • 86c5239e3b19Revision changes
    • warning

      removed the optional property / from the response with the status