Vibe-Trading 数据技能实战Tusharestk_account股票开户数据接口使用指南已停更数据的正确用法【免费下载链接】Vibe-TradingVibe-Trading: Your Personal Trading Agent项目地址: https://gitcode.com/GitHub_Trending/vi/Vibe-Trading本篇技术指南以 Vibe-Trading 仓库中 Tushare 数据技能tushare 技能目录自带的接口文档为核心完整讲解stk_account股票账户开户数据接口的输入输出字段、调用方式与数据口径限制并对照同目录的旧版接口stk_account_old讲清两代数据结构的差异。读完本文你将掌握如何在 Vibe-Trading 的 Tushare 技能体系中以 Python SDK 方式调取该接口、如何解析已停止更新数据的字段语义以及如何结合 SKILL.md 中的数据源技能规范复用这类参考数据接口。一、接口概览定位与状态stk_account是 Tushare 数据接口中位于股票数据 → 参考数据分类下的市场统计类接口接口 ID 为164。在 SKILL.md 数据接口列表 中它与同目录的旧版接口stk_account_oldID 165成对出现描述为获取股票账户开户数据统计周期为一周。使用该接口前必须明确三个关键事实统计周期为周接口输出按自然周聚合date字段即为该周统计周期而非日频数据官方已停止更新文档明确标注此数据官方已经停止更新意味着它只能用于历史研究、数据口径对比或回测验证不能作为实盘/近期数据的来源积分门槛 600 分需要 Tushare 账户积分达到 600 分才可调取具体积分获取办法以 Tushare 官方说明为准。二、环境准备在 Vibe-Trading 中配置 Tushare Token在调用任何 Tushare Pro 接口前需要先完成 token 配置。Vibe-Trading 中通过环境变量TUSHARE_TOKEN统一管理该凭据配置字段定义在 env_schema.pytushare_token: str Field(aliasTUSHARE_TOKEN, default)系统启动时preflight.py 中的_check_tushare()会校验该 token未设置或为占位值your-tushare-token时报告not_configured提示 TUSHARE_TOKEN not set (optional)未安装 tushare 包时报告skipped两者都会注明影响 A-share data unavailable技能自带脚本 stock_data_example.py 演示了标准取 token 姿势get_env_config().data.tushare_token or ts.get_token()即优先读取项目配置否则回退到 tushare 本地缓存的 token。配置完成后的最小调用骨架如下import tushare as ts pro ts.pro_api() # 或显式传入 token: ts.pro_api(token) df pro.stk_account(start_date20180101, end_date20181231) print(df.head())三、输入参数说明stk_account接口的输入参数非常精简全部为可选参数通过日期范围控制取数窗口名称类型必选描述datestrN日期精确到某一统计周start_datestrN开始日期end_datestrN结束日期使用要点日期统一采用YYYYMMDD字符串格式如20180101这是 SKILL.md 参数格式说明 中约定的通用日期规范三者均可省略。省略date而提供start_date/end_date即按区间批量取数只传date则精确取某一周返回格式为 pandasDataFrame与技能文档约定的通用返回格式一致。四、输出参数与字段语义接口返回 4 个字段全部默认显示。其中三个字段属于全市场总量口径单位均为万字段语义如下名称类型默认显示描述datestrY统计周期weekly_newfloatY本周新增万totalfloatY期末总账户数万weekly_holdfloatY本周持仓账户数万weekly_tradefloatY本周参与交易账户数万解读时需特别注意weekly_hold与weekly_trade会返回空值自 2017 年 2 月 10 日起中国证券登记结算公司已停止发布本周持仓账户数和本周交易账户数这两项指标因此数据样例中这两列为None。换言之越靠近停止更新日期附近的数据实际可用字段越少主要可分析的是weekly_new周新增开户数与total期末总账户数两个序列。数据示例以下是文档给出的 2018 年部分周度数据样例可直观看到字段空缺情况date weekly_new total weekly_hold weekly_trade 0 20181228 20.81 14650.44 None None 1 20181221 21.04 14629.63 None None 2 20181214 21.21 14608.59 None None 3 20181207 22.28 14587.38 None None 4 20181130 23.56 14565.10 None None 5 20181123 24.16 14541.54 None None 6 20181116 24.57 14517.38 None None 7 20181109 24.11 14492.81 None None 8 20181102 23.97 14468.70 None None 9 20181026 26.00 14444.73 None None 10 20181019 24.13 14418.73 None None 11 20181012 25.30 14394.60 None None 12 20180928 20.09 14369.30 None None 13 20180921 23.24 14349.21 None None 14 20180914 24.08 14325.97 None None 15 20180907 23.58 14301.89 None None 16 20180831 24.06 14278.31 None None 17 20180824 23.12 14254.25 None None 18 20180817 23.04 14231.12 None None 19 20180810 23.96 14208.09 None None 20 20180803 24.22 14184.12 None None从数据形态可以看出total呈单调递增账户总数持续累积weekly_new则在 20 万26 万万口径下的数值之间波动两者组合可以刻画A 股开户热度的周度节奏。五、新旧数据结构的差异stk_account_old文档明确指出2015 年 5 月 8 日之前的数据结构不同历史数据需改调旧版接口。Tushare 将旧版独立为stk_account_old接口ID 165对应文档为 股票开户数据(旧).md)覆盖 2008 年 1 月至 2015 年 5 月 29 日。两代接口的核心差异体现在输出维度上新接口按全市场总量聚合输出weekly_new万、total万等合并口径旧接口按沪深分所拆分输出上海、深圳各自的周新增单位户、期末有效账户万户、期末账户数万户、参与交易账户数万户例如new_sh/new_sz、active_sh/active_sz、total_sh/total_sz、trade_sh/trade_sz。旧版调用示例pro ts.pro_api() df pro.stk_account_old(start_date20140101, end_date20141231)旧版样例数据的日期列形态也不同统计周期直接以区间文本呈现如20141229~0102而非单一日期的周结束日date new_sh new_sz active_sh active_sz total_sh total_sz \ 0 20141229~0102 157871 152943 7187.12 7027.58 9269.40 9131.77 1 20141222~1226 279044 268562 7171.13 7011.97 9254.69 9117.34 ... trade_sh trade_sz 0 962.11 770.00 1 1262.57 1010.97因此做全历史开户数据研究时的正确姿势是按时间分两段取数2008—2015-05 用stk_account_old2015-05 之后至停更日用stk_account并在拼接时注意单位换算旧版新增为户、新版为万与字段名映射。六、调用后的数据处理建议结合该接口已停更 周频 字段缺失三大特性落地到 Vibe-Trading 的策略或研究中建议做如下处理空值清洗weekly_hold、weekly_trade在 2017-02-10 后全为None用df.dropna(axis1, howall)或显式只保留date、weekly_new、total三列日期解析将date周结束日解析为datetime并排序作为周度时间序列的索引口径标注若拼接新旧接口数据须在元数据中标注旧版为沪深分所口径、新版为总量口径避免跨口径直接计算衍生指标时效性兜底由于官方停更该接口只适合作为历史辅助数据例如回测区间为 2018—2020 年的市场情绪截面参考近期市场开户热度不应依赖此接口可改用 每日指标 daily_basic 等仍在更新的行情/指标类接口。七、在 Vibe-Trading 技能体系中的复用方式本文所讲解的文档位于 股票开户数据(停).md)是 Vibe-Trading 内置 Tushare 技能category:data-source的参考资料之一。该技能将 Tushare 上百个接口统一封装为SKILL.md references/ 分主题文档 scripts/ 示例脚本三层结构SKILL.md 提供技能概述、快速上手pip install tushare、export TUSHARE_TOKEN...与全量接口列表索引references/股票数据/参考数据/目录集中存放股东、质押、回购、解禁、开户等参考类数据的接口文档便于 Agent 或研究者按主题检索scripts/stock_data_example.py 提供可运行的取数范式含 token 读取、异常处理、head()预览可直接仿照其结构编写stk_account的批量拉取脚本。仓库层面Tushare 还被整合进项目的数据源链路例如 market_data.py 将 A 股数据源默认路由到tushareenv_schema.py 支持通过MARKET_DATA_ORDER_A_SHAREtushare,tencent,mootdx,...调整数据源优先级。这说明该技能文档对应的接口不仅是独立工具也是整个 Agent 行情/研究链路中的一环理解其数据口径对正确使用项目能力有实际意义。八、总结stk_account是 Tushare 中一个小、简、停的参考数据接口参数只有日期三件套输出只有四个字段但官方停更与字段缺失问题恰恰是使用这类历史参考数据时最需要警惕的坑。掌握它需要同时理解三点600 积分门槛与 token 配置对应 Vibe-Trading 的TUSHARE_TOKEN环境变量、周频统计与万单位的字段口径、以及 2017-02-10 起持仓/交易字段停止发布、2015-05-08 前需改用stk_account_old的结构分界。按本文提供的两段式取数与清洗方案即可安全地将这份已停更数据用于历史研究与回测场景。【免费下载链接】Vibe-TradingVibe-Trading: Your Personal Trading Agent项目地址: https://gitcode.com/GitHub_Trending/vi/Vibe-Trading创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
)
