GateData.AI

K 线 (OHLCV)

查询指定交易对象在所选周期和时间范围内的 OHLCV K 线序列。

GET/api/v1/markets/kline
数据域
行情与流动性
解析层级
挂牌
MCP 工具
market_data_query (task=kline)

可查询数据

返回数据
指定交易对象在所选周期和时间范围内的 OHLCV K 线序列
市场覆盖
Crypto、美股、港股
查询粒度
每次查询一个挂牌和一个周期，不合并不同挂牌的数据

认证

所有请求需携带 Authorization: Bearer YOUR_API_KEY 或 X-API-KEY。

请求参数

周期设置

必填。

timeframeTimeframequery示例1h必填

单条数据的聚合周期

intervalTimeframequery示例1h可选

timeframe 的兼容别名。

对象定位

listing_id / asset_id / query 至少填写一项（也可用 ticker / symbol / base 等别名）。

listing_idstringquery示例listing_gate_BTC_USDT_spot可选

交易场所挂牌标识，标识某个交易品种在特定交易场所的挂牌记录

asset_idstringquery示例asset_btc可选

资产标识，标识股票、加密资产等资产对象

querystringquery示例BTC可选

用于解析查询对象的检索词

tickerstringquery示例BTC可选

query 的 ticker 别名。

symbolstringquery示例BTC可选

query 的 symbol 别名。

basestringquery示例BTC可选

交易对基础资产代码

市场路由

股票必填 market；venue / market_type 主要用于 Crypto（裸 Crypto 可默认 Gate 现货）。

marketMarketquery示例crypto条件必须

查询对象所属市场

venuestringquery示例gate可选

查询指定的交易场所代码

market_typeMarketTypequery示例spot可选

交易产品类型

quotestringquery示例USDT可选

交易对计价资产代码

时间范围

建议与股票场景一起使用；支持 start_time / end_time（别名 from / to）。

start_timedatetimequery示例2026-07-01T00:00:00Z可选

查询时间范围起点

end_timedatetimequery示例2026-07-31T23:59:59Z可选

查询时间范围终点

fromdatetimequery示例2026-07-01T00:00:00Z可选

自定义查询起始日期

todatetimequery示例2026-07-31T23:59:59Z可选

自定义查询结束日期

返回控制

均为可选。

limitintegerquery示例100可选

单次最多返回的记录数

股票高级参数

include_indicators=true 时在可用时附加指标列。

adjustmentenumquery示例raw可选

股票复权方式。

include_indicatorsbooleanquery示例false可选

true 时在可用时附加指标列（默认 false）。

响应

base_currencystring示例BTC

基础资产或货币代码

quote_currencystring示例USDT

价格和金额使用的计价货币

timeframestring示例1h

单条数据的聚合周期

volume_unitstring示例base

成交量单位

volume_typestring示例base_amount

成交量计量口径

bars[]array[object (KlineBar)]

K线数据数组

open_timedatetime示例2026-08-17T17:00:00Z

K线周期开始时间

close_timedatetime示例2026-08-17T18:00:00Z

K线周期结束时间

opennumber示例64114.5

K线周期内第一笔成交价

highnumber示例64119

K线周期内最高成交价

lownumber示例64077

K线周期内最低成交价

closenumber示例64079.8

K线周期内最后成交价

volumenumber示例16.336379

统计窗口内累计成交数量

volume_unitstring示例base

成交量单位

base_currencystring示例BTC

基础资产或货币代码

timeframeTimeframe示例1h

单条数据的聚合周期

data_statusDataStatus示例ready

业务数据可用状态

data_statusDataStatus示例ready

业务数据可用状态

metadataobject

响应状态与解析信息容器

data_statusDataStatus示例ready

业务数据可用状态

actual_taskstring

实际执行的任务类型

route_reasonstring

任务或对象路由原因

limitations[]string[]

已知数据限制数组

updated_atdatetime | string示例2026-08-17T17:07:12Z

对象或响应最近更新时间

partialboolean

响应是否仅含部分字段

resolution_reasonstring

对象解析结果的原因码

object_refs[]object[]

统一对象引用数组

typeObjectRefType示例asset

对象引用类型

idstring示例asset_btc

对象标识，标识 type 指定的具体对象

entity_idstring

主体标识，标识公司、项目方或协议等主体

asset_idstring示例asset_btc

资产标识，标识股票、加密资产等资产对象

listing_idstring

交易场所挂牌标识，标识某个交易品种在特定交易场所的挂牌记录

instrument_idstring

交易工具标识，标识股票、现货交易对或合约等具体交易产品

venue_idstring

交易场所标识，标识交易所或交易平台

event_refstring

关联事件标识，标识与当前对象关联的事件

market_idstring

预测市场标识，标识预测事件下的具体市场

venuestring

对象关联的平台代码

resolved_fromstring示例asset_entity

对象解析所用输入来源

resolution_confidencestring示例resolved

对象解析置信度

错误与降级

200
assets_resolve 名称多命中；从 data[] 候选确认。
200
对象已解析但无可用数据；empty_reason 可为 not_covered_by_source / unsupported_metric / limited_depth。
400
参数无效，或行情 listing 多命中；歧义响应含 required_params + candidates。
401
缺少 API Key，或 Key 无效。
403
当前 Key 的 scope 或套餐无权访问该数据域。
404
请求的资源不存在；数据源不覆盖不归入 404。
402
Credits 或月度额度耗尽。
429
请求频率超限；body 返回 retry_after，响应头同步返回 Retry-After。