跳转至

← 返回接口目录

7709-全量K线分页

作用

自动按页拉取 K 线并合并,直到服务端返回短页。适合补历史日线、分钟线或长期周期数据。

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

示例

from eltdx import TdxClient

with TdxClient(timeout=3) as client:
    series = client.bars.all("sz000001", period="day")
    qfq = client.get_kline_all("day", "sz000001", adjust="qfq")

最多拉 20 页:

series = client.get_kline_all("day", "sz000001", page_size=800, max_pages=20)

参数

参数 含义
code 证券代码
period 周期,和 client.bars.get() 一致
adjust 复权模式
anchor_date 定点复权日期
kind stockindex
page_size 每页条数
max_pages 最多拉几页;防止异常情况下无限循环
include_raw 是否保留原始 payload

解析字段

返回字段同 7709-K线周期线.md。区别是 bars 已经合并多页结果,request_count 会被更新为最终合并后的条数。

翻页规则

项目 说明
起始页 start=0
下一页 start += page_size
停止条件 某页返回数量 < page_size
安全阈值 max_pages 不为 None 时,超过页数直接抛错

全量方法每次按请求读取结果。K 线属于可能频繁变化的数据,尤其是当日分钟线和当日日 K,适合由调用方按自己的策略缓存。