API REFERENCE / 永续合约

Gate 单个永续合约的规格与价格：参数、响应与查询工具

根据结算币和合约名称读取永续合约规格，核对合约乘数、价格步长和资金费率时间字段。

文档标注免认证 GET固定规格 v4.106.132资料核对：2026-09-10

GET /futures/{settle}/contracts/{contract}

这条查询解决什么问题

标记价、指数价与最新成交价各有用途，历史风险限额字段中的废弃标记也应与现行限额表区分。

这是公开数据的读取接口说明。行情、合约与市场状态会变化，字段定义与返回数据应分开核对。

查看官方英文说明

Query single contract information

此操作没有额外说明。

请求参数逐项核对

字段名和数据类型保留官方拼写。必填标记来自规格；描述中的条件约束还需要一起检查。

参数与位置	类型与范围	官方字段说明
`settle`path · 必填	`string`枚举：btc / usdt / usd1	Perpetual futures settlement currency
`contract`path · 必填	`string`	Futures contract

在本页组装查询 URL

填写参数后生成一个 GET 地址，只在浏览器本地处理。留空的可选项不会发送。请勿填写密码、API Key 或 Secret。

尚未生成 URL。

不会向 Gate 或本站发送表单内容。

工具检查必填、枚举与简单数值范围，不代替服务端校验。复合参数、时间窗口、条件必填等请对照上方原文。

响应字段怎样阅读

以下展示的是规格中的类型定义，不是现场 API 响应，也不是行情样本。嵌套结构展开至三层；数组的 [] 表示其中一个元素。

HTTP 200 · Contract information

字段路径	数据类型	字段说明
`$`	`object`	Futures contract details
`$.name`	`string`	Futures contract
`$.type`	`string`枚举：inverse / direct	Contract type: inverse - inverse contract, direct - direct contract
`$.quanto_multiplier`	`string`	The contract multiplier indicates how many units of the underlying asset the face value of one contract represents.
`$.leverage_min`	`string`	Minimum leverage
`$.leverage_max`	`string`	Maximum leverage
`$.maintenance_rate`	`string`	The maintenance margin rate of the first tier of risk limit sheet
`$.mark_type`	`string`枚举：internal / index	Deprecated
`$.mark_price`	`string`	Current mark price
`$.index_price`	`string`	Current index price
`$.last_price`	`string`	Last trading price
`$.maker_fee_rate`	`string`	Maker fee rate, negative values indicate rebates
`$.taker_fee_rate`	`string`	Taker fee rate
`$.order_price_round`	`string`	Minimum order price increment
`$.mark_price_round`	`string`	Minimum mark price increment
`$.funding_rate`	`string`	Current funding rate
`$.funding_interval`	`integer`	Funding application interval, unit in seconds
`$.funding_next_apply`	`number`格式："double"	Next funding time
`$.risk_limit_base`	`string`	Base risk limit (deprecated)
`$.interest_rate`	`string`	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).
`$.risk_limit_step`	`string`	Risk limit adjustment step (deprecated)
`$.risk_limit_max`	`string`	Maximum risk limit allowed by the contract (deprecated). It is recommended to use /futures/{settle}/risk_limit_tiers to query risk limits
`$.order_size_min`	`string`	Minimum order quantity
`$.enable_decimal`	`boolean`	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).
`$.order_size_max`	`string`	Maximum order quantity
`$.order_price_deviate`	`string`	Maximum allowed deviation between order price and current mark price. The order price `order_price` must satisfy the following condition: abs(order_price - mark_price) <= mark_price * order_price_deviate
`$.ref_discount_rate`	`string`	Trading fee discount for referred users
`$.ref_rebate_rate`	`string`	Commission rate for referrers
`$.orderbook_id`	`integer`格式："int64"	Orderbook update ID
`$.trade_id`	`integer`格式："int64"	Current trade ID
`$.trade_size`	`string`	Historical cumulative trading volume
`$.position_size`	`string`	Current total long position size
`$.config_change_time`	`number`格式："double"	Last configuration update time
`$.in_delisting`	`boolean`	`in_delisting=true` and position_size>0 indicates the contract is in delisting transition period `in_delisting=true` and position_size=0 indicates the contract is delisted
`$.orders_limit`	`integer`	Maximum number of pending orders
`$.enable_bonus`	`boolean`	Whether bonus is enabled
`$.enable_credit`	`boolean`	Whether portfolio margin account is enabled
`$.create_time`	`number`格式："double"	Created time of the contract
`$.funding_cap_ratio`	`string`	Deprecated
`$.status`	`string`	Contract status types include: prelaunch (pre-launch), trading (active), delisting (delisting), delisted (delisted), circuit_breaker (circuit breaker)
`$.launch_time`	`integer`格式："int64"	Contract expiry timestamp
`$.delisting_time`	`integer`格式："int64"	Timestamp when contract enters reduce-only state
`$.delisted_time`	`integer`格式："int64"	Contract delisting time
`$.market_order_slip_ratio`	`string`	The maximum slippage allowed for market orders, with the slippage rate calculated based on the latest market price
`$.market_order_size_max`	`string`	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
`$.funding_rate_limit`	`string`	Upper and lower limits of funding rate
`$.contract_type`	`string`	Contract classification type, e.g. stocks, metals, indices, forex, commodities, etc.
`$.funding_impact_value`	`string`	Funding rate depth impact value
`$.enable_circuit_breaker`	`boolean`	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).

来源、版本与使用说明

本站独立整理 Gate 技术资料，不代表 Gate，不提供账户、交易、充值或软件下载服务。

参数和字段改编自 Gate 官方 SDK 的 Apache 2.0 开放规格，固定版本为 v4.106.132。核对时官网文档已为 v4.106.136，后续变更须以官网为准；本页并未声称对该接口做过在线实测。

中文用途解释、字段阅读界面和本地 URL 组装器由本站整理。访问日志用于站点运维；页面没有第三方统计脚本，表单参数仅在当前页面内存中处理。