接口文档研读 · 永续合约

独立教程与工具 · 非 Gate 官方网站

API REFERENCE / 永续合约

Gate 永续行情摘要与资金费率字段:参数、响应与查询工具

读取永续合约行情摘要,在同一响应中区分最新价、标记价、指数价和资金费率字段。

文档标注免认证 GET固定规格 v4.106.132资料核对:2026-09-10
GET /futures/{settle}/tickers

这条查询解决什么问题

二十四小时成交量存在多种币种单位,预估资金费率也应与已记录或实际结算的费率分开解释。

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

查看官方英文说明

Get all futures trading statistics

此操作没有额外说明。

请求参数逐项核对

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

参数与位置类型与范围官方字段说明
settlepath · 必填string枚举:btc / usdt / usd1
Perpetual futures settlement currency
contractquery · 可选string
Futures contract, return related data only if specified

在本页组装查询 URL

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

path · string枚举:btc / usdt / usd1
query · string
尚未生成 URL。

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

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

响应字段怎样阅读

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

HTTP 200 · Query successful

字段路径数据类型字段说明
$array<object>
未提供字段注释
$[]object
未提供字段注释
$[].contractstring
Futures contract
$[].laststring
Last trading price
$[].change_percentagestring
Price change percentage. Negative values indicate price decrease, e.g. -7.45
$[].total_sizestring
Contract total size
$[].low_24hstring
24-hour lowest price
$[].high_24hstring
24-hour highest price
$[].volume_24hstring
24-hour trading volume
$[].volume_24h_btcstring
24-hour trading volume in BTC (deprecated, use `volume_24h_base`, `volume_24h_quote`, `volume_24h_settle` instead)
$[].volume_24h_usdstring
24-hour trading volume in USD (deprecated, use `volume_24h_base`, `volume_24h_quote`, `volume_24h_settle` instead)
$[].volume_24h_basestring
24-hour trading volume in base currency
$[].volume_24h_quotestring
24-hour trading volume in quote currency
$[].volume_24h_settlestring
24-hour trading volume in settle currency
$[].mark_pricestring
Recent mark price
$[].funding_ratestring
Funding rate
$[].funding_rate_indicativestring
Indicative Funding rate in next period. (deprecated. use `funding_rate`)
$[].index_pricestring
Index price
$[].quanto_base_ratestring
Deprecated
$[].lowest_askstring
Recent lowest ask
$[].lowest_sizestring
The latest seller's lowest price order quantity
$[].highest_bidstring
Recent highest bid
$[].highest_sizestring
The latest buyer's highest price order volume
$[].change_utc0string
Percentage change at utc0. Negative values indicate a drop, e.g., -7.45%
$[].change_utc8string
Percentage change at utc8. Negative values indicate a drop, e.g., -7.45%
$[].change_pricestring
24h change amount. Negative values indicate a drop, e.g., -7.45
$[].change_utc0_pricestring
Change amount at utc0. Negative values indicate a drop, e.g., -7.45
$[].change_utc8_pricestring
Change amount at utc8. Negative values indicate a drop, e.g., -7.45

来源、版本与使用说明

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

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

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