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。
尚未生成 URL。
不会向 Gate 或本站发送表单内容。
工具检查必填、枚举与简单数值范围,不代替服务端校验。复合参数、时间窗口、条件必填等请对照上方原文。
响应字段怎样阅读
以下展示的是规格中的类型定义,不是现场 API 响应,也不是行情样本。嵌套结构展开至三层;数组的 [] 表示其中一个元素。
HTTP 200 · Query successful
| 字段路径 | 数据类型 | 字段说明 |
|---|---|---|
$ | array<object> | 未提供字段注释 |
$[] | object | 未提供字段注释 |
$[].contract | string | Futures contract |
$[].last | string | Last trading price |
$[].change_percentage | string | Price change percentage. Negative values indicate price decrease, e.g. -7.45 |
$[].total_size | string | Contract total size |
$[].low_24h | string | 24-hour lowest price |
$[].high_24h | string | 24-hour highest price |
$[].volume_24h | string | 24-hour trading volume |
$[].volume_24h_btc | string | 24-hour trading volume in BTC (deprecated, use `volume_24h_base`, `volume_24h_quote`, `volume_24h_settle` instead) |
$[].volume_24h_usd | string | 24-hour trading volume in USD (deprecated, use `volume_24h_base`, `volume_24h_quote`, `volume_24h_settle` instead) |
$[].volume_24h_base | string | 24-hour trading volume in base currency |
$[].volume_24h_quote | string | 24-hour trading volume in quote currency |
$[].volume_24h_settle | string | 24-hour trading volume in settle currency |
$[].mark_price | string | Recent mark price |
$[].funding_rate | string | Funding rate |
$[].funding_rate_indicative | string | Indicative Funding rate in next period. (deprecated. use `funding_rate`) |
$[].index_price | string | Index price |
$[].quanto_base_rate | string | Deprecated |
$[].lowest_ask | string | Recent lowest ask |
$[].lowest_size | string | The latest seller's lowest price order quantity |
$[].highest_bid | string | Recent highest bid |
$[].highest_size | string | The latest buyer's highest price order volume |
$[].change_utc0 | string | Percentage change at utc0. Negative values indicate a drop, e.g., -7.45% |
$[].change_utc8 | string | Percentage change at utc8. Negative values indicate a drop, e.g., -7.45% |
$[].change_price | string | 24h change amount. Negative values indicate a drop, e.g., -7.45 |
$[].change_utc0_price | string | Change amount at utc0. Negative values indicate a drop, e.g., -7.45 |
$[].change_utc8_price | string | 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 组装器由本站整理。访问日志用于站点运维;页面没有第三方统计脚本,表单参数仅在当前页面内存中处理。