{
  "path": "/options/contracts",
  "operation_id": "listOptionsContracts",
  "auth_required": false,
  "parameters": [
    {
      "name": "underlying",
      "in": "query",
      "required": true,
      "description": "Underlying (Obtained by listing underlying endpoint)",
      "schema": {
        "type": "string"
      },
      "example": "BTC_USDT"
    },
    {
      "name": "expiration",
      "in": "query",
      "required": false,
      "description": "Unix timestamp of expiration date",
      "schema": {
        "type": "integer",
        "format": "int64"
      },
      "example": 1636588800
    }
  ],
  "response_fields": {
    "200": {
      "description": "List retrieved successfully",
      "fields": [
        {
          "path": "$",
          "type": "array<object>",
          "description": "",
          "constraints": ""
        },
        {
          "path": "$[]",
          "type": "object",
          "description": "Options contract details",
          "constraints": ""
        },
        {
          "path": "$[].name",
          "type": "string",
          "description": "Options contract name",
          "constraints": ""
        },
        {
          "path": "$[].tag",
          "type": "string",
          "description": "Expiry periods include day, week, and month.",
          "constraints": ""
        },
        {
          "path": "$[].create_time",
          "type": "number",
          "description": "Created time",
          "constraints": "格式：\"double\""
        },
        {
          "path": "$[].expiration_time",
          "type": "number",
          "description": "Expiration time",
          "constraints": "格式：\"double\""
        },
        {
          "path": "$[].is_call",
          "type": "boolean",
          "description": "`true` means call options, `false` means put options",
          "constraints": ""
        },
        {
          "path": "$[].multiplier",
          "type": "string",
          "description": "The option contract multiplier indicates how many units of the underlying asset the face value of one contract represents.",
          "constraints": ""
        },
        {
          "path": "$[].underlying",
          "type": "string",
          "description": "Underlying",
          "constraints": ""
        },
        {
          "path": "$[].underlying_price",
          "type": "string",
          "description": "The forward futures price corresponding to the delivery date",
          "constraints": ""
        },
        {
          "path": "$[].last_price",
          "type": "string",
          "description": "Last trading price",
          "constraints": ""
        },
        {
          "path": "$[].mark_price",
          "type": "string",
          "description": "Current mark price (quote currency)",
          "constraints": ""
        },
        {
          "path": "$[].index_price",
          "type": "string",
          "description": "Current index price (quote currency)",
          "constraints": ""
        },
        {
          "path": "$[].maker_fee_rate",
          "type": "string",
          "description": "Maker fee rate, negative values indicate rebates",
          "constraints": ""
        },
        {
          "path": "$[].taker_fee_rate",
          "type": "string",
          "description": "Taker fee rate",
          "constraints": ""
        },
        {
          "path": "$[].order_price_round",
          "type": "string",
          "description": "Minimum order price increment",
          "constraints": ""
        },
        {
          "path": "$[].mark_price_round",
          "type": "string",
          "description": "Minimum mark price increment",
          "constraints": ""
        },
        {
          "path": "$[].order_size_min",
          "type": "integer",
          "description": "Minimum order quantity",
          "constraints": "格式：\"int64\""
        },
        {
          "path": "$[].order_size_max",
          "type": "integer",
          "description": "Maximum order quantity",
          "constraints": "格式：\"int64\""
        },
        {
          "path": "$[].order_price_deviate",
          "type": "string",
          "description": "Deprecated",
          "constraints": ""
        },
        {
          "path": "$[].ref_discount_rate",
          "type": "string",
          "description": "Trading fee discount for referred users",
          "constraints": ""
        },
        {
          "path": "$[].ref_rebate_rate",
          "type": "string",
          "description": "Commission rate for referrers",
          "constraints": ""
        },
        {
          "path": "$[].orderbook_id",
          "type": "integer",
          "description": "Orderbook update ID",
          "constraints": "格式：\"int64\""
        },
        {
          "path": "$[].trade_id",
          "type": "integer",
          "description": "Deprecated",
          "constraints": "格式：\"int64\""
        },
        {
          "path": "$[].trade_size",
          "type": "integer",
          "description": "Historical cumulative trading volume",
          "constraints": "格式：\"int64\""
        },
        {
          "path": "$[].position_size",
          "type": "integer",
          "description": "Current total long position size",
          "constraints": "格式：\"int64\""
        },
        {
          "path": "$[].orders_limit",
          "type": "integer",
          "description": "The maximum number of open orders each user can place in this order book.",
          "constraints": ""
        }
      ]
    }
  },
  "source_version": "v4.106.132",
  "source_url": "https://github.com/gate/gateapi-python/blob/cd2cac4d339ec0734480787d23c020f467fd7b80/openapi.yaml",
  "local_tool_limits": [
    "仅检查必填、枚举和简单数值范围",
    "复杂类型序列化、条件必填、时间窗口等以官方规则为准",
    "不会发起 API 请求"
  ]
}