7709-K线周期线¶

作用¶

查询一页 K 线 / 周期线，支持分钟、日、周、月、季、年，以及服务端前复权、后复权、定点复权参数。

项目	内容
主要调用	`client.bars.get(code, ...)`
旧版兼容	`client.get_kline(...)`
底层接口	`0x052d`
返回模型	`KlineSeries`

这个方法只取一页。如果要自动翻页拉完整历史，用 7709-全量K线分页.md。

示例¶

from eltdx import TdxClient

with TdxClient(timeout=3) as client:
    day = client.bars.get("sz000001", period="day", count=200)
    qfq = client.get_kline("day", "sz000001", adjust="qfq", count=200)
    fixed = client.bars.get("sz000001", period="day", adjust="fixed_qfq", anchor_date="2024-06-03")
    fixed_compat = client.get_adjusted_kline("day", "sz000001", adjust="fixed_qfq", anchor_date="2024-06-03")

client.get_kline() 兼容两种参数顺序：

client.get_kline("day", "sz000001")
client.get_kline("sz000001", "day")

参数¶

参数	含义
`code`	证券代码
`period`	周期
`start`	起始位置，从 `0` 开始
`count`	本页条数，默认 `800`
`adjust`	复权模式
`anchor_date`	定点复权日期
`kind`	`stock` 或 `index`；指数 K 线可能解析上涨 / 下跌家数
`include_raw`	是否保留原始 payload

周期¶

`period`	底层编号	含义
`1m` / `1min` / `minute`	`7/1`	1 分钟 K
`5m` / `5min`	`0/1`	5 分钟 K
`15m` / `15min`	`1/1`	15 分钟 K
`30m` / `30min`	`2/1`	30 分钟 K
`60m` / `60min` / `1h`	`3/1`	60 分钟 K
`day` / `1d` / `daily`	`4/1`	日 K
`week` / `1w`	`5/1`	周 K
`month` / `1mo`	`6/1`	月 K
`quarter` / `1q`	`10/1`	季 K
`year` / `1y`	`11/1`	年 K
`10m`、`20m` 等	`8/N`	N 分钟扩展周期
`2d`、`45d` 等	`9/N`	N 日扩展周期
`5s`、`15s` 等	`13/N`	N 秒周期

扩展周期是否有数据以服务端实际支持为准。

复权¶

`adjust`	底层值	含义
`None` / `none`	`0`	不复权
`qfq` / `front`	`1`	前复权
`hfq` / `back`	`2`	后复权
`fixed_qfq` / `fixed_front`	`3`	定点前复权，需要 `anchor_date`
`fixed_hfq` / `fixed_back`	`4`	定点后复权，需要 `anchor_date`

anchor_date 支持 YYYY-MM-DD、YYYYMMDD、date / datetime。普通前复权、后复权不用传。

解析字段¶

`KlineSeries` 字段	含义
`exchange`	市场前缀，`sz` / `sh` / `bj`
`market_id`	市场编号，`0=sz`、`1=sh`、`2=bj`
`code`	六位代码
`full_code`	完整代码
`period_raw` / `period_param_raw`	底层周期编号
`period_name`	SDK 周期名
`start` / `request_count`	请求起点 / 请求条数
`adjust_mode_raw` / `adjust_mode`	复权模式原始值 / SDK 复权名
`anchor_date_raw`	定点复权日期原始值，`0` 表示未使用
`anchor_date`	定点复权日期
`bars`	K 线列表
`count`	实际 K 线数量
`raw_payload`	原始 payload

`KlineBar` 字段	含义
`time`	K 线时间
`open` / `high` / `low` / `close`	开高低收
`open_price_milli` / `high_price_milli` / `low_price_milli` / `close_price_milli`	千分价格单位的开高低收
`last_close_price_milli`	上一根收盘毫厘价
`volume_raw`	成交量 compact-float 原始值
`amount_raw`	成交额 compact-float 原始值
`volume_wire_value`	成交量 wire 解码值
`volume_lots`	成交量，单位手
`amount`	成交额
`open_delta_raw` / `close_delta_raw` / `high_delta_raw` / `low_delta_raw`	协议价格差分原始值
`up_count` / `down_count`	指数类上涨 / 下跌家数，股票通常为空
`record_hex`	单条 K 线原始十六进制

解码口径¶

项目	说明
价格	协议里是差分编码；SDK 已还原成 `open/high/low/close`
价格单位	`*_price_milli` 是千分价格单位；展示价是除以 `1000`
成交量	`volume_lots = volume_wire_value / 100`，A 股常用单位为手
成交额	`amount` 已按 compact-float 解码
指数宽度	`kind="index"` 时解析 `up_count/down_count`
原始数据	`include_raw=True` 时保留 `raw_payload` 和每条 `record_hex`