Vibe-Trading 数据接入实战Tushare AH 股比价接口stk_ah_comparison从调用到策略应用全解析【免费下载链接】Vibe-TradingVibe-Trading: Your Personal Trading Agent项目地址: https://gitcode.com/GitHub_Trending/vi/Vibe-Trading本文围绕 Vibe-Trading 开源项目中 Tushare 技能体系内的AH 股比价接口stk_ah_comparison展开完整讲解其权限门槛、更新机制、输入/输出参数、Python 调用方式与数据样例解读并结合仓库源码揭示 A/H 比价与溢价指标的计算逻辑、token 配置与限流退避机制以及其在跨市场估值与信号构建中的实际用法。读完本文你将能够独立完成 AH 股比价数据的批量提取、字段含义解读并掌握将比价数据接入双地上市股票研究流程的完整方案。一、接口概览用一条接口对齐 A 股与 H 股两个市场AH 股比价数据描述的是同一家公司分别在内地A 股与香港H 股两地上市时两市场价格之间的相对关系。Vibe-Trading 项目将 Tushare 作为数据源技能之一在 agent/src/skills/tushare/SKILL.md 的接口总表中登记了该接口ID 399所属分类为「股票数据 特色数据」标题即「AH股比价」接口名stk_ah_comparison。该接口的核心能力与约束如下属性说明接口名stk_ah_comparison数据描述AH 股比价数据可根据交易日期获取历史权限要求5000 积分起更新机制每天盘后 17:00 更新单次请求上限最大返回 1000 行数据可循环提取历史起点数据从 20250812 开始历史不好补充只能累积值得特别注意的是「只能累积」这一约束该接口没有可回溯的早期历史数据自 2025-08-12 起逐日累积。因此任何依赖该接口的历史回测都只能覆盖该起始日之后的区间想要更长时间维度的 AH 溢价研究需要通过持续每日抓取来自建时间序列。二、输入参数详解接口共提供 5 个可选输入参数全部为非必填可通过自由组合定位数据范围名称类型必选描述hk_codestrN港股股票代码xxxxx.HK如02068.HKts_codestrNA 股股票代码xxxxxx.SH/SZ/BJ如601068.SHtrade_datestrN交易日期格式YYYYMMDD下同start_datestrN开始日期end_datestrN结束日期参数组合的典型用法包括不传任何参数无法直接调用通常需要至少一个定位条件传trade_date可获取单日全市场 AH 比价快照这正是文档示例中的用法传hk_code或ts_code可锁定单只双地上市股票传start_date/end_date可提取一段日期区间内全部或单只股票的比价历史代码后缀遵循 Tushare 统一约定A 股为.SH/.SZ/.BJ沪、深、北交所港股为.HK这一约定与仓库中 agent/backtest/loaders/tushare.py 的符号识别逻辑一致——该 Loader 通过_is_hk_equity()识别以.HK结尾的港股代码通过_is_index()区分以000xxx.SH/399xxx.SZ开头的指数代码确保不同市场的数据路由到正确的数据源。三、输出参数详解读懂比价与溢价两个核心字段接口每次返回一行记录代表一个「交易日期 × 双地股票对」共 10 个输出字段名称类型默认显示描述hk_codestrY港股股票代码ts_codestrYA 股股票代码trade_datestrY交易日期hk_namestrY港股股票名称hk_pct_chgfloatY港股股票涨跌幅hk_closefloatY港股股票收盘价namestrYA 股股票名称closefloatYA 股股票收盘价ah_comparisonfloatY比价(A/H)ah_premiumfloatY溢价(A/H)%其中hk_close与close分别为港股港元计价与 A 股人民币计价的收盘价涨跌幅hk_pct_chg与pct_chg反映两市场当日走势分歧。而两个核心衍生指标ah_comparison与ah_premium则是跨市场估值分析的关键ah_comparison比价 A/HA 股价格相对 H 股价格经汇率换算后的倍数。当它大于 1 时表示 A 股相对更贵小于 1 时表示 H 股相对更贵。ah_premium溢价 A/H %A 股相对 H 股的溢价率从文档数据样例可以推断ah_premium ≈ (ah_comparison − 1) × 100。例如中铝国际601068.SH / 02068.HK当日ah_comparison 2.16、ah_premium 115.84即 A 股相对 H 股溢价约 115%。注意比价需要将港元计价换算为人民币口径因此实际数值隐式包含了当日的汇率因素。这一口径与仓库中 agent/src/skills/adr-hshare/SKILL.md 给出的通用公式一致AH Premium (A-share price / H-share price in CNY terms - 1) × 100%该技能文档还提供了将 HKD 换算为 CNY 的汇率处理代码h_price_cny h_price_hkd * (usdcny / usdhkd)可用于自行验证或重算比价。四、Python 调用实战4.1 基础用法拉取单日全市场快照文档给出的最简用法是直接按trade_date提取某一天全部 AH 股比价数据import tushare as ts pro ts.pro_api() # 获取 20250812 日所有的 AH 股比价数据 df pro.stk_ah_comparison(trade_date20250812) print(df.head())返回结果是一个 pandas DataFrame列即第三节中的 10 个输出字段。4.2 按股票或日期区间定向提取对于单只双地上市股票的历史比价跟踪可以组合ts_code或hk_code与起止日期# 单只 A 股对应的 H 股比价历史 df pro.stk_ah_comparison(ts_code601068.SH, start_date20250812, end_date20250930) # 单只港股对应的 A 股比价历史 df pro.stk_ah_comparison(hk_code03993.HK, start_date20250812, end_date20250930)4.3 应对 1000 行上限按日循环全量累积文档提示「单次请求最大返回 1000 行数据可循环提取」。当前 A H 双地上市股票对约百余组见文档样例行号延伸至 159 行单日调用通常不会触顶但当提取跨多日长区间时应按交易日逐日循环并对每次返回的行数做检查将结果累积拼接import pandas as pd import tushare as ts pro ts.pro_api() # 以 Tushare 交易日历trade_cal为准也可用 start/end 区间配合循环 frames [] for trade_date in [20250812, 20250813, 20250814]: # 实际应循环交易日历 batch pro.stk_ah_comparison(trade_datetrade_date) if batch is not None and len(batch): frames.append(batch) df pd.concat(frames, ignore_indexTrue)这种「逐日循环 增量累积」的方式正好契合该接口「只能累积」的数据特性从 20250812 起每天盘后 17:00 更新后及时抓取即可逐步构建起自己的 AH 比价时间序列数据库。4.4 在 Vibe-Trading 环境中配置 token仓库中所有 Tushare 调用的统一凭证入口是TUSHARE_TOKEN环境变量。技能示例脚本 agent/src/skills/tushare/scripts/stock_data_example.py 展示了标准初始化方式from src.config.accessor import get_env_config token get_env_config().data.tushare_token or ts.get_token() pro ts.pro_api(token)对应的环境变量声明位于 agent/src/config/env_schema.pytushare_token: str Field(aliasTUSHARE_TOKEN, default)并在 agent/src/preflight.py 的_check_tushare()预检中被校验——预检会识别空值或your-tushare-token这类占位符并给出提示引导用户到 Tushare 官网注册并配置真实 token。五、仓库源码支撑比价数据在 Vibe-Trading 中的落地路径虽然stk_ah_comparison属于「特色数据」类目、并不在行情 Loader 的常规 OHLCV 路径上但仓库为整个 Tushare 数据接入提供了完整的工程化支撑理解这些机制有助于把 AH 比价接口稳定地跑在生产级流程中Token 统一管理与占位符防御agent/backtest/loaders/tushare.py 定义了TUSHARE_TOKEN_PLACEHOLDERS {, your-tushare-token}凡是未配置真实 token 的调用都会被判定为不可用防止静默失败。限流退避机制Tushare 积分体系决定了每分钟调用频次上限。Loader 中实现了_call_with_backoff()通过_is_rate_limited()匹配「每分钟/每天/抽取/频率/rate limit」等特征文案识别配额拒绝并按(5.0, 20.0, 40.0)秒的退避序列重试——跨越一分钟的配额窗口后恢复调用。调用stk_ah_comparison做批量循环提取时同样适用这一「遇限流即退避」的工程经验避免高频请求触发风控。积分与权限分级Tushare 各接口按积分分级开放AH 股比价要求 5000 积分起stk_ah_comparison属于高权限特色接口。积分决定单位时间流量上限「积分越高流量越大」因此对于需要全市场批量循环的场景建议优先保证积分充足再配合退避策略稳妥提取。六、数据样例解读一份真实的 AH 比价快照以下为文档提供的 20250812 当日部分数据样例节选hk_codets_codehk_namehk_pct_chghk_closenameclosepct_chgah_comparisonah_premium02068.HK601068.SH中铝国际0.782.60中铝国际5.140.002.16115.8403993.HK603993.SH洛阳钼业0.6010.07洛阳钼业9.850.311.076.8006066.HK601066.SH中信建投证券1.7713.25中信建投26.090.662.15114.9906680.HK300748.SZ金力永磁-5.6718.30金力永磁27.30-3.051.6362.8802333.HK601633.SH长城汽车3.5514.60长城汽车22.931.821.7171.4801065.HK600874.SH天津创业环保股份2.244.10创业环保6.010.001.6060.05解读要点溢价水平的横截面差异同一交易日不同股票对的溢价差异极大从洛阳钼业的 6.80% 到中铝国际的 115.84%说明 AH 溢价既有系统性因素投资者结构、流动性、汇率预期也有个股层面的独立因素横截面排序本身就是一条有用的研究线索。A 股普遍溢价现象从样例看绝大多数 A 股相对 H 股存在溢价这与仓库 agent/src/skills/hk-connect-flow/SKILL.md 中对恒生 AH 溢价指数HSAHP的解读框架一致A 股高零售参与度带来流动性溢价、历史上外资准入受限带来稀缺性溢价、CNY 贬值预期会进一步拉大溢价。两地市场当日涨跌分歧金力永磁当日 A 股下跌 3.05% 而港股下跌 5.67%两地价格同步波动但幅度不同为观察跨市场情绪传导提供了直接素材。七、从比价数据到策略信号AH 溢价分析框架拿到ah_premium时间序列后可以借助仓库中已有的分析技能将其转化为可执行的信号1. 溢价区间解读agent/src/skills/adr-hshare/SKILL.md溢价水平解读倾向性动作50%A 股高溢价极端A 股投机泡沫或 H 股极端低估偏多 H、回避 A30%–50%高溢价对高散户参与度标的是常态同等基本面下温和偏好 H10%–30%大多数 AH 组合的正常区间中性无强套利信号0%–10%溢价压缩A 股相对便宜异常需研究催化剂0%H 股反超 A 股极少见通常为事件驱动2. 均值回归 z-score 信号该技能给出了基于历史均值和标准差的信号生成方式——当某只股票溢价相对其 12 个月均值偏离超过 2 个标准差时发出「fade premium」做多 H 回避 A或「buy premium」信号。3. 与南北向资金联动agent/src/skills/hk-connect-flow/SKILL.md当 AH 溢价指数超过 130 时套利资金倾向经港股通南向买入更便宜的 H 股反之溢价压缩到 110 以下时A 股相对便宜需要重点调查原因。该技能还提供多维打分框架将南北向资金流、AH 溢价、汇率方向综合为 −10 到 10 的跨境风险偏好得分。需要说明的是AH 股之间不可自由互换与 ADR/H 股的存托转换不同真正的套利需要两套独立的资金池因此溢价更多被用作估值参照与情绪信号而非可执行的瞬时套利工具——这一点在 agent/src/skills/adr-hshare/SKILL.md 的 Notes 中有明确提示。八、实战注意事项与 FAQ历史窗口有限数据自 20250812 起无法回补更早历史。做长期研究需从启用日起每日盘后17:00 后持续累积。积分门槛stk_ah_comparison需要 5000 积分起且单位分钟有流控积分越高流量越大未达标时接口会返回权限类错误需先提升积分。单次 1000 行上限长区间提取务必按交易日循环并拼接结果同时结合退避策略控制调用频率参考 agent/backtest/loaders/tushare.py 的限流识别与重试实现。汇率口径ah_comparison/ah_premium已隐含汇率换算港元折算为人民币如需自建指标或验证数据可参照 agent/src/skills/adr-hshare/SKILL.md 中的换算公式。代码格式港股代码为xxxxx.HK如02068.HKA 股代码为xxxxxx.SH/SZ/BJ混用格式会导致查不到数据。与常规行情接口的关系A 股日线daily、港股日线hk_daily等行情接口只提供单市场价格stk_ah_comparison的价值在于一次性给出配对后的双市场收盘价、涨跌幅与比价/溢价衍生指标省去了自行按股票对配对的繁琐步骤。九、总结stk_ah_comparison是 Vibe-Trading Tushare 技能体系中「股票数据 特色数据」类目下的高频价值接口它把双地上市公司的 A/H 收盘价、涨跌幅与比价、溢价浓缩在单次调用内配合 5000 积分门槛、每日盘后更新与单次 1000 行的限制构成了稳定的每日增量数据源。通过本文的调用示例、字段拆解与源码佐证你可以直接在仓库的 Tushare 技能框架agent/src/skills/tushare/SKILL.md、agent/src/skills/tushare/scripts/stock_data_example.py之上构建属于自己的 AH 溢价时间序列并进一步结合 agent/src/skills/adr-hshare/SKILL.md 与 agent/src/skills/hk-connect-flow/SKILL.md 的分析框架将原始比价数据转化为可解释、可验证的跨市场策略信号。【免费下载链接】Vibe-TradingVibe-Trading: Your Personal Trading Agent项目地址: https://gitcode.com/GitHub_Trending/vi/Vibe-Trading创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 Vibe-Trading 数据接入实战：Tushare AH 股比价接口（stk_ah_comparison）从调用到策略应用全解析
Vibe-Trading 数据接入实战Tushare AH 股比价接口stk_ah_comparison从调用到策略应用全解析【免费下载链接】Vibe-TradingVibe-Trading: Your Personal Trading Agent项目地址: https://gitcode.com/GitHub_Trending/vi/Vibe-Trading本文围绕 Vibe-Trading 开源项目中 Tushare 技能体系内的AH 股比价接口stk_ah_comparison展开完整讲解其权限门槛、更新机制、输入/输出参数、Python 调用方式与数据样例解读并结合仓库源码揭示 A/H 比价与溢价指标的计算逻辑、token 配置与限流退避机制以及其在跨市场估值与信号构建中的实际用法。读完本文你将能够独立完成 AH 股比价数据的批量提取、字段含义解读并掌握将比价数据接入双地上市股票研究流程的完整方案。一、接口概览用一条接口对齐 A 股与 H 股两个市场AH 股比价数据描述的是同一家公司分别在内地A 股与香港H 股两地上市时两市场价格之间的相对关系。Vibe-Trading 项目将 Tushare 作为数据源技能之一在 agent/src/skills/tushare/SKILL.md 的接口总表中登记了该接口ID 399所属分类为「股票数据 特色数据」标题即「AH股比价」接口名stk_ah_comparison。该接口的核心能力与约束如下属性说明接口名stk_ah_comparison数据描述AH 股比价数据可根据交易日期获取历史权限要求5000 积分起更新机制每天盘后 17:00 更新单次请求上限最大返回 1000 行数据可循环提取历史起点数据从 20250812 开始历史不好补充只能累积值得特别注意的是「只能累积」这一约束该接口没有可回溯的早期历史数据自 2025-08-12 起逐日累积。因此任何依赖该接口的历史回测都只能覆盖该起始日之后的区间想要更长时间维度的 AH 溢价研究需要通过持续每日抓取来自建时间序列。二、输入参数详解接口共提供 5 个可选输入参数全部为非必填可通过自由组合定位数据范围名称类型必选描述hk_codestrN港股股票代码xxxxx.HK如02068.HKts_codestrNA 股股票代码xxxxxx.SH/SZ/BJ如601068.SHtrade_datestrN交易日期格式YYYYMMDD下同start_datestrN开始日期end_datestrN结束日期参数组合的典型用法包括不传任何参数无法直接调用通常需要至少一个定位条件传trade_date可获取单日全市场 AH 比价快照这正是文档示例中的用法传hk_code或ts_code可锁定单只双地上市股票传start_date/end_date可提取一段日期区间内全部或单只股票的比价历史代码后缀遵循 Tushare 统一约定A 股为.SH/.SZ/.BJ沪、深、北交所港股为.HK这一约定与仓库中 agent/backtest/loaders/tushare.py 的符号识别逻辑一致——该 Loader 通过_is_hk_equity()识别以.HK结尾的港股代码通过_is_index()区分以000xxx.SH/399xxx.SZ开头的指数代码确保不同市场的数据路由到正确的数据源。三、输出参数详解读懂比价与溢价两个核心字段接口每次返回一行记录代表一个「交易日期 × 双地股票对」共 10 个输出字段名称类型默认显示描述hk_codestrY港股股票代码ts_codestrYA 股股票代码trade_datestrY交易日期hk_namestrY港股股票名称hk_pct_chgfloatY港股股票涨跌幅hk_closefloatY港股股票收盘价namestrYA 股股票名称closefloatYA 股股票收盘价ah_comparisonfloatY比价(A/H)ah_premiumfloatY溢价(A/H)%其中hk_close与close分别为港股港元计价与 A 股人民币计价的收盘价涨跌幅hk_pct_chg与pct_chg反映两市场当日走势分歧。而两个核心衍生指标ah_comparison与ah_premium则是跨市场估值分析的关键ah_comparison比价 A/HA 股价格相对 H 股价格经汇率换算后的倍数。当它大于 1 时表示 A 股相对更贵小于 1 时表示 H 股相对更贵。ah_premium溢价 A/H %A 股相对 H 股的溢价率从文档数据样例可以推断ah_premium ≈ (ah_comparison − 1) × 100。例如中铝国际601068.SH / 02068.HK当日ah_comparison 2.16、ah_premium 115.84即 A 股相对 H 股溢价约 115%。注意比价需要将港元计价换算为人民币口径因此实际数值隐式包含了当日的汇率因素。这一口径与仓库中 agent/src/skills/adr-hshare/SKILL.md 给出的通用公式一致AH Premium (A-share price / H-share price in CNY terms - 1) × 100%该技能文档还提供了将 HKD 换算为 CNY 的汇率处理代码h_price_cny h_price_hkd * (usdcny / usdhkd)可用于自行验证或重算比价。四、Python 调用实战4.1 基础用法拉取单日全市场快照文档给出的最简用法是直接按trade_date提取某一天全部 AH 股比价数据import tushare as ts pro ts.pro_api() # 获取 20250812 日所有的 AH 股比价数据 df pro.stk_ah_comparison(trade_date20250812) print(df.head())返回结果是一个 pandas DataFrame列即第三节中的 10 个输出字段。4.2 按股票或日期区间定向提取对于单只双地上市股票的历史比价跟踪可以组合ts_code或hk_code与起止日期# 单只 A 股对应的 H 股比价历史 df pro.stk_ah_comparison(ts_code601068.SH, start_date20250812, end_date20250930) # 单只港股对应的 A 股比价历史 df pro.stk_ah_comparison(hk_code03993.HK, start_date20250812, end_date20250930)4.3 应对 1000 行上限按日循环全量累积文档提示「单次请求最大返回 1000 行数据可循环提取」。当前 A H 双地上市股票对约百余组见文档样例行号延伸至 159 行单日调用通常不会触顶但当提取跨多日长区间时应按交易日逐日循环并对每次返回的行数做检查将结果累积拼接import pandas as pd import tushare as ts pro ts.pro_api() # 以 Tushare 交易日历trade_cal为准也可用 start/end 区间配合循环 frames [] for trade_date in [20250812, 20250813, 20250814]: # 实际应循环交易日历 batch pro.stk_ah_comparison(trade_datetrade_date) if batch is not None and len(batch): frames.append(batch) df pd.concat(frames, ignore_indexTrue)这种「逐日循环 增量累积」的方式正好契合该接口「只能累积」的数据特性从 20250812 起每天盘后 17:00 更新后及时抓取即可逐步构建起自己的 AH 比价时间序列数据库。4.4 在 Vibe-Trading 环境中配置 token仓库中所有 Tushare 调用的统一凭证入口是TUSHARE_TOKEN环境变量。技能示例脚本 agent/src/skills/tushare/scripts/stock_data_example.py 展示了标准初始化方式from src.config.accessor import get_env_config token get_env_config().data.tushare_token or ts.get_token() pro ts.pro_api(token)对应的环境变量声明位于 agent/src/config/env_schema.pytushare_token: str Field(aliasTUSHARE_TOKEN, default)并在 agent/src/preflight.py 的_check_tushare()预检中被校验——预检会识别空值或your-tushare-token这类占位符并给出提示引导用户到 Tushare 官网注册并配置真实 token。五、仓库源码支撑比价数据在 Vibe-Trading 中的落地路径虽然stk_ah_comparison属于「特色数据」类目、并不在行情 Loader 的常规 OHLCV 路径上但仓库为整个 Tushare 数据接入提供了完整的工程化支撑理解这些机制有助于把 AH 比价接口稳定地跑在生产级流程中Token 统一管理与占位符防御agent/backtest/loaders/tushare.py 定义了TUSHARE_TOKEN_PLACEHOLDERS {, your-tushare-token}凡是未配置真实 token 的调用都会被判定为不可用防止静默失败。限流退避机制Tushare 积分体系决定了每分钟调用频次上限。Loader 中实现了_call_with_backoff()通过_is_rate_limited()匹配「每分钟/每天/抽取/频率/rate limit」等特征文案识别配额拒绝并按(5.0, 20.0, 40.0)秒的退避序列重试——跨越一分钟的配额窗口后恢复调用。调用stk_ah_comparison做批量循环提取时同样适用这一「遇限流即退避」的工程经验避免高频请求触发风控。积分与权限分级Tushare 各接口按积分分级开放AH 股比价要求 5000 积分起stk_ah_comparison属于高权限特色接口。积分决定单位时间流量上限「积分越高流量越大」因此对于需要全市场批量循环的场景建议优先保证积分充足再配合退避策略稳妥提取。六、数据样例解读一份真实的 AH 比价快照以下为文档提供的 20250812 当日部分数据样例节选hk_codets_codehk_namehk_pct_chghk_closenameclosepct_chgah_comparisonah_premium02068.HK601068.SH中铝国际0.782.60中铝国际5.140.002.16115.8403993.HK603993.SH洛阳钼业0.6010.07洛阳钼业9.850.311.076.8006066.HK601066.SH中信建投证券1.7713.25中信建投26.090.662.15114.9906680.HK300748.SZ金力永磁-5.6718.30金力永磁27.30-3.051.6362.8802333.HK601633.SH长城汽车3.5514.60长城汽车22.931.821.7171.4801065.HK600874.SH天津创业环保股份2.244.10创业环保6.010.001.6060.05解读要点溢价水平的横截面差异同一交易日不同股票对的溢价差异极大从洛阳钼业的 6.80% 到中铝国际的 115.84%说明 AH 溢价既有系统性因素投资者结构、流动性、汇率预期也有个股层面的独立因素横截面排序本身就是一条有用的研究线索。A 股普遍溢价现象从样例看绝大多数 A 股相对 H 股存在溢价这与仓库 agent/src/skills/hk-connect-flow/SKILL.md 中对恒生 AH 溢价指数HSAHP的解读框架一致A 股高零售参与度带来流动性溢价、历史上外资准入受限带来稀缺性溢价、CNY 贬值预期会进一步拉大溢价。两地市场当日涨跌分歧金力永磁当日 A 股下跌 3.05% 而港股下跌 5.67%两地价格同步波动但幅度不同为观察跨市场情绪传导提供了直接素材。七、从比价数据到策略信号AH 溢价分析框架拿到ah_premium时间序列后可以借助仓库中已有的分析技能将其转化为可执行的信号1. 溢价区间解读agent/src/skills/adr-hshare/SKILL.md溢价水平解读倾向性动作50%A 股高溢价极端A 股投机泡沫或 H 股极端低估偏多 H、回避 A30%–50%高溢价对高散户参与度标的是常态同等基本面下温和偏好 H10%–30%大多数 AH 组合的正常区间中性无强套利信号0%–10%溢价压缩A 股相对便宜异常需研究催化剂0%H 股反超 A 股极少见通常为事件驱动2. 均值回归 z-score 信号该技能给出了基于历史均值和标准差的信号生成方式——当某只股票溢价相对其 12 个月均值偏离超过 2 个标准差时发出「fade premium」做多 H 回避 A或「buy premium」信号。3. 与南北向资金联动agent/src/skills/hk-connect-flow/SKILL.md当 AH 溢价指数超过 130 时套利资金倾向经港股通南向买入更便宜的 H 股反之溢价压缩到 110 以下时A 股相对便宜需要重点调查原因。该技能还提供多维打分框架将南北向资金流、AH 溢价、汇率方向综合为 −10 到 10 的跨境风险偏好得分。需要说明的是AH 股之间不可自由互换与 ADR/H 股的存托转换不同真正的套利需要两套独立的资金池因此溢价更多被用作估值参照与情绪信号而非可执行的瞬时套利工具——这一点在 agent/src/skills/adr-hshare/SKILL.md 的 Notes 中有明确提示。八、实战注意事项与 FAQ历史窗口有限数据自 20250812 起无法回补更早历史。做长期研究需从启用日起每日盘后17:00 后持续累积。积分门槛stk_ah_comparison需要 5000 积分起且单位分钟有流控积分越高流量越大未达标时接口会返回权限类错误需先提升积分。单次 1000 行上限长区间提取务必按交易日循环并拼接结果同时结合退避策略控制调用频率参考 agent/backtest/loaders/tushare.py 的限流识别与重试实现。汇率口径ah_comparison/ah_premium已隐含汇率换算港元折算为人民币如需自建指标或验证数据可参照 agent/src/skills/adr-hshare/SKILL.md 中的换算公式。代码格式港股代码为xxxxx.HK如02068.HKA 股代码为xxxxxx.SH/SZ/BJ混用格式会导致查不到数据。与常规行情接口的关系A 股日线daily、港股日线hk_daily等行情接口只提供单市场价格stk_ah_comparison的价值在于一次性给出配对后的双市场收盘价、涨跌幅与比价/溢价衍生指标省去了自行按股票对配对的繁琐步骤。九、总结stk_ah_comparison是 Vibe-Trading Tushare 技能体系中「股票数据 特色数据」类目下的高频价值接口它把双地上市公司的 A/H 收盘价、涨跌幅与比价、溢价浓缩在单次调用内配合 5000 积分门槛、每日盘后更新与单次 1000 行的限制构成了稳定的每日增量数据源。通过本文的调用示例、字段拆解与源码佐证你可以直接在仓库的 Tushare 技能框架agent/src/skills/tushare/SKILL.md、agent/src/skills/tushare/scripts/stock_data_example.py之上构建属于自己的 AH 溢价时间序列并进一步结合 agent/src/skills/adr-hshare/SKILL.md 与 agent/src/skills/hk-connect-flow/SKILL.md 的分析框架将原始比价数据转化为可解释、可验证的跨市场策略信号。【免费下载链接】Vibe-TradingVibe-Trading: Your Personal Trading Agent项目地址: https://gitcode.com/GitHub_Trending/vi/Vibe-Trading创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考