短线指标¶

作用¶

把 0x06b9 下载的 zhb.zip 统计资源与当前行情快照组合，返回流通市值Z、开盘换手Z、竞价昨比、开盘昨封比、昨封比、封流比、几天几板等 21 个短线字段。这个入口属于 Helper，不是新的二进制命令。

项目	内容
主要调用	`client.helpers.shortline_indicators(codes)`
兼容调用	`client.helpers.get_shortline_indicators(codes)`
返回模型	`ShortlineIndicatorTable` / `ShortlineIndicator`
底层能力	`0x06b9` 服务器文件、`0x054c + 0x0547` 行情快照、代码表、基准指数日 K

示例¶

from eltdx import TdxClient

with TdxClient(timeout=3) as client:
    table = client.helpers.shortline_indicators(
        ["sz000001", "sh600000"],
    )

for row in table.rows:
    print(
        row.full_code,
        row.open_turnover_z,
        row.auction_prev_volume_ratio,
        row.limit_board_text,
        row.alignment_status,
    )

统计资源在同一个 HelperApi 实例内按路径缓存。强制重新下载：

table = client.helpers.shortline_indicators(
    "sz000001",
    refresh_stats=True,
)

21 个指标字段¶

字段名中的 Z 沿用自由流通口径的命名，用来和普通流通股本、普通流通市值区分，不是统计学里的 Z-score，也没有做标准化。百分比字段已经乘以 100，例如 20.0 表示 20%；倍数字段以 1.0 表示与对比值相同。字段为 None 表示统计资源缺失、日期无法安全对齐、分母无效，或者当前状态不适用。

统计资源直接字段¶

字段	中文名称	业务含义	单位	来源 / 取值口径
`beta_60d`	近 60 日 Beta	反映近 60 日股价相对 TDX 统计资源所用市场基准的波动敏感度；eltdx 不重新选择或计算基准	无量纲	`tdxstat.cfg` 直接值
`pe_ttm`	滚动市盈率	反映当前估值相对最近 12 个月利润的倍数；eltdx 保留 TDX 统计值	倍	`tdxstat.cfg` 直接值
`free_float_shares`	流通股本Z	TDX 自由流通口径下可在市场交易的股份数量，不等同于普通流通股本	股	`free_float_shares_10k × 10000`
`prev_amount`	昨成交额	目标交易日的上一实际交易日全天成交金额，是开盘昨比的比较基数	元	按交易日对齐 `tdxstat2.cfg`
`prev_seal_amount`	昨封单额	上一实际交易日统计资源记录的涨停封单金额，用于和今日竞价金额、当前封单额比较	元	按交易日对齐 `tdxstat2.cfg`
`prev2_seal_amount`	前两日封单额	目标交易日前第二个实际交易日统计资源记录的涨停封单金额，可用于观察封单变化	元	按交易日对齐 `tdxstat2.cfg`
`prev_open_volume_hand`	昨开盘成交量	上一实际交易日 09:25 开盘集合竞价的成交量，是竞价昨比的比较基数	手	按交易日对齐 `tdxstat2.cfg`
`prev_open_amount`	昨开盘金额	上一实际交易日 09:25 开盘集合竞价的成交金额，用于直接比较两日竞价金额	元	按交易日对齐 `tdxstat2.cfg`
`limit_stat_days`	涨停统计窗口	“几天几板”中的统计天数，例如 `7` 表示观察最近 7 个统计日	天	`tdxstat.cfg` 直接值
`limit_up_count_in_stat_days`	统计期涨停次数	涨停统计窗口内记录的涨停次数，是“几天几板”中的板数	次	`tdxstat.cfg` 直接值
`limit_up_streak_days`	文件连板天数	统计文件日期当时记录的连续涨停天数；它保留文件原值，不一定包含目标交易日实时结果	天	`tdxstat.cfg` 直接值
`year_limit_up_days`	年内涨停天数	截至统计文件日期记录的当年累计涨停天数	天	`tdxstat.cfg` 直接值

计算字段¶

字段	中文名称	业务含义	单位	计算口径
`free_float_market_value`	流通市值Z	按自由流通股本计算的当前市值，用于衡量实际自由流通部分的规模	元	流通股本Z × 当前价
`open_turnover_z`	开盘换手Z	09:25 集合竞价成交量占自由流通股本的比例，反映竞价阶段的筹码换手程度	%	开盘成交量 ÷ 流通股本Z（换算成手）× 100
`open_prev_amount_ratio`	开盘昨比	今日 09:25 竞价成交额占昨日全天成交额的比例，反映今日竞价资金相对昨日全天活跃度	%	今日开盘金额 ÷ 昨成交额 × 100
`auction_prev_volume_ratio`	竞价昨比	今日 09:25 竞价成交量相对昨日 09:25 竞价成交量的倍数；`1.0` 表示两日相同	倍	今日开盘成交量 ÷ 昨开盘成交量
`open_prev_seal_ratio`	开盘昨封比	今日 09:25 竞价成交额占昨日涨停封单额的比例	%	今日开盘金额 ÷ 昨封单额 × 100
`seal_to_float_ratio`	封流比	当前买一金额占自由流通市值的比例；只有 `limit_status="sealed"` 时才应把买一金额解释为涨停封单强度	%	当前买一金额 ÷ 流通市值Z × 100
`seal_prev_ratio`	封昨比（昨封比）	当前买一金额相对昨日涨停封单额的倍数；`1.0` 表示与昨日相同，解读封单强度时应同时确认当前已封板	倍	当前买一金额 ÷ 昨封单额
`limit_board_text`	几天几板	把统计窗口和窗口内涨停次数整理为可读文本，例如 `7天5板`；文件为上一交易日且今日封板时会计入今日	文本	`limit_stat_days` 和 `limit_up_count_in_stat_days` 组合
`ladder_level`	当前连板高度	当前连续封住涨停的板数；仅当前 `limit_status="sealed"` 时返回，否则为 `None`	板	结合统计日期、文件连板天数和当前封板状态计算

封单类字段中的“当前买一金额”来自盘口买一价乘买一量。股票没有封住涨停时它只是普通买一金额，因此 seal_to_float_ratio 和 seal_prev_ratio 必须结合 limit_status 使用，不能单独当作涨停封单指标。

题材强度、题材排名、题材最高板等概念/行业聚合结果不属于这 21 个字段。

时间对齐¶

目标交易日来自 TDX 握手，上一交易日来自上证指数实际日 K，不使用本机日期猜测。交易日 09:25 以前实时竞价尚未完成，会抛出 ShortlineIndicatorsNotReadyError。

tdxstat.cfg 和 tdxstat2.cfg 必须具有相同的主导统计日期，并且各自至少 95% 的有效行属于该日期。统计日期只接受以下两种情况：

统计文件日期	`alignment_status`	昨日字段取法
等于目标交易日	`same_day`	使用文件的 `prev_*` 列
等于上一交易日	`previous_trading_day`	使用文件的当日列作为目标日的昨日值

如果文件日期既不是目标交易日，也不是上一交易日，会抛出 TdxStatsDateError。少量个股行日期不一致时，该行的历史分母返回 None，并通过 alignment_status 标明原因，不会跨日误算。

当统计文件仍是上一交易日且股票当前封住涨停时，limit_board_text 和 ladder_level 会把今天计入；直接字段 limit_up_streak_days、year_limit_up_days 仍保留文件原值。

结果元数据¶

ShortlineIndicatorTable 还返回：

字段	含义
`target_trade_date`	当前行情对应的目标交易日
`previous_trade_date`	上一实际交易日
`stats_date`	统计资源主导日期
`stats_source_path`	统计资源来源
`stats_refreshed`	本次是否重新下载
`count`	返回股票数量

每一行还包含 full_code、stats_date、alignment_status 和 limit_status。limit_status 为 sealed、touched、none 或 unknown。

缓存边界¶

eltdx 只做当前客户端内的内存缓存，不建立磁盘数据库。统计文件日期仍可用于目标日时会复用；跨到新的交易日且旧文件不再可用时自动重新下载。refresh_stats=True 或 client.clear_cache() 可以主动刷新/清空。