跳转至

← 返回接口目录

7709-退市 K 线(日线、不复权)

作用

查询退市股票的不复权日线,支持单只或批量查询、自动分页。

项目 内容
主要调用 client.delisted_bars.get(code, ...)
底层接口 0x052b
返回模型 单只:KlineSeries;批量:dict[str, KlineSeries]
单页上限 800 根

示例

from eltdx import TdxClient

with TdxClient(timeout=3, pool_size=3) as client:
    # 查询最近 800 根日线
    page = client.delisted_bars.get("T000038", count=800)
    # 自动翻页获取历史日线
    history = client.delisted_bars.get("T000038", all_pages=True)
    # 一次查询多只,每只股票独立翻页
    histories = client.delisted_bars.get(
        ["T000038", "002087", "sh600001"], all_pages=True, batch_size=3
    )
    for code, series in histories.items():
        print(code, series.count)
    first_history = histories["sz000038"]

代码支持 T000038、sz000038 和 000038 三种写法,数字须使用半角 0-9。批量查询会先校验所有代码,代码无效时直接报错,不发送查询请求。

code 传字符串时返回一个 KlineSeries;传列表或元组时返回字典,键为 sz000038、sh600001 等标准代码。批量结果保留输入顺序,相同股票的不同代码写法会合并,只查询一次;空列表会报错。batch_size 控制同时查询多少只股票,实际并发不超过 pool_size,默认随连接池容量。任一股票查询失败时,整次调用会抛出异常。

all_pages=False(默认)查询一页;all_pages=True 自动向前翻页,直到返回空页。每页不足 page_size 根时也会继续查询,合并后的 bars 按日期升序排列,保留所有记录,不自动去重。达到 max_pages 仍未收到空页时,抛出 RuntimeError。可查询的历史范围取决于主站保存的数据。

手动分页时,start=0 从最新数据开始;下一页的 start 为上一页起点加实际返回根数。

真实返回样本

以下为 sz000038 返回结果的节选,请求参数为 count=20, include_raw=True,展示其中最后一根日线。

真实采样 · 退市日线不复权
{
  "exchange": "sz",
  "market_id": 0,
  "code": "000038",
  "period_name": "day",
  "start": 0,
  "request_count": 20,
  "adjust_mode": "none",
  "bars": [
    {
      "time": "2023-07-11T00:00:00+08:00",
      "open": 0.54,
      "close": 0.52,
      "high": 0.55,
      "low": 0.51,
      "volume_raw": 20940451,
      "volume_wire_value": 20940451.0,
      "volume_lots": 209404.51,
      "amount": 10931139,
      "record_hex": "37b234014a540a5ea39afc13c3cb264b00000100"
    }
  ]
}

参数

参数 类型 默认值 怎么填
code 字符串、列表或元组 必填 单只填 "T000038"、"sz000038" 或 "000038";多只填 ["T000038", "002087", "sh600001"]
period 字符串 "day" 查询日线时可省略;支持 "day"、"1d"、"d"、"daily"
start 整数 0 从最新数据开始;手动查下一页时,加上上一页实际返回根数。范围 0..65535
count 整数 800 单页请求根数,例如 20,范围 1..800;仅在 all_pages=False 时使用
adjust 字符串或 None None 查询不复权日线时可省略,也可填 "none"
include_raw 布尔值 False 填 True 保留 raw_payload 和每条 record_hex;填 False 只取解析结果
all_pages 布尔值 False 填 True 自动翻页直到空页;填 False 只取 start/count 指定的一页
page_size 整数 800 自动分页每页请求根数,范围 1..800;通常保持默认,仅在 all_pages=True 时使用
max_pages 整数或 None 200 每只股票最多请求页数,须为正整数,例如 200;达到上限仍未收到空页会报错。填 None 不设页数上限,分页起点仍须在 start 的范围内;仅在 all_pages=True 时使用
batch_size 整数或 None None 同时查询的股票数,例如 3;填 None 随连接池容量,填 1 顺序查询。须为正整数,实际并发不超过 pool_size

True、False 和 None 都使用 Python 值,无需加引号。

例如,只查询最近 20 根日线和自动获取历史日线分别写为:

page = client.delisted_bars.get("T000038", all_pages=False, count=20)
history = client.delisted_bars.get("T000038", all_pages=True)

返回字段

单只返回 KlineSeries,批量返回 {标准代码: KlineSeries}。每个结果的 bars 为 KlineBar 序列,count 为日线根数。period_name="day",adjust_mode="none"。批量开启自动分页时,start、page_size 和 max_pages 分别应用于每只股票。

字段 含义
time 交易日期,以上海时区当天 00:00 表示
open / close / high / low 不复权开高低收价格,单位元
volume_raw / volume_wire_value 成交量,单位股
volume_lots 手数,股数除以 100
amount 成交额,单位元
last_close_price_milli 同页前一条记录的收盘毫厘价;每页首条为 None
record_hex include_raw=True 时保留单条记录的原始十六进制
raw_payload include_raw=True 时保留原始响应;自动分页时仅保留第一页的原始响应

默认 include_raw=False 时 record_hex=""、raw_payload=b""。若需要逐页原文,请使用 start/count 手动分页。

普通证券的多周期和复权查询见 K 线 / 周期线。