Vibe-Trading 数据工程实战东方财富概念板块成分接口 dc_member 从调用到量化建模【免费下载链接】Vibe-TradingVibe-Trading: Your Personal Trading Agent项目地址: https://gitcode.com/GitHub_Trending/vi/Vibe-Trading本文以 Vibe-Trading 仓库内置的 Tushare 数据技能文档agent/src/skills/tushare/references/股票数据/打板专题数据/东方财富概念成分.md为骨架系统讲解东方财富East Money概念板块每日成分数据接口dc_member的权限要求、输入输出参数、调用方式与批量拉取策略并结合仓库中同一打板专题数据目录下的配套接口dc_index、dc_daily、limit_cpt_list等展示其在概念轮动跟踪、成分漂移监控与 Alpha 因子构建中的落地方法。读完本文你将能独立完成 Tushare 环境配置并用dc_member拉取任意概念板块任意交易日的全量成分股清单。一、接口概览dc_member 是什么dc_member是 Tushare 提供的东方财富板块每日成分数据接口其官方描述为获取东方财富板块每日成分数据可以根据概念板块代码和交易日期获取历史成分。核心特性归纳如下与文档一致并补充使用要点项目说明接口名dc_member数据来源东方财富板块体系概念板块、行业板块等核心能力按概念板块代码 交易日期查询历史成分支持成分股代码反向查询单次限量最大 5000 条可通过日期和代码循环获取全量权限门槛用户积累 6000 积分方可调取使用限制仅限个人学习和研究使用商业用途需自行联系东方财富解决数据采购问题需要特别说明的是dc_member返回的是某一天该概念板块包含哪些成分股的快照式数据——由于概念板块成分会随公司业务、政策、市场热点动态调整同一板块在不同交易日的成分清单并不相同这正是历史成分四个字的价值所在。这也是它与指数成分index_weight月度更新最大的区别dc_member可以逐日还原板块成分变化为研究概念纳入/剔除个股这类事件提供高频证据。在 Vibe-Trading 仓库中该文档位于 agent/src/skills/tushare/references/股票数据/打板专题数据/ 目录下属于打板专题数据子类与涨停、连板、游资等题材数据并列说明其典型用途是服务短线题材与打板研究。二、使用前提环境配置与积分权限调用dc_member前需要完成两项准备。2.1 安装 Tushare 并配置 Token根据技能文档 agent/src/skills/tushare/SKILL.md 的快速上手说明配置流程为# 安装 tushare推荐从清华 PyPI 镜像安装 pip install tushare -i https://pypi.tuna.tsinghua.edu.cn/simple # 配置 token 环境变量 export TUSHARE_TOKENyour_token仓库示例脚本 agent/src/skills/tushare/scripts/stock_data_example.py 给出了 token 获取与 pro 接口初始化的标准写法import os import tushare as ts # 优先读取环境变量中的 token其次读取本地记录的 token token os.getenv(TUSHARE_TOKEN) or ts.get_token() # 初始化 pro 接口实例 pro ts.pro_api(token)脚本中还展示了仓库自带的配置访问方式get_env_config().data.tushare_token说明 Vibe-Trading 已将 Tushare token 纳入统一的配置管理体系读者可按项目约定把 token 写入环境配置。2.2 积分门槛6000 积分dc_member要求用户积累 6000 积分方可调取积分获取办法可参考 Tushare 官方积分文档。需要注意dc_member的积分门槛与打板专题数据中的多个东财系接口一致例如dc_index东方财富概念板块6000 积分单次最大 5000 条dc_daily东财概念和行业指数行情6000 积分单次最大 2000 条而limit_cpt_list涨停最强板块统计则要求 8000 积分。因此若积分尚未达标可先积累积分再使用该系列接口。2.3 参数格式约定按技能文档约定本系列接口统一遵循日期格式YYYYMMDD如20250102股票代码ts_code格式如000001.SZ、600000.SH东方财富板块代码BKxxxx.DC格式如BK1184.DC返回格式pandas DataFrame。三、输入参数详解dc_member共支持三个输入参数全部为可选可自由组合名称类型必选描述ts_codestrN板块指数代码con_codestrN成分股票代码trade_datestrN交易日期YYYYMMDD 格式组合查询能力解读ts_codetrade_date查询某概念板块在某交易日的全部成分股这是最常用的组合con_codetrade_date反向查询某只股票在某交易日的所属概念板块可用于还原个股的题材归属历史只传trade_date获取全市场当天全部板块的成分明细注意 5000 条限量需循环补齐只传ts_code获取该板块全部历史成分快照。板块代码ts_code从哪里来通过配套接口dc_index东方财富概念板块获取。该接口的输入参数支持按名称反查代码例如查询人形机器人板块df_index pro.dc_index(trade_date20250103, fieldsts_code,name,turnover_rate,up_num,down_num)其输出中包含ts_code、name、leading、pct_change、total_mv、turnover_rate、up_num、down_num、idx_type、level等字段其中idx_type板块类型行业板块、概念板块、地域板块为必传项。数据示例中的BK1184.DC即人形机器人概念板块的代码这一代码可直接作为dc_member的ts_code入参。四、输出参数详解dc_member返回四列字段全部默认显示名称类型默认显示描述trade_datestrY交易日期ts_codestrY概念代码con_codestrY成分代码namestrY成分股名称字段间关系为trade_date标识成分快照所属交易日ts_code标识概念板块con_code标识成分股name给出成分股中文名称。该表结构非常精简便于与其他行情表如daily日线、daily_basic每日指标以con_code为键做 join 扩展构建成分 × 行情 × 财务的宽表。五、接口示例与数据解读文档给出的官方示例为获取东方财富 2025 年 1 月 2 日人形机器人概念板块成分列表# 获取东方财富2025年1月2日的人形机器人概念板块成分列表 df pro.dc_member(trade_date20250102, ts_codeBK1184.DC)执行后返回的 DataFrame 结构如下文档数据示例共 64 行trade_date ts_code con_code name 0 20250102 BK1184.DC 002117.SZ 东港股份 1 20250102 BK1184.DC 603662.SH 柯力传感 2 20250102 BK1184.DC 688165.SH 埃夫特-U 3 20250102 BK1184.DC 300660.SZ 江苏雷利 4 20250102 BK1184.DC 873593.BJ 鼎智科技 .. ... ... ... ... 59 20250102 BK1184.DC 002139.SZ 拓邦股份 60 20250102 BK1184.DC 301236.SZ 软通动力 61 20250102 BK1184.DC 601727.SH 上海电气 62 20250102 BK1184.DC 300432.SZ 富临精工 63 20250102 BK1184.DC 300843.SZ 胜蓝股份从数据示例中可以观察到几个值得在建模中注意的细节代码后缀覆盖多市场con_code中包含.SZ深市、.SH沪市与.BJ北交所三种后缀说明概念板块成分并不局限于沪深主板北交所个股也会被纳入名称后缀埃夫特-U 这类带特殊标记的名称是公司本身的证券简称直接以字符串返回无需额外清洗即可用于展示行数规模当日该板块约 60 只成分股远低于单次 5000 条的上限说明单板块单日查询不会触限5000 条上限主要约束的是多板块 × 多日期的全量拉取场景。六、批量拉取策略突破 5000 条限量当需要拉取全市场全部板块在某日的成分或某个板块的长历史成分时单次 5000 条的限制会生效需要按日期与代码循环获取。仓库中的技能文档明确写有可以通过日期和代码循环获取的说明这是官方认可的标准做法。推荐的分页循环策略如下以拉取一段时间内某板块的历史成分为例import tushare as ts import pandas as pd pro ts.pro_api() # 实际使用时传入 token def fetch_member_history(ts_code, start_date, end_date, trade_cal): 按交易日循环拉取某概念板块的历史成分。 trade_cal: 交易日历 DataFrame可来自 pro.trade_cal frames [] # 仅遍历交易日避免非交易日请求浪费配额 for day in trade_cal[trade_cal[is_open] 1][cal_date]: if day start_date or day end_date: continue try: df pro.dc_member(ts_codets_code, trade_dateday) frames.append(df) except Exception as e: print(f{day} 获取失败: {e}) return pd.concat(frames, ignore_indexTrue)实现要点用交易日历过滤非交易日Tushare 的trade_cal接口文档见 agent/src/skills/tushare/references/股票数据/基础数据/交易日历.md提供is_open字段跳过非交易日可显著减少无效请求异常兜底网络波动或积分限制可能导致单日请求失败应捕获异常并记录失败的日期便于重试增量更新对于需要持续跟踪的场景可只对上次拉取日期之后的交易日发起请求节省积分配额。七、与打板专题接口联动构建概念轮动研究链路dc_member单独使用时提供的是静态的成分快照但将它与同目录下的配套接口串联可以构建出完整的题材研究数据链路。以下组合均能在 agent/src/skills/tushare/references/股票数据/打板专题数据/ 目录中找到对应文档7.1 板块列表 → 板块行情dc_indexdc_daily东方财富概念板块.mddc_index获取每日概念板块的领涨股、涨跌幅、总市值、换手率、上涨/下跌家数等截面数据用于筛选当日强势板块东财概念和行业指数行情.mddc_daily获取板块指数的 OHLC 行情历史数据始于 2020 年字段含close、pct_change、vol、amount、swing、turnover_rate等用于板块层面的时序分析。典型用法先用dc_index(trade_date20250103)找出换手率最高、上涨家数远大于下跌家数的热点概念如人形机器人BK1184.DC再用dc_member取该板块当日成分股最后用dc_daily对板块指数做回测。7.2 涨停强度视角limit_cpt_list涨停最强板块统计.mdlimit_cpt_list需 8000 积分提供每天涨停股票最多、最强的概念板块字段含up_stat连板高度、cons_nums连板家数、up_nums涨停家数、rank板块热点排名等。它与dc_member互补limit_cpt_list回答今天哪个题材最热dc_member回答这个题材具体包含哪些股票。7.3 跨数据源对照ths_member同花顺同目录下的 同花顺行业概念成分.mdths_member提供同花顺概念板块成分代码为885xxx.TI格式。东方财富与同花顺对概念板块的划分口径并不一致将两者的成分并集/交集对照可以识别出多数据源共同认可的题材核心股也可用于验证单一数据源的板块归属是否稳健。注意同花顺数据版权归同花顺所有商业使用需另行联系。八、实战场景成分数据在量化建模中的应用基于dc_member的历史成分特性至少有三类可直接落地的量化应用1. 概念轮动强度跟踪。将dc_member与dc_daily板块指数、daily个股日线文档见 agent/src/skills/tushare/references/股票数据/行情数据/历史日线.md结合按日计算板块成分股的平均涨幅、涨停家数占比构建题材热度因子用于轮动择时。2. 成分漂移Concept Membership Drift事件研究。由于dc_member保留历史成分可逐日对比前后两天同一板块的成分集合识别新纳入与被剔除个股进而统计个股被纳入热门概念后 N 日的超额收益这属于事件驱动因子的一种且数据口径完全可回溯、无幸存者偏差。3. 题材重叠度与多概念覆盖。用con_code反向查询dc_member(con_code..., trade_date...)构建个股 × 所属概念矩阵计算个股同时覆盖的概念数量题材多重属性可用于拥挤度与炒作持续性分析。九、注意事项与合规边界积分与限流6000 积分门槛、单次 5000 条限量是硬约束批量任务务必按日期 代码分片循环并配合交易日历跳过非交易日版权声明文档明确注明本接口只限个人学习和研究使用如需商业用途请自行联系东方财富解决数据采购问题量化产品若涉及商用须自行完成数据授权数据时效概念成分按交易日更新复盘历史时务必使用与交易日对齐的快照不要用最新成分代替历史成分否则会产生严重的生存偏差代码格式东方财富板块代码统一为BKxxxx.DC成分股代码为含交易所后缀的ts_code格式字段拼接时注意保持con_code与日线表ts_code的一致性。十、小结dc_member是 A 股题材研究与打板量化中板块 → 个股映射的关键一环它用 3 个入参、4 个出参的极简结构提供了可精确到交易日的历史概念成分数据。结合 Vibe-Trading 仓库中 agent/src/skills/tushare/references/股票数据/打板专题数据/ 目录下的dc_index、dc_daily、limit_cpt_list等配套接口即可搭建从热点板块发现 → 成分股提取 → 行情验证 → 事件因子构建的完整研究流水线。写作时请牢记其 6000 积分权限、5000 条单次限量与个人研究用途限制并在建模中始终使用与交易日对齐的历史成分快照。【免费下载链接】Vibe-TradingVibe-Trading: Your Personal Trading Agent项目地址: https://gitcode.com/GitHub_Trending/vi/Vibe-Trading创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
