短线指标¶

作用¶

把 0x06b9 下载的 zhb.zip 统计资源、实时行情、最近 5 个完整日 K 和财务快照组合，返回竞价、流通股本、封单和连板指标。这个入口属于 Helper，不是新的二进制命令。

项目	内容
主要调用	`client.helpers.shortline_indicators(codes)`
组合行情	`client.helpers.full_quotes()` 组合 `0x054c + 0x0547` 获取实时五档行情
返回模型	`ShortlineIndicatorTable` / `ShortlineIndicator`
底层能力	`0x06b9` 服务器文件、`0x054c + 0x0547` 实时行情、代码表、基准指数日 K

输入参数¶

参数	是否必填	说明
`codes`	是	股票代码或代码列表
`stats_path`	否	统计资源路径，默认 `zhb.zip`
`refresh_stats`	否	是否强制重新下载统计资源，默认 `False`

示例¶

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,
)

指标字段¶

ShortlineIndicatorTable 顶层字段为 codes、target_trade_date、previous_trade_date、stats_date、stats_source_path、stats_refreshed、rows 和 count。rows 中每条记录的字段如下。

字段名中的 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`	板	结合统计日期、文件连板天数和当前封板状态计算

实时竞价与普通流通口径字段¶

字段	中文名称	业务含义	单位	计算口径
`open_price`	开盘价	当前交易日开盘价	元	`0x054c` 快照
`pre_close`	昨收价	当前交易日涨跌幅基准	元	`0x054c` 快照
`open_change_pct`	开盘涨幅	开盘价相对昨收的涨跌幅	%	`(open_price-pre_close)/pre_close×100`
`open_amount`	开盘金额	09:25 正式撮合金额	元	`0x054c` 快照
`open_volume_hand`	开盘成交量	09:25 正式撮合成交量	手	`open_amount/(open_price×100)`
`open_volume_ratio`	开盘量比	开盘成交量相对近 5 个完整交易日平均每分钟成交量	倍	`open_volume_hand ÷ (近 5 日日 K 成交量合计 / 1200)`
`opening_rush`	开盘抢筹	原生分类行情提供的开盘抢筹值；快照未提供时为 `None`	%	`0x054b` 字段，不猜测尾部字节
`float_shares`	普通流通股本	财务快照口径的流通股本	股	`FinanceRecord.circulating_shares`
`float_market_value`	普通流通市值	普通流通股本对应的当前市值	元	`float_shares×last_price`
`seal_amount`	当前买一金额	当前买一价×买一量；仅封板时解释为封单额	元	五档盘口买一
`seal_to_amount_ratio`	封单成交额比	当前买一金额占当日成交额比例	倍	`seal_amount÷amount`

open_volume_ratio 需要至少 5 根完整日 K；数据不足时返回 None。这些新增字段不会改变原有 21 个统计字段。

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

题材强度、题材排名、题材最高板等概念/行业聚合结果使用独立的 theme_strength_rank()，不混进单股短线字段。

时间对齐¶

目标交易日来自 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() 可以主动刷新/清空。

真实返回样本¶

真实返回 JSON · ShortlineIndicatorTable（1 条）

采样标的sz000001

目标交易日2026-08-17

返回类型ShortlineIndicatorTable

真实采样；统计资源日期为上一交易日 2026-08-14，完整展示一行 21 项短线字段。

{
  "codes": ["sz000001"],
  "target_trade_date": "2026-08-17",
  "previous_trade_date": "2026-08-14",
  "stats_date": "2026-08-14",
  "stats_source_path": "tdx://zhb.zip",
  "stats_refreshed": true,
  "rows": [
    {
      "full_code": "sz000001",
      "alignment_status": "previous_trading_day",
      "limit_status": "none",
      "beta_60d": -0.2146,
      "pe_ttm": 5.01,
      "free_float_shares": 8160565600.000001,
      "prev_amount": 929098400.0,
      "prev_open_volume_hand": 2852.0,
      "prev_open_amount": 3199900.0,
      "year_limit_up_days": 0,
      "free_float_market_value": 90582278160.00002,
      "open_turnover_z": 0.025792,
      "open_prev_amount_ratio": 2.537273,
      "auction_prev_volume_ratio": 7.380084,
      "open_prev_seal_ratio": null,
      "seal_to_float_ratio": 0.000505,
      "seal_prev_ratio": null,
      "limit_board_text": null,
      "ladder_level": null
    }
  ]
}