趋势 K 线
查询带可选技术指标的趋势 K 线。
GET/api/v1/markets/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最低价
ma7number7 周期移动平均
macdnumberMACD 指标值
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。