API Reference

API 文档

完整的 OpenAPI 3.1 规范可直接下载,也可用任意生成器产出你所需语言的客户端。

端点

GET /v1/bars/1m 批量取 1 分钟 K 线(主端点)
GET /v1/bars/1m/{symbol} 单标的便捷式
GET /v1/snapshot 批量取最新已定稿 K 线
GET /v1/snapshot/{symbol} 单标的最新已定稿 K 线
GET /v1/symbols 覆盖的标的全集
GET /v1/calendar 交易日历与时段边界
GET /v1/coverage 每日完整率与缺口
GET /v1/corrections 已发布的迟到修正
GET /v1/corporate-actions 拆股与分红
GET /v1/usage 自己的用量与配额
GET /v1/status 数据源状态(免鉴权)

接入前必读的几条约定

价格是缩放整数

所有价格以 ×10000 的整数返回,meta.price_scale 显式给出。除以它即得真实价格。这样你与别家逐根对账时不会遇到浮点伪差。

时间戳是 K 线开盘时刻

ts 是 Unix 秒,指向该分钟的【开盘】时刻。09:30 那根覆盖 [09:30:00, 09:31:00)。这是接入时最容易搞错的一点。

没有数据 ≠ 出错

某分钟没有成交就没有这根 K 线(尤其盘前盘后)。返回 200 + 空数组表示确实没有数据;上游故障会返回 5xx,绝不用 200 伪装成功。

错误是 RFC 9457

失败响应的 Content-Type 是 application/problem+json,含 type / title / status / detail / instance。instance 就是 X-Request-Id,报障时带上它。

限流状态在响应头

RateLimit-Limit / RateLimit-Remaining / RateLimit-Reset。被限流时返回 429 并带 Retry-After,请按它退避(建议再加随机抖动)。

建议每分钟轮询一次

数据是 1 分钟粒度,更高频的轮询只会烧配额。用 meta.as_of 判断是否有新数据,没有就跳过这一轮。