F10 涨跌停列表¶

client.f10.limit_up_down_list() 是 7615/TQLEX 的 CWServ.cfg_fx_lbtt 封装。它按交易日返回服务端的逐股涨停、炸板和跌停明细；可选读取页面顶部的市场概况。它不是实时 7709 行情接口，盘中实时监控请使用 client.helpers.limit_ladder()。

调用¶

from eltdx import TdxClient

with TdxClient(timeout=8) as client:
    # 单日明细
    table = client.f10.limit_up_down_list("20260904")

    # 日期范围；rows 会包含两个交易日的明细
    history = client.f10.limit_up_down_list("20260903", "20260904")

    # 同时请求页面顶部市场概况
    with_summary = client.f10.limit_up_down_list(
        "20260904",
        include_summary=True,
    )

for row in table.rows:
    print(
        row.full_code,
        row.status,          # limit_up / broken / limit_down
        row.board_level,     # 仅涨停行有实际板位
        row.name,
        row.reason,
    )

print(with_summary.market_overview)

日期参数¶

写法	示例	说明
不传日期	`limit_up_down_list()`	查询当天；非交易日可能返回空列表
单日	`limit_up_down_list("20260904")`	起止日期都使用该日期
日期范围	`limit_up_down_list("20260903", "20260904")`	起始日期不能晚于结束日期
支持格式	`20260904`、`"2026-09-04"`、`"2026/09/04"`、`date(2026, 9, 4)`	最终统一为 `YYYYMMDD`

请求和服务端参数¶

明细请求实际发送：

POST http://hot.icfqs.com:7615/TQLEX?Entry=CWServ.cfg_fx_lbtt&RI=
{"Params":["1","20260904","20260904"]}

Params[0] = "1"：逐股明细。
Params[0] = "2"：市场概况；仅在 include_summary=True 时发送第二次请求。
该接口使用 HTTP 7615，不需要 7709 握手，也不占用行情连接池。
服务端不接受封单额、时间、开板次数等排序参数；SDK 保留服务端原始顺序，排序需调用方本地完成。

返回模型：`LimitBoardLadder`¶

字段	类型/示例	含义
`start_date` / `end_date`	`"20260904"`	实际查询范围，始终为 `YYYYMMDD`
`rows`	`tuple[LimitBoardLadderRow, ...]`	逐股明细；日期范围查询时包含所有日期的行
`summary`	`tuple[dict, ...]`	`include_summary=True` 时的服务端原始概况行，否则为空元组
`market_overview` / `overview`	`tuple[dict, ...]`	将 `summary` 映射成可读字段；日期范围时每天一条
`ladder_counts`	`{板位: 数量}`	仅统计 `status="limit_up"` 的明细行；日期范围会合并日期
`ladder_counts_by_date`	`{日期: {板位: 数量}}`	日期范围按交易日分别统计，推荐使用
`promotion_rates` / `promotion_rates_by_date`	`{板位: 比率}`	当前板位数量 ÷ 紧邻低一板位数量；无低一板位时不返回该板位
`raw`	`dict`	明细请求的完整原始 JSON
`ok` / `error_code`	`True` / `0`	服务端状态

明细行：`LimitBoardLadderRow`¶

字段	原始字段	明确含义
`trading_date`	`rq`	页面显示日期，例如 `09月04日`
`trading_date_value`	`rqex`	机器可用日期，例如 `20260904`
`board_level`	`lbts`	该股票实际连板数；只对 `ztlb=1` 的涨停行提供，炸板/跌停行规范为 `None`（推荐使用）
`highest_board_level`	`zglb`	当天最高板；服务端会在每一行重复返回，不是该股票自身板位
`code`	`ZQDM`	六位证券代码
`market_id`	`SC`	市场号：`0` 深市、`1` 沪市、`2` 北交所
`full_code`	派生	带市场前缀的代码，例如 `sz000001`
`name`	`ZQJC`	证券简称
`industry`	`sshy`	所属行业；不要与涨停原因混淆
`limit_reason`	`ztyy`	服务端第一原因/题材文字
`limit_reason_extra`	`ztyy2`	服务端第二原因/补充文字
`reason`	派生	优先返回 `limit_reason`，为空时回退到 `limit_reason_extra`
`seal_amount`	`fde`	对应方向的封单金额：`ztlb=1` 为涨停封单，`ztlb=0` 为跌停封单；`ztlb=3` 炸板行通常为 `0`
`limit_time`	`ztsj`	涨跌停/触及涨跌停时间，格式通常为 `HH:MM:SS`
`broken_count`	`kbcs`	对应涨跌停的开板/破板次数；跌停行也可能有值
`limit_type`	`ztlb`	行类型：`1` 涨停、`3` 炸板、`0` 跌停
`status`	派生	`limit_up`、`broken`、`limit_down`；未知值为 `unknown`
`success_rate`	`cgl`	服务端原始成功率/晋级相关值，具体口径由服务端定义
`raw`	原始行	保留该行全部原始字段，便于核对新增列

最容易混淆的几个字段：

ztlb=1  → 这一行是涨停股票，不是涨停总数
lbts    → 这一只股票的实际板位，对应 SDK 字段 board_level
zglb    → 当天最高板，通常在所有行中重复
fde     → 按 ztlb 决定是涨停封单还是跌停封单

市场概况：`market_overview`¶

include_summary=True 时，服务端 Nxxx 字段映射如下：

可读字段	原始字段	含义
`trade_date`	`N001` / `t001`	概况所属交易日
`advancing_count`	`N002`	上涨家数
`declining_count`	`N003`	下跌家数
`flat_count`	`N004`	平盘家数
`limit_up_count`	`N005`	服务端统计的市场涨停家数
`limit_down_count`	`N006`	服务端统计的市场跌停家数
`today_amount`	`N007`	当日成交额，单位元
`previous_amount`	`N008`	上一交易日成交额，单位元
`hot_topics`	`N009/N010`、`N011/N012`、`N013/N014`	热门题材及对应数量

limit_up_count 是服务端汇总口径，不能保证等于 rows 中 ztlb=1 的行数；两者应分别使用，不要互相覆盖。

示例：按状态和板位筛选¶

result = client.f10.limit_up_down_list("20260904", include_summary=True)

limit_up = [row for row in result.rows if row.status == "limit_up"]
broken = [row for row in result.rows if row.status == "broken"]
limit_down = [row for row in result.rows if row.status == "limit_down"]

# 仅涨停股按板位、封单额排序
limit_up.sort(
    key=lambda row: (
        -(row.board_level or 0),
        -(row.seal_amount or 0),
    )
)

print(len(limit_up), len(broken), len(limit_down))
print(result.ladder_counts_by_date)

与实时 Helper 的选择¶

需求	推荐入口
盘中查看当前封板、连板高度和实时封单	`client.helpers.limit_ladder()`
查询某个日期的 7615 涨跌停明细	`client.f10.limit_up_down_list()`
查询日期范围并按日期统计梯队	`client.f10.limit_up_down_list(start, end)`
同时读取市场涨跌家数和成交额	`client.f10.limit_up_down_list(..., include_summary=True)`