Vibe-Trading 实战基于 Tushare kpl_list 接口的开盘啦打板榜单数据量化研究指南【免费下载链接】Vibe-TradingVibe-Trading: Your Personal Trading Agent项目地址: https://gitcode.com/GitHub_Trending/vi/Vibe-Trading开盘啦KPL榜单数据是短线打板研究的核心数据源之一。本指南以 Vibe-Trading 仓库内收录的 Tushare 打板专题接口文档为骨架系统讲解kpl_list接口的限量与权限规则、全部输入/输出参数语义、实战调用范式与历史数据循环抓取方案并结合仓库源码说明 Token 配置与数据源接入方式。读完本文你将能在自己的量化研究环境中稳定、合规地拉取 A 股每日涨停、跌停、炸板、竞价等榜单快照并落地为连板梯队、板块归因与资金强度分析。一、接口概览开盘啦榜单数据能做什么kpl_list是 Tushare 数据源在股票数据-打板专题数据分类下提供的接口接口 ID 347见 Tushare 技能文档 的数据接口列表其数据由知名打板 App开盘啦整理并授权提供。该接口的核心能力是按交易日返回全市场涨停、跌停、炸板、自然涨停、竞价等维度的榜单明细并附带每个标的的涨停时间、封单、竞价成交、主力净额、所属板块theme、涨停原因lu_desc、连板状态等打板研究必需的字段。与同专题的其他接口相比kpl_list的特点是字段粒度最细、信息密度最高它给出了涨停/跌停/开板的发生时间lu_time/ld_time/open_time/last_time可以还原当天个股的封板—炸板—回封过程它给出竞价阶段数据bid_amount竞价成交额、bid_change竞价净额、bid_turnover竞价换手、bid_pct_chg竞价涨幅可用于开盘前的集合竞价强弱预判它给出封单质量指标lu_bid_vol涨停委买额、limit_order封单、lu_limit_order最大封单它给出资金与流通盘信息net_change主力净额、free_float实际流通、amount成交额、turnover_rate换手率它直接给出板块归属与上涨原因theme、lu_desc是板块轮动归因的一手素材。数据更新时效当日数据在次日 8:30入库因此该接口适合做次日盘前的研究复盘与策略信号刷新不适合盘中实时盯盘实时场景可搭配同专题的 开盘竞价成交(当日).md) 等接口。合规提示文档明确注明开盘啦是一个专业的打板 App本接口仅限用于量化研究如需商业用途请自行联系开盘啦官方。二、权限与限量规则调用前必须了解的硬约束在使用kpl_list之前需要先明确 Tushare 积分体系下的调用额度原文档限量/积分章节项目规则单次最大返回8000 条数据历史数据获取可根据交易日期循环获取按日分页即可覆盖全历史5000 积分档每分钟 200 次请求每天总量 1 万次8000 积分及以上档每分钟 500 次请求每天总量不限制积分获取办法详见 Tushare 官方积分文档本文不展开外部链接实际操作时以官方最新规则为准。由此可以推导出两个重要的工程约束单日榜单通常远小于 8000 条从下方数据样例看2024-09-27 当天tag涨停的榜单约 131 行即使全市场涨停日通常数百只也不会突破单次上限因此按trade_date单日拉取即可覆盖一个完整交易日“按日期循环”是拉全历史的唯一可靠方式若需要多年历史应遍历交易日历可参考同分类下 交易日历 接口逐日调用同时注意在 5000 积分档下控制每日总调用量不超过 1 万次并为每次调用设置合理间隔以避免触发分钟级限频。三、环境准备Token 配置与 Tushare 客户端初始化在 Vibe-Trading 仓库中Tushare 被作为 A 股行情与专题数据的标准化数据源接入。Token 通过环境变量TUSHARE_TOKEN声明定义位置在 agent/src/config/env_schema.pytushare_token: str Field(aliasTUSHARE_TOKEN, default)即在 Vibe-Trading 的配置体系中只需设置环境变量TUSHARE_TOKEN即可被数据访问层读取并注入 Tushare 客户端。配置方式export TUSHARE_TOKENyour_token仓库自带的示例脚本 agent/src/skills/tushare/scripts/stock_data_example.py 给出了客户端初始化的标准姿势——优先读取 Vibe-Trading 配置中的 Token回退到 Tushare 本地缓存 Tokenimport tushare as ts from src.config.accessor import get_env_config token get_env_config().data.tushare_token or ts.get_token() pro ts.pro_api(token)独立于 Vibe-Trading 环境时最简单的初始化方式是pip install tushare # 推荐 Python 3.7可用清华 PyPI 镜像加速import tushare as ts pro ts.pro_api() # 会读取 ~/.tushare/token 或环境变量中的 tokenTushare 的数据返回统一为pandas DataFrame日期参数统一使用YYYYMMDD格式如20240927股票代码使用ts_code格式如000762.SZ、600801.SH这是所有接口调用的通用约定。四、输入参数详解五种榜单维度的组合查询kpl_list共支持 5 个输入参数全部为可选参数通过自由组合实现不同粒度的查询。名称类型必选描述ts_codestrN股票代码如000762.SZtrade_datestrN交易日期YYYYMMDDtagstrN板单类型取值涨停 / 炸板 / 跌停 / 自然涨停 / 竞价默认为涨停start_datestrN开始日期end_datestrN结束日期tag参数的语义是理解本接口的关键涨停当日封住涨停的股票榜单默认值跌停当日封住跌停的股票榜单炸板盘中曾涨停但收盘未封住或盘中反复开板的股票自然涨停剔除一字板后的自然换手涨停通常不含开盘即一字涨停的品种用于筛选有真实资金博弈的标的竞价集合竞价阶段表现特殊的股票竞价涨停/竞价异动等。参数组合的典型用法查询目标参数写法查询某一天全部涨停股trade_date20240927tag 缺省即涨停查询某一天全部炸板股trade_date20240927, tag炸板查询某一天全部跌停股trade_date20240927, tag跌停查询某一只股票的历史上榜记录ts_code000762.SZ, start_date..., end_date...查询某区间内所有涨停含起始日start_date20240901, end_date20240927, tag涨停注意tag的取值是中文语义标签而非代码这在批量脚本中需要硬编码为上述五选一同时由于接口是快照型数据start_date/end_date区间查询本质上是多日榜单的合并结果实际使用中更推荐按日循环 本地合并的模式便于控制单次返回规模与请求频率。五、输出参数详解22 个字段的量化学含义kpl_list单条记录包含 22 个字段覆盖了谁、何时、以何种方式、多少资金、什么板块、什么逻辑上榜的完整信息。全部字段默认显示默认显示 Y名称类型描述量化解读ts_codestr代码股票唯一标识格式如000762.SZnamestr名称股票名称trade_datestr交易时间榜单所属交易日YYYYMMDDlu_timestr涨停时间当日首次涨停的时间点越早说明越强势ld_timestr跌停时间跌停发生时间跌停/炸板榜中有效open_timestr开板时间炸板开板的时间点last_timestr最后涨停时间最后一次回封涨停的时间配合lu_time可还原封板过程lu_descstr涨停原因开盘啦归纳的上涨驱动逻辑是题材归因的基础tagstr标签/类别本条记录所属榜单类型themestr板块所属概念/题材板块如“锂矿、盐湖提锂”net_changefloat主力净额(元)主力资金净流入衡量资金真实做多力度bid_amountfloat竞价成交额(元)集合竞价阶段的成交金额体现竞价人气statusstr状态N连板如“首板”“2连板”直接刻画高度bid_changefloat竞价净额竞价阶段资金净买卖差额bid_turnoverfloat竞价换手%竞价成交量占流通盘比例反映抢筹热度lu_bid_volfloat涨停委买额涨停价位未成交买盘挂单金额涨停意愿pct_chgfloat涨跌幅%当日涨跌幅bid_pct_chgfloat竞价涨幅%竞价结束时的涨幅高开幅度的直接度量rt_pct_chgfloat实时涨幅%数据生成时点的实时涨幅limit_orderfloat封单收盘/当前时刻的封单金额amountfloat成交额当日总成交额turnover_ratefloat换手率%当日换手与流通盘配合刻画筹码交换free_floatfloat实际流通实际流通股本/市值判断盘子大小lu_limit_orderfloat最大封单当日涨停期间的最大封单金额代表资金封板的最大决心字段组合的使用建议判断涨停强度对比lu_time越早越强lu_limit_order最大封单越大越稳open_time是否为空无开板说明一字未破或封死判断炸板风险open_time非空 limit_order骤降的组合说明盘中反复开板次日溢价预期通常偏弱判断竞价情绪bid_pct_chg竞价涨幅、bid_turnover竞价换手、bid_amount竞价成交额三字段组合是开盘情绪温度计判断资金真实性net_change主力净额与bid_change竞价净额为正且放大通常意味着有真实资金承接而非单纯情绪脉冲判断题材属性themelu_desc是板块内部分层与龙头识别的输入可与同专题的 题材成分(开盘啦).md) 接口kpl_concept_cons联动展开题材成分股明细。六、接口调用实战从单日快照到全历史6.1 基础调用拉取单日涨停榜单原文档给出的标准用法如下import tushare as ts pro ts.pro_api() df pro.kpl_list(trade_date20240927, tag涨停, fieldsts_code,name,trade_date,tag,theme,status) print(df)trade_date20240927锁定交易日tag涨停明确榜单类型fields参数用于裁剪返回列减少传输与内存开销——这是高频调用的最佳实践。执行后得到的数据样例原文档实测输出2024-09-27 部分涨停榜ts_code name trade_date tag theme status 0 000762.SZ 西藏矿业 20240927 涨停 锂矿、盐湖提锂 首板 1 300399.SZ 天利科技 20240927 涨停 互联网金融、金融概念 首板 2 002673.SZ 西部证券 20240927 涨停 证券、控参股基金 首板 3 002050.SZ 三花智控 20240927 涨停 汽车热管理、比亚迪产业链 首板 4 600801.SH 华新水泥 20240927 涨停 水泥、地产链 首板 .. ... ... ... ... ... ... 126 600696.SH 岩石股份 20240927 涨停 白酒、酿酒 2连板 127 600606.SH 绿地控股 20240927 涨停 房地产、地产链 2连板 128 000882.SZ 华联股份 20240927 涨停 零售、互联网金融 2连板 129 000069.SZ 华侨城 20240927 涨停 房地产、地产链 2连板 130 002570.SZ 贝因美 20240927 涨停 多胎概念、乳业 首板从样例中可以直观读出当天涨停股集中在锂矿/盐湖提锂、互联网金融、证券、地产链等方向且仅少数个股晋级 2 连板status字段这正是判断当日主线板块和高度梯队的第一手截面。6.2 分 tag 遍历一次拉取全部榜单维度涨停、跌停、炸板、自然涨停、竞价是五个互斥视图分别调用即可获得当日完整的多空全景pro ts.pro_api() date 20240927 for tag in [涨停, 炸板, 跌停, 自然涨停, 竞价]: df pro.kpl_list(trade_datedate, tagtag) print(f[{tag}] {len(df)} 条) # 本地落盘df.to_csv(fkpl_{date}_{tag}.csv, indexFalse)6.3 按日期循环拉取全历史榜单由于单次最多返回 8000 条、且历史数据支持按日期循环完整的全历史回补脚本框架如下实际运行时建议加入限速与断点续传import time import tushare as ts pro ts.pro_api() def fetch_kpl_history(trade_dates, tag涨停, sleep0.3): trade_dates: 交易日列表可用 trade_cal 接口生成 frames [] for d in trade_dates: try: df pro.kpl_list(trade_dated, tagtag) frames.append(df) time.sleep(sleep) # 控制请求频率避免触及分钟级限额 except Exception as e: print(f{d} 拉取失败: {e}) return __import__(pandas).concat(frames, ignore_indexTrue)交易日列表可由 交易日历trade_cal接口生成从而精确遍历 A 股实际交易日避免对非交易日发起无效请求。6.4 个股视角追踪特定标的的上榜历史通过ts_code可以反查某只股票历史上所有上榜记录用于验证“该股历史上封板后的次日表现”等事件研究df pro.kpl_list(ts_code000762.SZ, start_date20240101, end_date20241231, fieldstrade_date,tag,status,lu_time,lu_desc,theme,net_change)七、在 Vibe-Trading 中接入与联动的策略视角kpl_list在 Vibe-Trading 的 Tushare 技能体系中与打板专题的其他接口构成一个完整的短线研究数据族合理联动可以覆盖“榜单—梯队—板块—资金—游资”的全链路研究环节推荐接口对应文档每日涨跌停/炸板基础统计含行业、封单金额、炸板次数、涨停统计limit_list_d涨跌停和炸板数据连板晋级梯队每日各连板高度的个股清单limit_step涨停股票连板天梯题材成分股展开开盘啦概念 → 成分股kpl_concept_cons题材成分(开盘啦).md)游资席位/名录主力身份识别hm_list、hm_detail同目录下市场游资最全名录、游资交易每日明细龙虎榜机构/营业部明细top_list、top_inst同目录下龙虎榜相关文档从仓库源码结构看Vibe-Trading 将 Tushare 作为 A 股数据链路的默认数据源之一见 agent/src/market_data.py 中的数据源路由注释与 agent/src/config/env_schema.py 中MARKET_DATA_ORDER_A_SHARE的源优先级配置因此kpl_list这类专题数据既可以在独立的 Python 脚本中直接调用也可以作为 Agent 调用的数据技能被注入研究流程——技能目录本身agent/src/skills/tushare就是 Tushare 全部接口索引的可检索知识库。八、注意事项与最佳实践小结权限与合规本接口仅限量化研究用途商用请联系开盘啦官方数据版权归开盘啦所有。更新时效当日数据次日 8:30 更新请勿在盘中期冀获取当日完整榜单盘前复盘脚本建议安排在 8:30 之后触发。限量管理单次 8000 条上限对单日榜单足够全历史必须按交易日循环5000 积分档需控制每日 1 万次总量与每分钟 200 次频率脚本中务必加入sleep。tag语义五种标签互斥且区分严格涨停/跌停/炸板/自然涨停/竞价构建指标库时注意不要把“自然涨停”混入“涨停”口径。字段口径net_change主力净额、bid_amount竞价成交额单位均为元pct_chg、turnover_rate、bid_turnover、bid_pct_chg均为百分比入库前建议统一单位换算并记录口径避免下游因子计算错误。联动扩展榜单数据与 涨跌停和炸板数据、涨停股票连板天梯 等接口结合使用可构建从单日截面到历史序列的完整打板研究数据集。【免费下载链接】Vibe-TradingVibe-Trading: Your Personal Trading Agent项目地址: https://gitcode.com/GitHub_Trending/vi/Vibe-Trading创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考