Vibe-Trading 港股分钟行情数据接入实战基于 Tushare hk_mins 接口的分钟级行情获取指南【免费下载链接】Vibe-TradingVibe-Trading: Your Personal Trading Agent项目地址: https://gitcode.com/GitHub_Trending/vi/Vibe-Trading本篇技术指南以 Vibe-Trading 项目内置的 Tushare 数据源技能文档 港股分钟行情 为核心骨架系统讲解港股分钟行情接口hk_mins的完整接入方法从接口参数、频度定义、输出字段到 Python SDK 调用、分页循环抓取与实战组合策略并结合仓库内的 Tushare 技能总览、同数据源的港股日线/交易日历等姊妹文档做纵向延伸。读者学完后可独立完成任意港股标的如00001.HK的 1min/5min/15min/30min/60min 行情抓取并能在 Vibe-Trading 的量化研究与回测链路中直接复用。一、接口总览hk_mins 是什么hk_mins是 Tushare 提供的港股分钟行情数据接口接口 ID 为 304在 Tushare 技能总览 的「数据接口列表」中登记为「港股数据」分类。其核心特征如下项目说明接口名hk_mins数据范围港股分钟级行情OHLCV支持频度1min / 5min / 15min / 30min / 60min调用方式Python SDKpro.hk_mins(...)与 HTTP Restful API 两种单次限量最大 8000 行数据权限门槛120 积分可调取 2 次接口查看数据正式权限以 Tushare 官方权限说明为准值得说明的是hk_mins与仓库中同属 Tushare 技能目录的其他分钟类接口如 A 股 历史分钟stk_mins、指数 指数历史分钟idx_mins、期货 历史分钟行情ft_mins保持一致的参数风格与输出约定学习成本可以复用。受限前提说明单次请求最多返回 8000 行且受积分权限限制。这意味着一次请求通常无法覆盖全部历史分钟数据需要通过「股票代码 × 日期区间」组合循环抓取下文会给出标准做法。二、输入参数详解hk_mins共支持 4 个输入参数其中前两个为必选名称类型必选描述示例ts_codestrY股票代码必须带.HK后缀00001.HKfreqstrY分钟频度1minstart_datedatetimeN开始日期时间2023-03-13 09:00:00end_datedatetimeN结束日期时间2023-03-13 19:00:002.1 ts_code 代码规范港股代码统一为五位数字 .HK后缀的形式例如长江实业00001.HK、腾讯控股00700.HK。这与仓库内港股系列接口的约定完全一致港股实时日线rt_hk_k明确强调「ts_code 代码一定要带.HK后缀」港股日线行情hk_daily、港股复权行情hk_daily_adj同样使用00001.HK形式的代码。因此调用hk_mins时ts_code00001.HK中的后缀.HK不可省略。2.2 freq 频度参数说明freq是决定数据粒度的关键参数支持五种取值freq说明1min1 分钟5min5 分钟15min15 分钟30min30 分钟60min60 分钟在实际量化场景中选择粒度需要在信号灵敏度与数据体积/噪声之间权衡1min 数据适合日内高频策略与盘口微观结构分析但受 8000 行单次限量约束最明显约 34 个交易日的量60min 数据则适合做日内趋势过滤或与日线信号叠加单次可覆盖更长时间段。2.3 日期时间参数格式start_date与end_date使用YYYY-MM-DD HH:MM:SS格式如2023-03-13 09:00:00与 SKILL.md 中「参数格式说明」约定的日期规范YYYYMMDD略有区别——分钟接口要求精确到时分秒。若省略起止时间接口会按默认区间返回数据建议总是显式传入时间窗口以保证结果可复现。三、输出字段与数据语义hk_mins返回 pandas DataFrame字段定义如下名称类型默认显示描述ts_codestrY股票代码trade_timestrY交易时间openfloatY开盘价closefloatY收盘价highfloatY最高价lowfloatY最低价volintY成交量amountfloatY成交金额3.1 数据样例解读接口文档给出的真实样例数据2023-03-13 长实集团00001.HK全天分钟行情如下ts_code trade_time open close high low vol amount 0 00001.HK 2023-03-13 16:10:00 48.80 48.75 48.80 48.75 375500.0 18305625.0 1 00001.HK 2023-03-13 16:00:00 48.80 48.80 48.85 48.75 12000.0 585575.0 2 00001.HK 2023-03-13 15:59:00 48.80 48.80 48.80 48.75 12500.0 609825.0 3 00001.HK 2023-03-13 15:58:00 48.85 48.80 48.85 48.75 9500.0 463725.0 4 00001.HK 2023-03-13 15:57:00 48.80 48.80 48.85 48.75 24000.0 1171450.0 .. ... ... ... ... ... ... ... ... 327 00001.HK 2023-03-13 09:34:00 47.40 47.35 47.45 47.35 17000.0 805975.0 328 00001.HK 2023-03-13 09:33:00 47.55 47.40 47.55 47.40 11000.0 521725.0 329 00001.HK 2023-03-13 09:32:00 47.60 47.55 47.70 47.50 52500.0 2497550.0 330 00001.HK 2023-03-13 09:31:00 47.30 47.60 47.60 47.30 44229.0 2097256.7 331 00001.HK 2023-03-13 09:30:00 47.30 47.30 47.30 47.30 469900.0 22298550.0从样例中可以观察到几个对后续数据处理很有用的细节时间方向接口默认按交易时间倒序返回16:10 在前09:30 在后使用时建议先按trade_time升序排序再进入指标计算或回测管道避免前视偏差。盘中含盘后数据16:0016:10 的条目为港股收盘竞价时段16:00–16:10的成交记录建模时需根据策略定义决定是否保留。成交量单位vol以「股」为单位样例中 09:30 开盘分钟成交 46.99 万股amount以「元港币」为单位与 港股实时日线 的字段语义一致。四、接口用法Python SDK 实战4.1 标准调用示例根据接口文档最基础的调用方式如下import tushare as ts pro ts.pro_api() df pro.hk_mins( ts_code00001.HK, freq1min, start_date2023-03-13 09:00:00, end_date2023-03-13 19:00:00, ) print(df)4.2 初始化带 Token 的 pro 实例文档中的ts.pro_api()会隐式读取本地缓存的 token。在 Vibe-Trading 项目中更规范的初始化方式是显式读取环境变量中的 token。参照 Tushare 技能 SKILL.md 中的快速上手示例import os import tushare as ts # 读取环境变量中的 token或读取本地记录的 token token os.getenv(TUSHARE_TOKEN) or ts.get_token() # 初始化 pro 接口实例 pro ts.pro_api(token) # 获取港股分钟行情 df pro.hk_mins( ts_code00001.HK, freq5min, start_date2023-03-13 09:00:00, end_date2023-03-13 19:00:00, )仓库内的实际示例脚本 stock_data_example.py 也采用了同样的模式token get_env_config().data.tushare_token or ts.get_token()即优先读取项目环境配置中的 tushare_token其次回退到 tushare 本地 token 缓存然后再创建pro实例。这说明在 Vibe-Trading 中数据源凭据统一走环境配置通道TUSHARE_TOKEN环境变量是推荐的注入方式。4.3 HTTP Restful API 方式hk_mins同时支持 HTTP Restful API。Tushare 通用 POST 请求模型为向接口地址提交api_namehk_mins与参数体返回 JSON 结构中的data即行情数据。由于单次请求与 SDK 方式共享同一套参数与限量规则实际项目中选择哪种方式主要取决于调用端技术栈Python 后端首选 SDK跨语言服务如前端或脚本则用 Restful API。五、突破 8000 行限量循环分页抓取单次最大 8000 行是hk_mins的硬性限量文档明确「可以通过股票代码和日期循环获取」。对日频策略需要的完整历史分钟数据标准做法是按日期分片 循环累加import tushare as ts import pandas as pd pro ts.pro_api() codes [00001.HK, 00700.HK] # 多标的 freq 1min frames [] # 按交易日逐日抓取避开 8000 行上限 for code in codes: for day in [2023-03-13, 2023-03-14, 2023-03-15]: df pro.hk_mins( ts_codecode, freqfreq, start_datef{day} 09:00:00, end_datef{day} 16:30:00, ) if df is not None and not df.empty: frames.append(df) result pd.concat(frames, ignore_indexTrue) result result.sort_values(trade_time).reset_index(dropTrue) # 升序排列三个工程要点交易日来源循环中的交易日清单建议由 港股交易日历hk_tradecal接口生成is_open1才是交易日避免对休市日如台风休市、公众假期发起无效请求并白白消耗积分额度。去重若分片区间存在重叠合并后需按ts_code trade_time去重。时间范围港股交易时段为 09:30–12:00、13:00–16:00另含 16:00–16:10 收盘竞价抓取窗口设为 09:00–16:30 已能覆盖全部分钟记录。六、港股分钟数据在 Vibe-Trading 中的典型应用组合hk_mins在仓库的 Tushare 数据源技能体系中属于「港股数据」板块可与同板块接口组成完整的研究链路应用场景配合接口说明分钟级日内策略回测hk_mins 港股复权行情hk_daily_adj分钟行情做日内进出场日线复权行情含股本、市值、换手做背景过滤交易日历管理hk_mins 港股交易日历hk_tradecal用is_open字段自动生成有效抓取日期实时盘面确认hk_mins 港股实时日线rt_hk_k盘中实时日线快速确认趋势收盘后分钟数据用于精算跨市场对比hk_mins A 股 历史分钟stk_mins港股与 A 股分钟信号对照如 AH 联动注意两地交易时段差异关于数据口径的一致性仓库在 SKILL.md 的「参数格式说明」中统一了各接口约定日期用YYYYMMDD分钟接口内部精确到秒、股票代码统一ts_code格式、返回统一为 pandas DataFrame。因此把hk_mins的输出接入仓库内的因子计算或回测引擎时只需做常规的排序、去空值与类型转换无需额外的适配层。七、常见问题与最佳实践7.1 常见问题排查问题现象可能原因处理建议返回空 DataFramets_code缺.HK后缀、区间落在休市日、积分不足校验代码格式与交易日历检查权限数据倒序接口默认按时间倒序返回df.sort_values(trade_time, ascendingTrue)数据量超出 8000 行单次请求窗口过大按日或半日分片循环抓取token 报错未配置TUSHARE_TOKEN或积分不足os.getenv(TUSHARE_TOKEN)注入或ts.set_token()缓存7.2 最佳实践清单始终显式传时间窗口start_date/end_date精确到分钟保证结果确定性与可复现性先升序排序再建模避免接口倒序输出进入回测导致的前视偏差按交易日历循环用hk_tradecal生成抓取日期控制积分消耗选择合适 freq数据量敏感场景优先用 5min/60min微观结构研究再上 1min复用仓库技能文档更多港股接口细节可查阅 港股日线行情、港股复权因子 等文档与hk_mins配合构成完整数据底座。结语hk_mins为港股分钟级量化研究提供了标准化的数据入口。结合本文的接口参数说明、SDK 调用示例与循环分页方案配合 Vibe-Trading 仓库内 Tushare 数据源技能体系的 SKILL.md 总览文档开发者可以快速构建从「港股分钟行情抓取」到「日内策略回测」的完整数据链路。需要特别提醒的是正式权限、积分门槛与数据版权均以 Tushare 官方权限说明为准请在使用前确认账号权限与数据合规要求。【免费下载链接】Vibe-TradingVibe-Trading: Your Personal Trading Agent项目地址: https://gitcode.com/GitHub_Trending/vi/Vibe-Trading创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 
长河君 · 2026/9/11 0:05:33 · 阅读 1.2k Vibe-Trading 港股分钟行情数据接入实战：基于 Tushare hk_mins 接口的分钟级行情获取指南
Vibe-Trading 港股分钟行情数据接入实战基于 Tushare hk_mins 接口的分钟级行情获取指南【免费下载链接】Vibe-TradingVibe-Trading: Your Personal Trading Agent项目地址: https://gitcode.com/GitHub_Trending/vi/Vibe-Trading本篇技术指南以 Vibe-Trading 项目内置的 Tushare 数据源技能文档 港股分钟行情 为核心骨架系统讲解港股分钟行情接口hk_mins的完整接入方法从接口参数、频度定义、输出字段到 Python SDK 调用、分页循环抓取与实战组合策略并结合仓库内的 Tushare 技能总览、同数据源的港股日线/交易日历等姊妹文档做纵向延伸。读者学完后可独立完成任意港股标的如00001.HK的 1min/5min/15min/30min/60min 行情抓取并能在 Vibe-Trading 的量化研究与回测链路中直接复用。一、接口总览hk_mins 是什么hk_mins是 Tushare 提供的港股分钟行情数据接口接口 ID 为 304在 Tushare 技能总览 的「数据接口列表」中登记为「港股数据」分类。其核心特征如下项目说明接口名hk_mins数据范围港股分钟级行情OHLCV支持频度1min / 5min / 15min / 30min / 60min调用方式Python SDKpro.hk_mins(...)与 HTTP Restful API 两种单次限量最大 8000 行数据权限门槛120 积分可调取 2 次接口查看数据正式权限以 Tushare 官方权限说明为准值得说明的是hk_mins与仓库中同属 Tushare 技能目录的其他分钟类接口如 A 股 历史分钟stk_mins、指数 指数历史分钟idx_mins、期货 历史分钟行情ft_mins保持一致的参数风格与输出约定学习成本可以复用。受限前提说明单次请求最多返回 8000 行且受积分权限限制。这意味着一次请求通常无法覆盖全部历史分钟数据需要通过「股票代码 × 日期区间」组合循环抓取下文会给出标准做法。二、输入参数详解hk_mins共支持 4 个输入参数其中前两个为必选名称类型必选描述示例ts_codestrY股票代码必须带.HK后缀00001.HKfreqstrY分钟频度1minstart_datedatetimeN开始日期时间2023-03-13 09:00:00end_datedatetimeN结束日期时间2023-03-13 19:00:002.1 ts_code 代码规范港股代码统一为五位数字 .HK后缀的形式例如长江实业00001.HK、腾讯控股00700.HK。这与仓库内港股系列接口的约定完全一致港股实时日线rt_hk_k明确强调「ts_code 代码一定要带.HK后缀」港股日线行情hk_daily、港股复权行情hk_daily_adj同样使用00001.HK形式的代码。因此调用hk_mins时ts_code00001.HK中的后缀.HK不可省略。2.2 freq 频度参数说明freq是决定数据粒度的关键参数支持五种取值freq说明1min1 分钟5min5 分钟15min15 分钟30min30 分钟60min60 分钟在实际量化场景中选择粒度需要在信号灵敏度与数据体积/噪声之间权衡1min 数据适合日内高频策略与盘口微观结构分析但受 8000 行单次限量约束最明显约 34 个交易日的量60min 数据则适合做日内趋势过滤或与日线信号叠加单次可覆盖更长时间段。2.3 日期时间参数格式start_date与end_date使用YYYY-MM-DD HH:MM:SS格式如2023-03-13 09:00:00与 SKILL.md 中「参数格式说明」约定的日期规范YYYYMMDD略有区别——分钟接口要求精确到时分秒。若省略起止时间接口会按默认区间返回数据建议总是显式传入时间窗口以保证结果可复现。三、输出字段与数据语义hk_mins返回 pandas DataFrame字段定义如下名称类型默认显示描述ts_codestrY股票代码trade_timestrY交易时间openfloatY开盘价closefloatY收盘价highfloatY最高价lowfloatY最低价volintY成交量amountfloatY成交金额3.1 数据样例解读接口文档给出的真实样例数据2023-03-13 长实集团00001.HK全天分钟行情如下ts_code trade_time open close high low vol amount 0 00001.HK 2023-03-13 16:10:00 48.80 48.75 48.80 48.75 375500.0 18305625.0 1 00001.HK 2023-03-13 16:00:00 48.80 48.80 48.85 48.75 12000.0 585575.0 2 00001.HK 2023-03-13 15:59:00 48.80 48.80 48.80 48.75 12500.0 609825.0 3 00001.HK 2023-03-13 15:58:00 48.85 48.80 48.85 48.75 9500.0 463725.0 4 00001.HK 2023-03-13 15:57:00 48.80 48.80 48.85 48.75 24000.0 1171450.0 .. ... ... ... ... ... ... ... ... 327 00001.HK 2023-03-13 09:34:00 47.40 47.35 47.45 47.35 17000.0 805975.0 328 00001.HK 2023-03-13 09:33:00 47.55 47.40 47.55 47.40 11000.0 521725.0 329 00001.HK 2023-03-13 09:32:00 47.60 47.55 47.70 47.50 52500.0 2497550.0 330 00001.HK 2023-03-13 09:31:00 47.30 47.60 47.60 47.30 44229.0 2097256.7 331 00001.HK 2023-03-13 09:30:00 47.30 47.30 47.30 47.30 469900.0 22298550.0从样例中可以观察到几个对后续数据处理很有用的细节时间方向接口默认按交易时间倒序返回16:10 在前09:30 在后使用时建议先按trade_time升序排序再进入指标计算或回测管道避免前视偏差。盘中含盘后数据16:0016:10 的条目为港股收盘竞价时段16:00–16:10的成交记录建模时需根据策略定义决定是否保留。成交量单位vol以「股」为单位样例中 09:30 开盘分钟成交 46.99 万股amount以「元港币」为单位与 港股实时日线 的字段语义一致。四、接口用法Python SDK 实战4.1 标准调用示例根据接口文档最基础的调用方式如下import tushare as ts pro ts.pro_api() df pro.hk_mins( ts_code00001.HK, freq1min, start_date2023-03-13 09:00:00, end_date2023-03-13 19:00:00, ) print(df)4.2 初始化带 Token 的 pro 实例文档中的ts.pro_api()会隐式读取本地缓存的 token。在 Vibe-Trading 项目中更规范的初始化方式是显式读取环境变量中的 token。参照 Tushare 技能 SKILL.md 中的快速上手示例import os import tushare as ts # 读取环境变量中的 token或读取本地记录的 token token os.getenv(TUSHARE_TOKEN) or ts.get_token() # 初始化 pro 接口实例 pro ts.pro_api(token) # 获取港股分钟行情 df pro.hk_mins( ts_code00001.HK, freq5min, start_date2023-03-13 09:00:00, end_date2023-03-13 19:00:00, )仓库内的实际示例脚本 stock_data_example.py 也采用了同样的模式token get_env_config().data.tushare_token or ts.get_token()即优先读取项目环境配置中的 tushare_token其次回退到 tushare 本地 token 缓存然后再创建pro实例。这说明在 Vibe-Trading 中数据源凭据统一走环境配置通道TUSHARE_TOKEN环境变量是推荐的注入方式。4.3 HTTP Restful API 方式hk_mins同时支持 HTTP Restful API。Tushare 通用 POST 请求模型为向接口地址提交api_namehk_mins与参数体返回 JSON 结构中的data即行情数据。由于单次请求与 SDK 方式共享同一套参数与限量规则实际项目中选择哪种方式主要取决于调用端技术栈Python 后端首选 SDK跨语言服务如前端或脚本则用 Restful API。五、突破 8000 行限量循环分页抓取单次最大 8000 行是hk_mins的硬性限量文档明确「可以通过股票代码和日期循环获取」。对日频策略需要的完整历史分钟数据标准做法是按日期分片 循环累加import tushare as ts import pandas as pd pro ts.pro_api() codes [00001.HK, 00700.HK] # 多标的 freq 1min frames [] # 按交易日逐日抓取避开 8000 行上限 for code in codes: for day in [2023-03-13, 2023-03-14, 2023-03-15]: df pro.hk_mins( ts_codecode, freqfreq, start_datef{day} 09:00:00, end_datef{day} 16:30:00, ) if df is not None and not df.empty: frames.append(df) result pd.concat(frames, ignore_indexTrue) result result.sort_values(trade_time).reset_index(dropTrue) # 升序排列三个工程要点交易日来源循环中的交易日清单建议由 港股交易日历hk_tradecal接口生成is_open1才是交易日避免对休市日如台风休市、公众假期发起无效请求并白白消耗积分额度。去重若分片区间存在重叠合并后需按ts_code trade_time去重。时间范围港股交易时段为 09:30–12:00、13:00–16:00另含 16:00–16:10 收盘竞价抓取窗口设为 09:00–16:30 已能覆盖全部分钟记录。六、港股分钟数据在 Vibe-Trading 中的典型应用组合hk_mins在仓库的 Tushare 数据源技能体系中属于「港股数据」板块可与同板块接口组成完整的研究链路应用场景配合接口说明分钟级日内策略回测hk_mins 港股复权行情hk_daily_adj分钟行情做日内进出场日线复权行情含股本、市值、换手做背景过滤交易日历管理hk_mins 港股交易日历hk_tradecal用is_open字段自动生成有效抓取日期实时盘面确认hk_mins 港股实时日线rt_hk_k盘中实时日线快速确认趋势收盘后分钟数据用于精算跨市场对比hk_mins A 股 历史分钟stk_mins港股与 A 股分钟信号对照如 AH 联动注意两地交易时段差异关于数据口径的一致性仓库在 SKILL.md 的「参数格式说明」中统一了各接口约定日期用YYYYMMDD分钟接口内部精确到秒、股票代码统一ts_code格式、返回统一为 pandas DataFrame。因此把hk_mins的输出接入仓库内的因子计算或回测引擎时只需做常规的排序、去空值与类型转换无需额外的适配层。七、常见问题与最佳实践7.1 常见问题排查问题现象可能原因处理建议返回空 DataFramets_code缺.HK后缀、区间落在休市日、积分不足校验代码格式与交易日历检查权限数据倒序接口默认按时间倒序返回df.sort_values(trade_time, ascendingTrue)数据量超出 8000 行单次请求窗口过大按日或半日分片循环抓取token 报错未配置TUSHARE_TOKEN或积分不足os.getenv(TUSHARE_TOKEN)注入或ts.set_token()缓存7.2 最佳实践清单始终显式传时间窗口start_date/end_date精确到分钟保证结果确定性与可复现性先升序排序再建模避免接口倒序输出进入回测导致的前视偏差按交易日历循环用hk_tradecal生成抓取日期控制积分消耗选择合适 freq数据量敏感场景优先用 5min/60min微观结构研究再上 1min复用仓库技能文档更多港股接口细节可查阅 港股日线行情、港股复权因子 等文档与hk_mins配合构成完整数据底座。结语hk_mins为港股分钟级量化研究提供了标准化的数据入口。结合本文的接口参数说明、SDK 调用示例与循环分页方案配合 Vibe-Trading 仓库内 Tushare 数据源技能体系的 SKILL.md 总览文档开发者可以快速构建从「港股分钟行情抓取」到「日内策略回测」的完整数据链路。需要特别提醒的是正式权限、积分门槛与数据版权均以 Tushare 官方权限说明为准请在使用前确认账号权限与数据合规要求。【免费下载链接】Vibe-TradingVibe-Trading: Your Personal Trading Agent项目地址: https://gitcode.com/GitHub_Trending/vi/Vibe-Trading创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考