Gate TradFi K线的周期与数量上限：参数、响应与查询工具
按 TradFi 品种、周期和起止时间查询K线，读取 o、c、h、l、t 构成的价格记录。
GET /tradfi/symbols/{symbol}/klines这条查询解决什么问题
请求 begin_time、end_time 及K线 t 使用秒级时间，外层响应 timestamp 为毫秒，且 limit 不得超过五百。
这是公开数据的读取接口说明。行情、合约与市场状态会变化，字段定义与返回数据应分开核对。
查看官方英文说明
Query trading symbol klines
此操作没有额外说明。
请求参数逐项核对
字段名和数据类型保留官方拼写。必填标记来自规格；描述中的条件约束还需要一起检查。
| 参数与位置 | 类型与范围 | 官方字段说明 |
|---|---|---|
symbolpath · 必填 | string | Trading symbol code |
kline_typequery · 必填 | string枚举：1m / 15m / 1h / 4h / 1d / 7d / 30d | Kline type (time period) |
begin_timequery · 可选 | integer格式："int64" | Start time (Unix timestamp in seconds) |
end_timequery · 可选 | integer格式："int64" | End time (Unix timestamp in seconds) |
limitquery · 可选 | integer最小：1；最大：500 | Kline limit (max 500, error if exceeded) |
在本页组装查询 URL
填写参数后生成一个 GET 地址，只在浏览器本地处理。留空的可选项不会发送。请勿填写密码、API Key 或 Secret。
尚未生成 URL。
不会向 Gate 或本站发送表单内容。
工具检查必填、枚举与简单数值范围，不代替服务端校验。复合参数、时间窗口、条件必填等请对照上方原文。
响应字段怎样阅读
以下展示的是规格中的类型定义，不是现场 API 响应，也不是行情样本。嵌套结构展开至三层；数组的 [] 表示其中一个元素。
HTTP 200 · Request success
| 字段路径 | 数据类型 | 字段说明 |
|---|---|---|
$ | object | 未提供字段注释 |
$.timestamp | integer格式："int64" | Server timestamp (milliseconds) |
$.data | object | Response data |
$.data.list | array<object> | Kline data list |
$.data.list[] | object | Single kline data |
HTTP 400 · Request failed
| 字段路径 | 数据类型 | 字段说明 |
|---|---|---|
$ | object | 未提供字段注释 |
$.label | string | Business status code, non-empty indicates request exception, please refer to TradFi error enumeration in documentation |
$.message | string | Return message, returned when request error occurs |
$.timestamp | integer格式："int64" | Server timestamp (milliseconds) |
单条 K 线字段补充
上方响应表保留三层摘要。以下按固定 v4.106.132 原规格中的 Klines 定义，补齐 $.data.list[] 内部的五个字段。这是原规格补充，不是现场返回或行情样本。
| 完整 JSON 路径 | 类型与格式 | 中文含义与原文 |
|---|---|---|
$.data.list[].o | string | 开盘价Open price |
$.data.list[].c | string | 收盘价Close price |
$.data.list[].h | string | 最高价High price |
$.data.list[].l | string | 最低价Low price |
$.data.list[].t | integer格式：int64 | 时间戳（Unix 秒）Timestamp (Unix seconds) |
o、c、h、l 在规格中均为字符串；$.data.list[].t 为 int64 整数，单位是 Unix 秒。外层 $.timestamp 是服务器时间戳，单位为毫秒。请求参数 begin_time、end_time 也使用 Unix 秒，读取时应区分各字段的单位。
来源、版本与使用说明
本站独立整理 Gate 技术资料，不代表 Gate，不提供账户、交易、充值或软件下载服务。
参数和字段改编自 Gate 官方 SDK 的 Apache 2.0 开放规格，固定版本为 v4.106.132。核对时官网文档已为 v4.106.136，后续变更须以官网为准；本页并未声称对该接口做过在线实测。
中文用途解释、字段阅读界面和本地 URL 组装器由本站整理。访问日志用于站点运维；页面没有第三方统计脚本，表单参数仅在当前页面内存中处理。