---
title: "查询 K线数据"
method: GET
path: "/v1/klines"
tags: ["K线数据"]
---

# 查询 K线数据

`GET /v1/klines`

## Query parameters

- `symbol` string, required
- `period` '1m' | '5m' | '10m' | '15m' | '30m' | '60m' | '1d' | '1w' | '1M' | '1Q' | '1Y' — K线周期
- `count` integer
- `start_time` integer, nullable
- `end_time` integer, nullable
- `adjust` 'forward' | 'backward' | 'forward_additive' | 'backward_additive' | 'none' — 复权类型

## Response `200`

查询成功

- KlinesResponse
  - `data` CompactKlineData, required — 紧凑列式K线数据（用于高效传输）
    - `amount` number[], required — 成交额
    - `close` number[], required — 收盘价
    - `high` number[], required — 最高价
    - `low` number[], required — 最低价
    - `open` number[], required — 开盘价
    - `open_interest` number[] — 持仓量
    - `prev_close` number[] — 前收盘价
    - `settlement_price` number[] — 结算价
    - `timestamp` integer[], required — 时间戳 (毫秒)
    - `volume` integer[], required — 成交量

## Other responses

- `400` — 参数错误
- `401` — 认证失败
- `403` — 无权限
- `404` — 标的不存在

---

[API](https://skmtc.dev/tickflow/apis/tickflow-api.md) · [All operations](https://skmtc.dev/tickflow/apis/tickflow-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/tickflow/tickflow-api/revisions/13831df8eba1/schema)