Vibe-Trading 数据技能实战Tushare stock_hsgt 沪深港通股票列表接口深度解析与调用指南【免费下载链接】Vibe-TradingVibe-Trading: Your Personal Trading Agent项目地址: https://gitcode.com/GitHub_Trending/vi/Vibe-Trading沪深港通Stock Connect是外资通过北向通道买卖 A 股、内地资金通过南向通道买卖港股的跨境互联互通机制而标的池的准确名单是研究外资持仓、构建跨境策略的基础前提。本文以 Vibe-Trading 仓库中 Tushare 技能文档 沪深港通股票列表 为核心骨架结合仓库内环境配置、回退适配器与关联接口实现系统讲解stock_hsgt接口的权限门槛、入参约束、类型语义、分页循环策略与实战调用方式帮助读者在量化研究中快速获取沪股通、深股通、港股通的完整标的列表。一、沪深港通机制与标的列表的量化意义在进入接口细节之前先明确该数据在投资研究中的位置。Vibe-Trading 仓库中的 hk-connect-flow 技能文档 对沪深港通架构有清晰概括沪股通HK_SH/ 深股通HK_SZ北向通道外资买入上交所、深交所 A 股被普遍视为 A 股市场机构资金情绪的“聪明钱”指标港股通SH_HK / SZ_HK南向通道内地资金买入港股体现内地投资者对港股的配置偏好高股息、科技平台、AH 溢价套利。stock_hsgt接口提供的正是这四条通道各自的合格标的股票名单它是进一步计算北向/南向资金流moneyflow_hsgt、十大活跃成交股hsgt_top10、个股持股明细hk_hold等数据的“股票域universe”基础——只有先确定某只股票属于哪个通道的标的池才能合理解读其资金流数据的含义。二、接口速览权限、更新机制与数据起始日根据 沪深港通股票列表文档stock_hsgt接口的关键约束如下属性说明接口名stock_hsgtPython SDK 中通过pro.stock_hsgt(...)调用功能描述获取沪深港通股票列表权限要求3000 积分起数据更新每天上午9:20更新单次返回上限最大返回2000 行数据可根据类型循环提取数据起始日期从20250812开始两点实践要点值得注意积分门槛该接口需要 3000 积分属于中高权限接口。相比之下仓库中另一关联接口moneyflow_hsgt沪深港通资金流向文档仅需 2000 积分起而 5000 积分可获得每分钟 500 次的更高提取频率。在规划数据获取任务时应结合账号积分与接口权限做好取舍。每日更新时点9:20 更新意味着当日上午开盘前即可获取当日最新标的名单适合盘前构建当天的候选股票域。三、输入参数详解与类型语义接口输入参数如下摘自 沪深港通股票列表文档名称类型必选描述ts_codestrN股票代码trade_datestrN交易日期格式YYYYMMDDtypestrY类型见下表start_datestrN开始时间end_datestrN结束时间类型type参数是唯一必选参数其取值范围与语义如下类型类型名称通道方向HK_SZ深股通港深香港 → 深圳外资买深市 A 股SZ_HK港股通深港深圳 → 香港深市资金买港股HK_SH沪股通港沪香港 → 上海外资买沪市 A 股SH_HK港股通沪港上海 → 香港沪市资金买港股参数组合策略从源码/文档结构推断的推荐用法单日全量获取传trade_datetype即可得到该类型当日全部标的样例数据单次返回约 1000 行未超过 2000 行上限代码级过滤传ts_codetype查询单只股票当前是否属于某通道标的池历史区间回溯传start_date/end_datetype配合文档中“数据从 20250812 开始”的提示可观察标的池随时间的调整如被调入/调出通道的股票。需要特别说明由于type必选且单次请求最大返回 2000 行若某类型标的数量可能超过上限应采用“按类型 按日期循环提取”的方式分批拉取这与 沪深港通资金流向文档 中“每次最多返回 300 条记录总量不限制可按日期循环提取”的分页思路一致。四、输出字段说明接口返回的 DataFrame 包含以下字段名称类型默认显示描述ts_codestrY股票代码trade_datestrY交易日期typestrY类型namestrY股票名称type_namestrY类型名称其中type_name直接给出了“深股通(港深)”“港股通(深港)”等可读描述便于直接用于报表展示或 Agent 的自然语言输出无需再做类型码到中文名的映射。五、环境与鉴权在 Vibe-Trading 中配置 Tushare Token调用任何 Tushare 接口前都需要完成 token 鉴权。Vibe-Trading 仓库对 Tushare 凭据的管理方式是环境变量注入具体位于 环境变量模式定义tushare_token: str Field(aliasTUSHARE_TOKEN, default)即通过TUSHARE_TOKEN环境变量配置 token。安装并初始化方式可参考 Tushare 技能主文档pip install tushare -i https://pypi.tuna.tsinghua.edu.cn/simple export TUSHARE_TOKENyour_tokenimport os import tushare as ts # 读取环境变量中的 token, 或者读取本地记录的 token token os.getenv(TUSHARE_TOKEN) or ts.get_token() # 初始化 pro 接口实例 pro ts.pro_api(token)仓库中的 股票数据获取示例脚本 给出了更贴合本项目风格的初始化方式——通过配置访问器统一读取from src.config.accessor import get_env_config import tushare as ts token get_env_config().data.tushare_token or ts.get_token() pro ts.pro_api(token)值得一提的是仓库中的 Tushare 回退适配器 展示了 token 校验的健壮性实践它会把空字符串、your-tushare-token等占位值判定为“未配置”并抛出TushareFallbackUnavailable异常避免用无效凭据发起无意义的请求同时该文件中的_ts_code()函数给出了 Tushare 代码后缀的规范——5/6/9开头归SH、0/2/3开头归SZ、4/8开头归BJ理解这套规则有助于正确识别沪深港通名单中 A 股代码的归属市场。六、接口调用实战1. 基础调用获取单日某类型的标的列表沿用 沪深港通股票列表文档 中的官方示例获取 2025 年 8 月 13 日深股通外资买深市的股票列表import tushare as ts pro ts.pro_api() # 获取20250813日深股通的股票列表 df pro.stock_hsgt(trade_date20250813, typeHK_SZ) print(df)2. 循环提取覆盖全部四种类型由于type必选且单次有 2000 行上限完整的“沪深港通股票列表”应按类型循环拉取并合并import pandas as pd pro ts.pro_api() trade_date 20250813 types [HK_SZ, SZ_HK, HK_SH, SH_HK] frames [] for t in types: part pro.stock_hsgt(trade_datetrade_date, typet) if part is not None and not part.empty: frames.append(part) full pd.concat(frames, ignore_indexTrue) print(full) print(full[type_name].value_counts()) # 按通道统计标的数量3. 组合使用单股标的池查询与历史回溯# 按股票代码查询某只股票当前属于哪条通道 df_1 pro.stock_hsgt(ts_code000338.SZ, typeHK_SZ) # 按日期区间回溯标的池变化注意数据自 20250812 起 df_2 pro.stock_hsgt(start_date20250812, end_date20250813, typeSH_HK)4. 数据样例解读文档中给出的样例数据trade_date20250813可以直观看出四类通道数据的混合形态ts_code trade_date type name type_name 0 001258.SZ 20250813 HK_SZ 立新能源 深股通(港深) 1 00019.HK 20250813 SZ_HK 太古股份公司A 港股通(深港) 2 000513.SZ 20250813 HK_SZ 丽珠集团 深股通(港深) ... 996 02331.HK 20250813 SH_HK 李宁 港股通(沪港) 997 01855.HK 20250813 SH_HK 中庆股份 港股通(沪港) 999 06127.HK 20250813 SH_HK 昭衍新药 港股通(沪港)从样例可以提取两个重要识别规律A 股代码后缀.SZ结尾为深交所股票如001258.SZ.SH结尾为上交所股票出现在HK_SZ/HK_SH北向类型中港股代码后缀.HK结尾为港交所股票如00019.HK、02331.HK出现在SZ_HK/SH_HK南向类型中。因此在聚合分析时可依据ts_code后缀快速区分 A 股与港股标的与 Tushare 回退适配器 中_ts_code()的后缀判断逻辑互为印证。七、与关联接口联动构建完整的沪深港通研究流水线stock_hsgt提供“股票池”要完成资金流研究还需联动以下关联接口均收录于 Tushare 技能主文档 的接口列表接口仓库文档作用moneyflow_hsgt沪深港通资金流向每日北向/南向资金净流入hgt、sgt、north_money、south_money单位百万元hsgt_top10沪深股通十大成交股沪股通/深股通每日前十大活跃成交股及净买卖额hk_hold沪深股通持股明细港交所披露的北向个股持股明细一个典型的应用链路是先用stock_hsgt确定当日各通道标的域 → 用hsgt_top10定位外资当日重点交易的个股 → 用hk_hold跟踪重点个股的持股变化 → 结合moneyflow_hsgt判断整体资金方向。这与 hk-connect-flow 技能文档 中“北向 20 日累计净买入判断持续建仓/派发、AH 溢价指数指导跨市场配置”的分析框架完全兼容stock_hsgt在其中承担了最底层的标的筛选职责。八、注意事项与最佳实践总结积分与频率stock_hsgt需 3000 积分正式任务前先在 Tushare 数据工具tushare.pro/webclient中调试确认参数与返回避免浪费调用额度。数据起始日本接口数据从20250812开始历史回溯窗口不要早于该日期。分页循环单次请求最多返回 2000 行务必按type必要时叠加trade_date循环分段拉取并合并防止数据截断。更新时点数据每天 9:20 更新盘前任务应安排在更新完成后执行。Agent 集成在 Vibe-Trading 的 Agent 工作流中本接口作为 Tushare 技能 下“股票数据 / 基础数据”分类的技能文档存在Agent 可直接依据文档中的参数表、类型表与代码示例生成可运行的 Python 调用生产环境中建议通过 Tushare 回退适配器 的鉴权模式统一管理 token避免凭据散落。掌握stock_hsgt后读者即可在 Vibe-Trading 中稳定构建沪深港通标的域为北向资金情绪分析、跨境套利研究等高级策略提供可靠的数据底座。【免费下载链接】Vibe-TradingVibe-Trading: Your Personal Trading Agent项目地址: https://gitcode.com/GitHub_Trending/vi/Vibe-Trading创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 Vibe-Trading 数据技能实战：Tushare stock_hsgt 沪深港通股票列表接口深度解析与调用指南
Vibe-Trading 数据技能实战Tushare stock_hsgt 沪深港通股票列表接口深度解析与调用指南【免费下载链接】Vibe-TradingVibe-Trading: Your Personal Trading Agent项目地址: https://gitcode.com/GitHub_Trending/vi/Vibe-Trading沪深港通Stock Connect是外资通过北向通道买卖 A 股、内地资金通过南向通道买卖港股的跨境互联互通机制而标的池的准确名单是研究外资持仓、构建跨境策略的基础前提。本文以 Vibe-Trading 仓库中 Tushare 技能文档 沪深港通股票列表 为核心骨架结合仓库内环境配置、回退适配器与关联接口实现系统讲解stock_hsgt接口的权限门槛、入参约束、类型语义、分页循环策略与实战调用方式帮助读者在量化研究中快速获取沪股通、深股通、港股通的完整标的列表。一、沪深港通机制与标的列表的量化意义在进入接口细节之前先明确该数据在投资研究中的位置。Vibe-Trading 仓库中的 hk-connect-flow 技能文档 对沪深港通架构有清晰概括沪股通HK_SH/ 深股通HK_SZ北向通道外资买入上交所、深交所 A 股被普遍视为 A 股市场机构资金情绪的“聪明钱”指标港股通SH_HK / SZ_HK南向通道内地资金买入港股体现内地投资者对港股的配置偏好高股息、科技平台、AH 溢价套利。stock_hsgt接口提供的正是这四条通道各自的合格标的股票名单它是进一步计算北向/南向资金流moneyflow_hsgt、十大活跃成交股hsgt_top10、个股持股明细hk_hold等数据的“股票域universe”基础——只有先确定某只股票属于哪个通道的标的池才能合理解读其资金流数据的含义。二、接口速览权限、更新机制与数据起始日根据 沪深港通股票列表文档stock_hsgt接口的关键约束如下属性说明接口名stock_hsgtPython SDK 中通过pro.stock_hsgt(...)调用功能描述获取沪深港通股票列表权限要求3000 积分起数据更新每天上午9:20更新单次返回上限最大返回2000 行数据可根据类型循环提取数据起始日期从20250812开始两点实践要点值得注意积分门槛该接口需要 3000 积分属于中高权限接口。相比之下仓库中另一关联接口moneyflow_hsgt沪深港通资金流向文档仅需 2000 积分起而 5000 积分可获得每分钟 500 次的更高提取频率。在规划数据获取任务时应结合账号积分与接口权限做好取舍。每日更新时点9:20 更新意味着当日上午开盘前即可获取当日最新标的名单适合盘前构建当天的候选股票域。三、输入参数详解与类型语义接口输入参数如下摘自 沪深港通股票列表文档名称类型必选描述ts_codestrN股票代码trade_datestrN交易日期格式YYYYMMDDtypestrY类型见下表start_datestrN开始时间end_datestrN结束时间类型type参数是唯一必选参数其取值范围与语义如下类型类型名称通道方向HK_SZ深股通港深香港 → 深圳外资买深市 A 股SZ_HK港股通深港深圳 → 香港深市资金买港股HK_SH沪股通港沪香港 → 上海外资买沪市 A 股SH_HK港股通沪港上海 → 香港沪市资金买港股参数组合策略从源码/文档结构推断的推荐用法单日全量获取传trade_datetype即可得到该类型当日全部标的样例数据单次返回约 1000 行未超过 2000 行上限代码级过滤传ts_codetype查询单只股票当前是否属于某通道标的池历史区间回溯传start_date/end_datetype配合文档中“数据从 20250812 开始”的提示可观察标的池随时间的调整如被调入/调出通道的股票。需要特别说明由于type必选且单次请求最大返回 2000 行若某类型标的数量可能超过上限应采用“按类型 按日期循环提取”的方式分批拉取这与 沪深港通资金流向文档 中“每次最多返回 300 条记录总量不限制可按日期循环提取”的分页思路一致。四、输出字段说明接口返回的 DataFrame 包含以下字段名称类型默认显示描述ts_codestrY股票代码trade_datestrY交易日期typestrY类型namestrY股票名称type_namestrY类型名称其中type_name直接给出了“深股通(港深)”“港股通(深港)”等可读描述便于直接用于报表展示或 Agent 的自然语言输出无需再做类型码到中文名的映射。五、环境与鉴权在 Vibe-Trading 中配置 Tushare Token调用任何 Tushare 接口前都需要完成 token 鉴权。Vibe-Trading 仓库对 Tushare 凭据的管理方式是环境变量注入具体位于 环境变量模式定义tushare_token: str Field(aliasTUSHARE_TOKEN, default)即通过TUSHARE_TOKEN环境变量配置 token。安装并初始化方式可参考 Tushare 技能主文档pip install tushare -i https://pypi.tuna.tsinghua.edu.cn/simple export TUSHARE_TOKENyour_tokenimport os import tushare as ts # 读取环境变量中的 token, 或者读取本地记录的 token token os.getenv(TUSHARE_TOKEN) or ts.get_token() # 初始化 pro 接口实例 pro ts.pro_api(token)仓库中的 股票数据获取示例脚本 给出了更贴合本项目风格的初始化方式——通过配置访问器统一读取from src.config.accessor import get_env_config import tushare as ts token get_env_config().data.tushare_token or ts.get_token() pro ts.pro_api(token)值得一提的是仓库中的 Tushare 回退适配器 展示了 token 校验的健壮性实践它会把空字符串、your-tushare-token等占位值判定为“未配置”并抛出TushareFallbackUnavailable异常避免用无效凭据发起无意义的请求同时该文件中的_ts_code()函数给出了 Tushare 代码后缀的规范——5/6/9开头归SH、0/2/3开头归SZ、4/8开头归BJ理解这套规则有助于正确识别沪深港通名单中 A 股代码的归属市场。六、接口调用实战1. 基础调用获取单日某类型的标的列表沿用 沪深港通股票列表文档 中的官方示例获取 2025 年 8 月 13 日深股通外资买深市的股票列表import tushare as ts pro ts.pro_api() # 获取20250813日深股通的股票列表 df pro.stock_hsgt(trade_date20250813, typeHK_SZ) print(df)2. 循环提取覆盖全部四种类型由于type必选且单次有 2000 行上限完整的“沪深港通股票列表”应按类型循环拉取并合并import pandas as pd pro ts.pro_api() trade_date 20250813 types [HK_SZ, SZ_HK, HK_SH, SH_HK] frames [] for t in types: part pro.stock_hsgt(trade_datetrade_date, typet) if part is not None and not part.empty: frames.append(part) full pd.concat(frames, ignore_indexTrue) print(full) print(full[type_name].value_counts()) # 按通道统计标的数量3. 组合使用单股标的池查询与历史回溯# 按股票代码查询某只股票当前属于哪条通道 df_1 pro.stock_hsgt(ts_code000338.SZ, typeHK_SZ) # 按日期区间回溯标的池变化注意数据自 20250812 起 df_2 pro.stock_hsgt(start_date20250812, end_date20250813, typeSH_HK)4. 数据样例解读文档中给出的样例数据trade_date20250813可以直观看出四类通道数据的混合形态ts_code trade_date type name type_name 0 001258.SZ 20250813 HK_SZ 立新能源 深股通(港深) 1 00019.HK 20250813 SZ_HK 太古股份公司A 港股通(深港) 2 000513.SZ 20250813 HK_SZ 丽珠集团 深股通(港深) ... 996 02331.HK 20250813 SH_HK 李宁 港股通(沪港) 997 01855.HK 20250813 SH_HK 中庆股份 港股通(沪港) 999 06127.HK 20250813 SH_HK 昭衍新药 港股通(沪港)从样例可以提取两个重要识别规律A 股代码后缀.SZ结尾为深交所股票如001258.SZ.SH结尾为上交所股票出现在HK_SZ/HK_SH北向类型中港股代码后缀.HK结尾为港交所股票如00019.HK、02331.HK出现在SZ_HK/SH_HK南向类型中。因此在聚合分析时可依据ts_code后缀快速区分 A 股与港股标的与 Tushare 回退适配器 中_ts_code()的后缀判断逻辑互为印证。七、与关联接口联动构建完整的沪深港通研究流水线stock_hsgt提供“股票池”要完成资金流研究还需联动以下关联接口均收录于 Tushare 技能主文档 的接口列表接口仓库文档作用moneyflow_hsgt沪深港通资金流向每日北向/南向资金净流入hgt、sgt、north_money、south_money单位百万元hsgt_top10沪深股通十大成交股沪股通/深股通每日前十大活跃成交股及净买卖额hk_hold沪深股通持股明细港交所披露的北向个股持股明细一个典型的应用链路是先用stock_hsgt确定当日各通道标的域 → 用hsgt_top10定位外资当日重点交易的个股 → 用hk_hold跟踪重点个股的持股变化 → 结合moneyflow_hsgt判断整体资金方向。这与 hk-connect-flow 技能文档 中“北向 20 日累计净买入判断持续建仓/派发、AH 溢价指数指导跨市场配置”的分析框架完全兼容stock_hsgt在其中承担了最底层的标的筛选职责。八、注意事项与最佳实践总结积分与频率stock_hsgt需 3000 积分正式任务前先在 Tushare 数据工具tushare.pro/webclient中调试确认参数与返回避免浪费调用额度。数据起始日本接口数据从20250812开始历史回溯窗口不要早于该日期。分页循环单次请求最多返回 2000 行务必按type必要时叠加trade_date循环分段拉取并合并防止数据截断。更新时点数据每天 9:20 更新盘前任务应安排在更新完成后执行。Agent 集成在 Vibe-Trading 的 Agent 工作流中本接口作为 Tushare 技能 下“股票数据 / 基础数据”分类的技能文档存在Agent 可直接依据文档中的参数表、类型表与代码示例生成可运行的 Python 调用生产环境中建议通过 Tushare 回退适配器 的鉴权模式统一管理 token避免凭据散落。掌握stock_hsgt后读者即可在 Vibe-Trading 中稳定构建沪深港通标的域为北向资金情绪分析、跨境套利研究等高级策略提供可靠的数据底座。【免费下载链接】Vibe-TradingVibe-Trading: Your Personal Trading Agent项目地址: https://gitcode.com/GitHub_Trending/vi/Vibe-Trading创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考