{
  "path": "/futures/{settle}/contracts/{contract}",
  "operation_id": "getFuturesContract",
  "auth_required": false,
  "parameters": [
    {
      "name": "settle",
      "in": "path",
      "description": "Perpetual futures settlement currency",
      "required": true,
      "schema": {
        "type": "string",
        "enum": [
          "btc",
          "usdt",
          "usd1"
        ]
      },
      "example": "usdt"
    },
    {
      "name": "contract",
      "in": "path",
      "description": "Futures contract",
      "required": true,
      "schema": {
        "type": "string"
      },
      "example": "BTC_USDT"
    }
  ],
  "response_fields": {
    "200": {
      "description": "Contract information",
      "fields": [
        {
          "path": "$",
          "type": "object",
          "description": "Futures contract details",
          "constraints": ""
        },
        {
          "path": "$.name",
          "type": "string",
          "description": "Futures contract",
          "constraints": ""
        },
        {
          "path": "$.type",
          "type": "string",
          "description": "Contract type: inverse - inverse contract, direct - direct contract",
          "constraints": "枚举：inverse / direct"
        },
        {
          "path": "$.quanto_multiplier",
          "type": "string",
          "description": "The contract multiplier indicates how many units of the underlying asset the face value of one contract represents.",
          "constraints": ""
        },
        {
          "path": "$.leverage_min",
          "type": "string",
          "description": "Minimum leverage",
          "constraints": ""
        },
        {
          "path": "$.leverage_max",
          "type": "string",
          "description": "Maximum leverage",
          "constraints": ""
        },
        {
          "path": "$.maintenance_rate",
          "type": "string",
          "description": "The maintenance margin rate of the first tier of risk limit sheet",
          "constraints": ""
        },
        {
          "path": "$.mark_type",
          "type": "string",
          "description": "Deprecated",
          "constraints": "枚举：internal / index"
        },
        {
          "path": "$.mark_price",
          "type": "string",
          "description": "Current mark price",
          "constraints": ""
        },
        {
          "path": "$.index_price",
          "type": "string",
          "description": "Current index price",
          "constraints": ""
        },
        {
          "path": "$.last_price",
          "type": "string",
          "description": "Last trading price",
          "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": "$.funding_rate",
          "type": "string",
          "description": "Current funding rate",
          "constraints": ""
        },
        {
          "path": "$.funding_interval",
          "type": "integer",
          "description": "Funding application interval, unit in seconds",
          "constraints": ""
        },
        {
          "path": "$.funding_next_apply",
          "type": "number",
          "description": "Next funding time",
          "constraints": "格式：\"double\""
        },
        {
          "path": "$.risk_limit_base",
          "type": "string",
          "description": "Base risk limit (deprecated)",
          "constraints": ""
        },
        {
          "path": "$.interest_rate",
          "type": "string",
          "description": "Interest rate parameter used in funding rate and premium-related calculations for perpetual contracts. Returned as a string decimal ratio (e.g. `0.0003`), same convention as `funding_rate` (ratio, not percent).",
          "constraints": ""
        },
        {
          "path": "$.risk_limit_step",
          "type": "string",
          "description": "Risk limit adjustment step (deprecated)",
          "constraints": ""
        },
        {
          "path": "$.risk_limit_max",
          "type": "string",
          "description": "Maximum risk limit allowed by the contract (deprecated). It is recommended to use /futures/{settle}/risk_limit_tiers to query risk limits",
          "constraints": ""
        },
        {
          "path": "$.order_size_min",
          "type": "string",
          "description": "Minimum order quantity",
          "constraints": ""
        },
        {
          "path": "$.enable_decimal",
          "type": "boolean",
          "description": "Whether decimal string type is supported for contract lot size. When this field is set to `true`, it indicates that the contract supports decimal lot sizes (i.e., the `size` field can use a decimal string type); when set to `false`, it indicates that the contract does not support decimal lot sizes (i.e., the `size` field can only use an integer type).",
          "constraints": ""
        },
        {
          "path": "$.order_size_max",
          "type": "string",
          "description": "Maximum order quantity",
          "constraints": ""
        },
        {
          "path": "$.order_price_deviate",
          "type": "string",
          "description": "Maximum allowed deviation between order price and current mark price. The order price `order_price` must satisfy the following condition:\n\n    abs(order_price - mark_price) <= mark_price * order_price_deviate",
          "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": "Current trade ID",
          "constraints": "格式：\"int64\""
        },
        {
          "path": "$.trade_size",
          "type": "string",
          "description": "Historical cumulative trading volume",
          "constraints": ""
        },
        {
          "path": "$.position_size",
          "type": "string",
          "description": "Current total long position size",
          "constraints": ""
        },
        {
          "path": "$.config_change_time",
          "type": "number",
          "description": "Last configuration update time",
          "constraints": "格式：\"double\""
        },
        {
          "path": "$.in_delisting",
          "type": "boolean",
          "description": "`in_delisting=true` and position_size>0 indicates the contract is in delisting transition period\n`in_delisting=true` and position_size=0 indicates the contract is delisted",
          "constraints": ""
        },
        {
          "path": "$.orders_limit",
          "type": "integer",
          "description": "Maximum number of pending orders",
          "constraints": ""
        },
        {
          "path": "$.enable_bonus",
          "type": "boolean",
          "description": "Whether bonus is enabled",
          "constraints": ""
        },
        {
          "path": "$.enable_credit",
          "type": "boolean",
          "description": "Whether portfolio margin account is enabled",
          "constraints": ""
        },
        {
          "path": "$.create_time",
          "type": "number",
          "description": "Created time of the contract",
          "constraints": "格式：\"double\""
        },
        {
          "path": "$.funding_cap_ratio",
          "type": "string",
          "description": "Deprecated",
          "constraints": ""
        },
        {
          "path": "$.status",
          "type": "string",
          "description": "Contract status types include: prelaunch (pre-launch), trading (active), delisting (delisting), delisted (delisted), circuit_breaker (circuit breaker)",
          "constraints": ""
        },
        {
          "path": "$.launch_time",
          "type": "integer",
          "description": "Contract expiry timestamp",
          "constraints": "格式：\"int64\""
        },
        {
          "path": "$.delisting_time",
          "type": "integer",
          "description": "Timestamp when contract enters reduce-only state",
          "constraints": "格式：\"int64\""
        },
        {
          "path": "$.delisted_time",
          "type": "integer",
          "description": "Contract delisting time",
          "constraints": "格式：\"int64\""
        },
        {
          "path": "$.market_order_slip_ratio",
          "type": "string",
          "description": "The maximum slippage allowed for market orders, with the slippage rate calculated based on the latest market price",
          "constraints": ""
        },
        {
          "path": "$.market_order_size_max",
          "type": "string",
          "description": "The maximum number of contracts supported for market orders, with a default value of 0. When the default value is used, the maximum number of contracts is limited by the `order_size_max` field",
          "constraints": ""
        },
        {
          "path": "$.funding_rate_limit",
          "type": "string",
          "description": "Upper and lower limits of funding rate",
          "constraints": ""
        },
        {
          "path": "$.contract_type",
          "type": "string",
          "description": "Contract classification type, e.g. stocks, metals, indices, forex, commodities, etc.",
          "constraints": ""
        },
        {
          "path": "$.funding_impact_value",
          "type": "string",
          "description": "Funding rate depth impact value",
          "constraints": ""
        },
        {
          "path": "$.enable_circuit_breaker",
          "type": "boolean",
          "description": "Whether the newly launched contract activates mark price circuit breaker (If the platform intends to activate this mechanism for a newly launched contract market to prevent significant price fluctuations and excessive liquidations after launch, an advance announcement will be made).",
          "constraints": ""
        }
      ]
    }
  },
  "source_version": "v4.106.132",
  "source_url": "https://github.com/gate/gateapi-python/blob/cd2cac4d339ec0734480787d23c020f467fd7b80/openapi.yaml",
  "local_tool_limits": [
    "仅检查必填、枚举和简单数值范围",
    "复杂类型序列化、条件必填、时间窗口等以官方规则为准",
    "不会发起 API 请求"
  ]
}