Instrument

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://api-evangelist.github.io/deribit/json-schema/instrument.json",
  "title": "Instrument",
  "properties": {
    "kind": {
      "$ref": "#/components/schemas/kind"
    },
    "settlement_currency": {
      "type": "string",
      "enum": [
        "BTC",
        "ETH"
      ],
      "description": "Optional (not added for spot). Settlement currency for the instrument."
    },
    "counter_currency": {
      "type": "string",
      "enum": [
        "USD",
        "USDC"
      ],
      "description": "Counter currency for the instrument."
    },
    "base_currency": {
      "type": "string",
      "enum": [
        "BTC",
        "ETH"
      ],
      "description": "The underlying currency being traded."
    },
    "quote_currency": {
      "type": "string",
      "enum": [
        "USD"
      ],
      "description": "The currency in which the instrument prices are quoted."
    },
    "min_trade_amount": {
      "type": "number",
      "example": 0.1,
      "description": "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."
    },
    "instrument_name": {
      "$ref": "#/components/schemas/instrument_name"
    },
    "instrument_id": {
      "$ref": "#/components/schemas/instrument_id"
    },
    "is_active": {
      "type": "boolean",
      "description": "Indicates if the instrument can currently be traded."
    },
    "settlement_period": {
      "type": "string",
      "enum": [
        "month",
        "week",
        "perpetual"
      ],
      "description": "Optional (not added for spot). The settlement period."
    },
    "creation_timestamp": {
      "type": "integer",
      "example": 1536569522277,
      "description": "The time when the instrument was first created (milliseconds since the UNIX epoch)."
    },
    "tick_size": {
      "type": "number",
      "example": 0.0001,
      "description": "Specifies minimal price change and, as follows, the number of decimal places for instrument prices."
    },
    "tick_size_steps": {
      "$ref": "#/components/schemas/tick_size_step"
    },
    "expiration_timestamp": {
      "type": "integer",
      "description": "The time when the instrument will expire (milliseconds since the UNIX epoch)."
    },
    "strike": {
      "type": "number",
      "description": "The strike value (only for options)."
    },
    "option_type": {
      "type": "string",
      "enum": [
        "call",
        "put"
      ],
      "description": "The option type (only for options)."
    },
    "future_type": {
      "type": "string",
      "enum": [
        "linear",
        "reversed"
      ],
      "description": "Future type (only for futures)(field is deprecated and will be removed in the future, `instrument_type` should be used instead)."
    },
    "instrument_type": {
      "type": "string",
      "description": "Type of the instrument. `linear` or `reversed`"
    },
    "contract_size": {
      "type": "integer",
      "example": 1,
      "description": "Contract size for instrument."
    },
    "maker_commission": {
      "type": "number",
      "example": 0.0001,
      "description": "Maker commission for instrument."
    },
    "taker_commission": {
      "type": "number",
      "example": 0.0005,
      "description": "Taker commission for instrument."
    },
    "max_liquidation_commission": {
      "type": "number",
      "example": 0.001,
      "description": "Maximal liquidation trade commission for instrument (only for futures)."
    },
    "block_trade_commission": {
      "type": "number",
      "example": 0.0005,
      "description": "Block Trade commission for instrument."
    },
    "block_trade_tick_size": {
      "type": "number",
      "example": 0.01,
      "description": "Specifies minimal price change for block trading."
    },
    "block_trade_min_trade_amount": {
      "type": "number",
      "example": 25,
      "description": "Minimum amount for block trading."
    },
    "max_leverage": {
      "type": "integer",
      "example": 100,
      "description": "Maximal leverage for instrument (only for futures)."
    },
    "price_index": {
      "$ref": "#/components/schemas/price_index"
    },
    "state": {
      "$ref": "#/components/schemas/book_state"
    }
  },
  "required": [
    "kind",
    "base_currency",
    "quote_currency",
    "min_trade_amount",
    "instrument_name",
    "is_active",
    "settlement_period",
    "creation_timestamp",
    "tick_size",
    "expiration_timestamp",
    "contract_size",
    "price_index"
  ],
  "type": "object"
}