Vibe-Trading 打板数据实战Tushare 同花顺涨跌停榜单limit_list_ths接口完整指南【免费下载链接】Vibe-TradingVibe-Trading: Your Personal Trading Agent项目地址: https://gitcode.com/GitHub_Trending/vi/Vibe-Trading本指南以 Tushare 打板专题数据中的同花顺涨跌停榜单接口limit_list_ths为核心系统讲解其数据特性、六个输入参数与二十二个输出字段的完整语义、Python 调用方式与分页循环提取技巧并结合 Vibe-Trading 仓库内tushare技能文档与工具封装源码说明如何在个人量化与打板策略研究场景中落地这一数据源。读完本文你将掌握用limit_list_ths拉取每日涨停池、连板池、炸板池、跌停池数据并基于涨停原因lu_desc、涨停状态status、封单量等字段构建强势股追踪与情绪面分析的基础数据管线。一、接口概览数据从哪来、何时更新limit_list_ths是 Tushare 数据平台中同花顺源涨跌停榜单接口属于股票数据 打板专题数据分类。在 agent/src/skills/tushare/SKILL.md 中登记编号为 355其文档定义位于 agent/src/skills/tushare/references/股票数据/打板专题数据/同花顺涨跌停榜单.md。该接口的核心事实如下项目说明接口名limit_list_ths数据来源同花顺THS每日涨跌停榜单历史起点2023 年 11 月 1 日20231101起提供更新节奏增量数据每个交易日 16 点左右更新单次限量最大 4000 条循环提取支持按日期trade_date/start_date/end_date或股票代码ts_code循环提取全部历史积分要求8000 积分以上每分钟可请求 500 次每天总量不限积分获取办法请参阅 Tushare 官网积分说明文档使用范围仅限个人学习和研究使用如需商业用途须自行联系同花顺解决数据采购问题值得注意的是该接口与同目录下的其他打板数据形成互补东财源的 涨跌停和炸板数据limit_list_d 从 2020 年开始且不提供 ST 股票统计而同花顺源的limit_list_ths从 2023 年 11 月开始两者在历史深度与字段侧重上各有取舍实际研究中可按需选择或交叉验证。二、环境准备与 Pro 接口初始化调用该接口前需要完成 Tushare 环境初始化。依据 agent/src/skills/tushare/SKILL.md 中的快速上手说明安装 Python推荐 3.7与 tushare 依赖包推荐使用清华 PyPI 镜像加速pip install tushare -i https://pypi.tuna.tsinghua.edu.cn/simple在 Tushare 官网注册账号并获取 token配置环境变量export TUSHARE_TOKENyour_token初始化 Pro 接口并调用import os import tushare as ts token os.getenv(TUSHARE_TOKEN) or ts.get_token() pro ts.pro_api(token)参数格式约定日期统一使用YYYYMMDD字符串格式如20241125股票代码使用ts_code格式带交易所后缀如000001.SZ、600000.SH返回格式pandas DataFrame。这一封装模式在 Vibe-Trading 仓库的 agent/src/tools/tushare_fallbacks.py 中也有对应实现_pro_api()函数从配置或环境读取 token 后调用ts.pro_api(token)返回 Pro 实例并且通过_compact_date()将输入的日期统一压缩为YYYYMMDD形式后再传给 Tushare 接口这恰好与本文档要求的日期格式约定一致。三、输入参数详解limit_list_ths共支持六个输入参数均为可选N。完整清单如下名称类型必选描述trade_datestrN交易日期ts_codestrN股票代码limit_typestrN涨停池、连板池、冲刺涨停、炸板池、跌停池默认涨停池marketstrNHS-沪深主板、GEM-创业板、STAR-科创板start_datestrN开始日期end_datestrN结束日期参数使用要点limit_type是数据切分的核心维度支持五种池子涨停池、连板池、冲刺涨停、炸板池、跌停池。不传该参数时默认返回涨停池数据。实战中通常按池子分别拉取再按trade_date与ts_code做横向拼接即可还原当日完整的涨跌停情绪全景。market用于板块过滤HS沪深主板、GEM创业板、STAR科创板。注意该参数不含北交所研究北交所标的时应结合其他数据源。日期区间与单日查询二选一既可以用trade_date指定单日也可以用start_dateend_date拉取一段区间配合单次 4000 条上限可按日期逐日循环提取全量历史。四、输出参数详解接口返回的 DataFrame 包含二十二个字段其中十七个默认显示Y五个需显式指定字段名获取N名称类型默认显示描述trade_datestrY交易日期ts_codestrY股票代码namestrY股票名称pricefloatY收盘价元pct_chgfloatY涨跌幅%open_numintY打开次数lu_descstrY涨停原因limit_typestrY板单类别tagstrY涨停标签statusstrY涨停状态N连板、一字板first_lu_timestrN首次涨停时间last_lu_timestrN最后涨停时间first_ld_timestrN首次跌停时间last_ld_timestrN最后跌停时间limit_orderfloatY封单量元|个limit_amountfloatY封单额元|个turnover_ratefloatY换手率%free_floatfloatY实际流通元|个lu_limit_orderfloatY最大封单元|个limit_up_suc_ratefloatY近一年涨停封板率turnoverfloatY成交额rise_ratefloatN涨速sum_floatfloatN总市值亿元market_typestrY股票类型HS沪深主板、GEM创业板、STAR科创板关键字段的业务含义lu_desc涨停原因接口最具研究价值的字段之一直接给出当日该股涨停所对应的题材/逻辑标签例如样例中的服装家纺电商精密结构件华为光伏一体化压铸。这是做题材归类、热点主线聚类的重要原始素材可配合同目录 涨停最强板块统计limit_cpt_list 的板块上榜天数、涨停家数、连板家数做板块轮动验证。status涨停状态形如首板4天4板2天2板标识当日涨停强度与连板进阶配合一字板换手板T字板标签tag可区分封板质量。同一交易日同花顺源的连板状态可与 涨停股票连板天梯limit_step 返回的nums连板次数交叉核对。limit_order/limit_amount/lu_limit_order封单量与封单额衡量封板资金的体量与决心是判断强板/弱板的量化依据。open_num打开次数涨停打开的次数配合first_lu_time/last_lu_time时间窗口可还原炸板-回封过程rise_rate涨速则为尾盘异动监测提供参考。limit_up_suc_rate近一年涨停封板率历史封板成功率可用于对打板标的做一档历史风格画像。五个非默认字段first_lu_time、last_lu_time、first_ld_time、last_ld_time、rise_rate、sum_float需要显式在fields中声明才会返回调用时按需取舍避免拉取冗余字段增加传输负担。五、接口用法从基础调用到循环提取5.1 基础调用按文档给出的标准用法指定单日与涨停池只取核心字段pro ts.pro_api() df pro.limit_list_ths( trade_date20241125, limit_type涨停池, fieldsts_code,trade_date,tag,status,lu_desc )5.2 按日期区间循环提取全量受单次 4000 条上限约束建议按交易日逐日拉取并落盘保证数据完备import time import pandas as pd import tushare as ts pro ts.pro_api() def fetch_limit_list(start_date: str, end_date: str, limit_type: str 涨停池, fields: str trade_date,ts_code,name,price,pct_chg,open_num, lu_desc,limit_type,tag,status,limit_order, limit_amount,turnover_rate,free_float, lu_limit_order,limit_up_suc_rate,turnover,market_type): all_frames [] # 通过交易日历接口获取区间内的实际交易日避免对非交易日空请求 cal pro.trade_cal(exchangeSSE, start_datestart_date, end_dateend_date, is_open1) for trade_date in cal[cal_date].tolist(): df pro.limit_list_ths(trade_datetrade_date, limit_typelimit_type, fieldsfields) if df is not None and not df.empty: all_frames.append(df) print(f{trade_date} {limit_type}: {len(df)} 条) time.sleep(0.15) # 8000 积分下每分钟 500 次适当限速即可 return pd.concat(all_frames, ignore_indexTrue) if all_frames else pd.DataFrame()要点说明用交易日历驱动循环trade_cal接口见 agent/src/skills/tushare/references/股票数据/基础数据/交易日历.md可先拿到区间内全部开市日避免对节假日发出无效请求限速控制8000 积分档为每分钟 500 次单日逐日循环的请求量远低于该上限但建议在循环体内保留短暂sleep以防瞬时并发超限五种池子分别提取若需要完整情绪面板可在外层再套一层for limit_type in [涨停池, 连板池, 冲刺涨停, 炸板池, 跌停池]并在拼接时保留limit_type字段用于回溯。5.3 按股票代码追踪单标的当关注特定股票的连板历史时可用ts_code单查例如跟踪某只题材股自 2024 年以来的全部涨停记录df pro.limit_list_ths( ts_code002175.SZ, start_date20240101, end_date20241231, fieldstrade_date,ts_code,name,lu_desc,tag,status,limit_order )六、数据样例解读文档给出了 2024 年 11 月 25 日涨停池的部分真实样例共 154 条中的首尾若干行trade_date ts_code lu_desc tag status 0 20241125 603518.SH 服装家纺电商 首板 换手板 1 20241125 003036.SZ 高端纺织机械设备近年来收购了2家公司 4天4板 T字板 2 20241125 301268.SZ 精密结构件华为光伏一体化压铸 首板 换手板 3 20241125 603655.SH 橡胶汽车零部件间接供货特斯拉 2天2板 换手板 4 20241125 600119.SH 上海国资产业投资物流跨境电商 4天2板 换手板 .. ... ... ... ... ... 149 20241125 002348.SZ 固态电池玩具互联网教育 4天2板 一字板 150 20241125 002175.SZ “东方系”芯片智能制造物业管理 4天4板 一字板 151 20241125 002155.SZ 湖南万古金矿田探矿获重大突破 3天3板 一字板 152 20241125 002117.SZ 智能机器人拟向子公司增资AI应用 2天2板 一字板 153 20241125 002103.SZ IP产品广告营销跨境电商 7天5板 一字板从样例可以读出几类可量化信息题材聚类lu_desc通常由多个题材以连接如精密结构件华为光伏一体化压铸可拆分后做题材共现统计寻找当日市场最强主线连板梯度status覆盖从首板到7天5板的完整梯队结合tag换手板/T字板/一字板可区分加速板与分歧板一字板识别尾部数行为一字板说明涨停开盘即封死、全天无打开是情绪极端一致的表现配合open_num打开次数与first_lu_time可进一步验证。七、打板专题数据生态与相邻接口协同limit_list_ths并非孤立的接口在 agent/src/skills/tushare/references/股票数据/打板专题数据/ 目录下它与多个接口共同构成 A 股短线情绪研究的完整数据栈接口文档核心能力limit_list_ths同花顺涨跌停榜单.md每日涨停/连板/冲刺/炸板/跌停池含涨停原因、封单、封板率limit_step涨停股票连板天梯.md每日连板个数晋级股票支持nums连板次数多值过滤limit_cpt_list涨停最强板块统计.md涨停股票最多最强的概念板块含上榜天数、连板高度、板块排名limit_list_d涨跌停和炸板数据.md东财源涨跌停/炸板数据2020 年起无 ST 统计kpl_list榜单数据(开盘啦).md.md)开盘啦涨停/跌停/炸板榜单典型联动思路先用limit_cpt_list锁定当日最强板块与连板高度再用limit_list_ths的lu_desc与status逐股验证题材归属与封板质量最后用limit_step追踪连板晋级梯队形成板块 → 个股 → 梯队三层情绪分析框架。文档所在的 SKILL 技能页agent/src/skills/tushare/SKILL.md收录了全部 Tushare 数据接口索引便于按打板专题数据分类检索其他可协同的数据源。八、在 Vibe-Trading 仓库中的落地方式Vibe-Trading 仓库将 Tushare 作为其行情与衍生数据的重要提供方agent/src/tools/tushare_fallbacks.py 展示了项目中封装 Tushare Pro 接口的通用范式可作为集成limit_list_ths的参考骨架Token 管理_pro_api()见 agent/src/tools/tushare_fallbacks.py从配置/环境读取 token 后创建 Pro 实例与 SKILL.md 的初始化方式一致日期规范化_compact_date()见 agent/src/tools/tushare_fallbacks.py将各种日期输入统一压缩为YYYYMMDD与本接口的参数格式约定完全兼容结果转换_records()见 agent/src/tools/tushare_fallbacks.py将 Tushare 返回的 DataFrame 转为list[dict]记录便于上层工具统一输出降级容错模式以 agent/src/tools/dragon_tiger_tool.py 为代表仓库内的数据工具普遍采用主源失败 → tushare fallback的双源容错策略即在主数据源异常时自动切换 Tushare 接口兜底并携带告警信息。在 Agent 场景中本文档对应的 SKILL 技能通过 load_skill_tool 等机制加载使 Agent 在获取涨跌停/打板数据类需求下能够直接按文档参数与字段说明生成正确调用。基于lu_desc、status、limit_amount等字段Agent 还可以进一步完成题材热度归因、连板梯度排序、封单强度筛选等衍生分析。九、使用注意事项与最佳实践数据起始与更新时点历史数据自 20231101 起提供当日增量约在每天 16 点左右更新早于该时点请求当日数据可能为空建议在 16 点后再编排日度任务。单次上限与循环策略单次最大 4000 条量级足够覆盖单日全部涨停历史上单日涨停家数极少突破此上限但区间查询与多池查询仍建议按交易日逐日循环避免截断。字段按需声明五个非默认字段需显式写入fields不声明时仅返回 17 个默认字段可显著降低响应体量。版权与合规本接口数据版权归属同花顺仅限个人学习与研究使用商业用途须自行联系同花顺解决数据采购问题这是文档中明确标注的使用边界。板块参数覆盖范围market仅覆盖沪深主板HS、创业板GEM、科创板STAR不包含北交所标的做全市场情绪统计时需注意口径差异。与东财源交叉验证limit_list_ths同花顺源与limit_list_d东财源在历史起点、ST 覆盖、字段体系上存在差异对同一交易日的涨停名单做并集/差集分析可以暴露单源数据缺口提升数据可靠性。【免费下载链接】Vibe-TradingVibe-Trading: Your Personal Trading Agent项目地址: https://gitcode.com/GitHub_Trending/vi/Vibe-Trading创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考