趋势 K 线

查询带可选技术指标的趋势 K 线。

GET/api/v1/markets/trend-kline
数据域
行情与流动性
解析层级
资产
MCP 工具
market_data_query (task=trend_kline)

可查询数据

返回数据
查询带可选技术指标的趋势 K 线
每次返回什么
可开启技术指标列;size 与 limit 含义相同。

认证

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

请求参数

symbolstringquery示例BTC必填

带市场前缀的股票代码,例如 US.AAPL;与 entity_id 至少填写一项

timeframestringquery示例1h必填

K 线或指标周期 · 1m / 5m / 15m / 1h / 4h / 1d

periodstringquery可选

查询时间范围 · 1h / 4h / 24h / 7d / 3d / 5d / 10d · 默认: 24h

sizeintegerquery示例2可选

返回数量上限 · 默认: 100 · ≥ 1, ≤ 400

limitintegerquery可选

最多返回条数 · ≥ 1, ≤ 400

with_indicatorsbooleanquery示例true可选

是否返回技术指标列 · 默认: false

start_timestringquery可选

UTC起始时间(包含),支持RFC3339、日期或Unix秒;别名 from

end_timestringquery可选

UTC结束时间(不包含);仅填写日期时包含该UTC自然日;别名 to

响应

countnumber

本次返回条数

data_statusDataStatus

数据状态

periodstring

查询时间范围

sizenumber

返回数量上限

totalnumber

匹配记录总数

items[]object[]

结果列表

close_pricenumber

收盘价

deal_cntnumber

成交计数

high_pricenumber

最高价

low_pricenumber

最低价

ma7number

7 周期移动平均

macdnumber

MACD 指标值

open_pricenumber

开盘价

rsinumber

相对强弱指标

timedatetime

时间点

timestampdatetime

时间戳

错误与降级

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。