K 线返回字段速查
K 线返回 8 个字段:date、open、last、high、low、volume、amount、turnover,不随周期变。两个最容易踩的点:收盘价字段叫 last 不叫 close;所有数值都是字符串,不是数字。
返回长什么样
GET /v1/kline?code=sh600519&count=2 的真实返回:
{
"ok": true,
"endpoint": "kline",
"tier": "free",
"elapsed_ms": 701,
"source": "multi",
"data": [
{ "date": "2026-09-30", "open": "1239.53", "last": "1258.62", "high": "1268",
"low": "1236.05", "volume": "38331", "amount": "4797250000", "turnover": "0.31" }
]
}
外层 5 个字段是每个端点都一样的:ok 是否成功、endpoint 端点名、tier 当前档位、elapsed_ms 耗时、source 数据来源。要取的行情数据都在 data 数组里。
八个字段各是什么
| 字段 | 含义 | 单位 / 格式 |
|---|---|---|
date |
交易日 | YYYY-MM-DD |
open |
开盘价 | 元 |
last |
收盘价 | 元 |
high |
最高价 | 元 |
low |
最低价 | 元 |
volume |
成交量 | 手 |
amount |
成交额 | 元 |
turnover |
换手率 | 百分比数值(0.31 = 0.31%) |
字段不随周期变
上面 8 个字段是固定的,不论你取日线、周线还是分钟线,返回都是这 8 列。
period 可取的周期:day 日线(默认)/ week 周线 / month 月线 / season 季线 / year 年线 / m1 m5 m15 m30 m60 m120 分钟线。
⚠️ 分钟线有三个额外限制(和日线不同):
- 付费层 —— 需要 API Key;日 / 周 / 月 / 季 / 年线免费。
- 不复权 —— 给的是原始价,除权除息日可能出现跳空(见「复权口径」)。
- 只覆盖近 1 个月 —— 窗口起点约为上个自然月月初,超范围返回空结果。
⚠️ 标的边界(哪些代码能取到分钟线):分钟线支持 沪深A股 / 指数 / 板块 / ETF / 可转债 / 港股 / 美股;北交所 / 期货 / 外汇 / 美股指数没有分钟线,传这些代码会返回 422「不支持分钟K线」(北交所的分钟级数据改用 /v1/minute 取分时)。美股指数 us.DJI / us.IXIC / us.SPX 只支持 day;期货 / 外汇只有 day / week / month。
两个最容易踩的坑
收盘价字段为什么叫 last 不叫 close?
因为同一个字段在盘中代表最新价、收盘后代表收盘价 —— 一个名字覆盖两种含义,不用按时间切换字段名。所以如果你在迁代码,映射关系是 close → last,不是 close → close。
数值为什么是字符串?
"1258.62" 是字符串,不是数字。这样设计是为了不丢精度 —— 浮点数在跨语言传递时会出现 1258.6200000000001 这类误差,而金额和价格对精度敏感。取值时自己转:
import requests
r = requests.get("https://api.ashareapi.com/v1/kline",
params={"code": "sh600519", "count": 250}).json()
for row in r["data"]:
close = float(row["last"]) # 字符串 → float
amount = float(row["amount"])
常见误用
- 拿
volume当股数 —— 它是手(1 手 = 100 股),要股数得乘 100。 - 拿
turnover当小数 ——0.31表示 0.31%,不是 31%。 - 不判
ok就取data—— 失败时data可能为空或缺席,先看ok。 - 忘了 K 线没有
adjust参数 —— 复权口径是固定的,不需要也不接受这个参数。 - 拿日线的复权假设去比分钟线 —— 分钟线不复权,两者的价格序列口径不同。
- 对北交所 / 期货 / 外汇取分钟线 —— 这些标的没有分钟线,会返回 422 + 明确说明(不是空数组);北交所的分钟级数据改用
/v1/minute取分时。
最后更新: 2026-10-07
字段与示例取自 2026-10-05 线上真实返回(/v1/kline?code=sh600519&count=2);周期与标的边界按 2026-10-07 线上 openapi 核对。