API Reference
完整的 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 显式给出。除以它即得真实价格。这样你与别家逐根对账时不会遇到浮点伪差。
ts 是 Unix 秒,指向该分钟的【开盘】时刻。09:30 那根覆盖 [09:30:00, 09:31:00)。这是接入时最容易搞错的一点。
某分钟没有成交就没有这根 K 线(尤其盘前盘后)。返回 200 + 空数组表示确实没有数据;上游故障会返回 5xx,绝不用 200 伪装成功。
失败响应的 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 判断是否有新数据,没有就跳过这一轮。