7709-K线周期线¶

作用¶

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

项目	内容
主要调用	`client.bars.get(code_or_codes, ...)`
底层接口	`0x052d`
返回模型	单只 `KlineSeries`；代码列表为 `dict[str, KlineSeries]`

all_pages=False（默认）只取一页；all_pages=True 自动请求到主站返回空页，并把结果合并为一个 KlineSeries。

示例¶

from eltdx import TdxClient

with TdxClient(timeout=3) as client:
    day = client.bars.get("sz000001", period="day", count=200)
    qfq = client.bars.get("sz000001", period="day", adjust="qfq", count=200)
    fixed = client.bars.get("sz000001", period="day", adjust="fixed_qfq", anchor_date="2024-06-03")
    history = client.bars.get("sz000001", period="day", all_pages=True, page_size=800)
    many = client.bars.get(["sz000001", "sh600000"], period="day", count=800, batch_size=2)

client.bars.get() 使用 code 位置参数，周期通过 period= 指定。code 可以是单个代码或代码序列；单个代码返回 KlineSeries，代码序列返回以规范化完整代码为键的字典。列表查询仍按底层协议逐只请求，并由连接池并发调度。

真实返回样本¶

Python 实际返回 KlineSeries。下面从 to_jsonable(day) 中保留系列信息和两根日 K；bars 完整列表及原始十六进制未全部展开。

真实返回 JSON · KlineSeries（日 K，2 条节选）

采样标的sz000001

数据日期2026-08-13 至 2026-08-14

返回类型KlineSeries

真实采样；请求参数为 period="day"、count=3、adjust=None。

{
  "exchange": "sz",
  "market_id": 0,
  "code": "000001",
  "period_raw": 4,
  "period_param_raw": 1,
  "period_name": "day",
  "start": 0,
  "request_count": 3,
  "adjust_mode_raw": 0,
  "adjust_mode": "none",
  "anchor_date_raw": 0,
  "anchor_date": null,
  "bars": [
    {
      "time": "2026-08-13T15:00:00+08:00",
      "open": 11.23,
      "close": 11.25,
      "high": 11.27,
      "low": 11.18,
      "volume_lots": 755980.8,
      "amount": 848358784.0,
      "up_count": null,
      "down_count": null
    },
    {
      "time": "2026-08-14T15:00:00+08:00",
      "open": 11.22,
      "close": 11.11,
      "high": 11.23,
      "low": 11.11,
      "volume_lots": 832343.76,
      "amount": 929098432.0,
      "up_count": null,
      "down_count": null
    }
  ]
}

参数¶

参数	含义
`code`	单个证券代码或代码序列
`period`	周期
`start`	起始位置，从 `0` 开始
`count`	本页条数，默认 `800`
`adjust`	复权模式
`anchor_date`	定点复权日期
`kind`	默认按代码自动识别（`sh000/sh880/sh881/sh999`、`sz399`、`bj899` 为指数）；也可显式传 `stock` 或 `index`。指数 K 线会解析上涨 / 下跌家数
`include_raw`	是否保留原始 payload
`all_pages`	`False` 取一页；`True` 自动翻页并合并
`page_size`	自动分页时的每页条数，默认及最大值均为 `800`
`max_pages`	自动分页最大页数，默认 `200`；`None` 表示不设 SDK 页数上限
`batch_size`	代码列表查询的最大并发数，默认跟随连接池容量

自动分页从 start 开始，每次按服务端实际返回条数推进。短页不代表结束，只有主站返回空页才停止；达到 max_pages 仍未返回空页会抛出 RuntimeError。合并结果保留首个响应的系列元数据，request_count 更新为合并后的 K 线总数。

0x052d 每次查询一只证券，每页最多 800 根。单只证券的自动分页按页序串行执行；同时查询多只证券时，可以从多个线程调用同一个 TdxClient，请求会由连接池分配到多台主站的多个 Slot。

周期¶

`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。普通前复权、后复权不用传。

adjust="none" / "qfq" / "hfq" 的结果都由 0x052d 主站直接返回。直接获取不复权、前复权或后复权 K 线时，使用本接口；已有本地不复权 K 线并需要自行计算时，使用 client.corporate.adjustment_factors()。

解析字段¶

`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`