Vibe-Trading 港股实时日线数据接入：Tushare rt_hk_k 接口通配符取数与盘中监控实战

Vibe-Trading 港股实时日线数据接入Tushare rt_hk_k 接口通配符取数与盘中监控实战【免费下载链接】Vibe-TradingVibe-Trading: Your Personal Trading Agent项目地址: https://gitcode.com/GitHub_Trending/vi/Vibe-Trading港股市场实行 T0 交易且日内波动频繁实时行情是盘中监控、异动预警与短周期策略的重要数据源。本文以仓库内 Tushare 技能文档 为核心骨架系统讲解 Vibe-Trading 项目中对 Tusharert_hk_k接口的调用方式从 token 初始化、.HK后缀与通配符代码语法、8 个输出字段的业务含义到单股取数、全市场批量快照、盘中轮询监控的完整实战代码。读完本文你将能够在 Vibe-Trading 环境中独立搭建一条港股实时日线数据链路并理解它与hk_daily历史行情接口的定位差异。接口概览rt_hk_k 是什么在 Tushare 技能文档 的数据接口列表中rt_hk_k的登记信息如下项目内容接口名rt_hk_kID 383分类港股数据官方描述获取港股实时日 k 线行情支持按股票代码及股票代码通配符一次性提取全部股票实时日 k 线行情数据时效盘中实时当日开盘以来滚动更新的日线快照限量单次最大可提取 5000 条数据权限单独开权限的数据接口需单独申请权限与收盘后批量入库的hk_daily不同rt_hk_k返回的是从今日开盘到当前时刻的实时日线截面数据每一行代表一只港股在当日的实时 OHLC 快照。由于支持通配符一个请求即可拉取港股全市场的当日实时状态天然适合做全市场扫描。环境准备token 初始化与 pro 接口在调用任何 Tushare 数据接口前需要先完成 SDK 安装与 token 配置。根据 SKILL.md 中的快速上手说明推荐 Python 3.7 环境可优先从清华 PyPI 镜像安装pip install tushare -i https://pypi.tuna.tsinghua.edu.cn/simple在 Tushare 官网注册后获取 token并配置环境变量export TUSHARE_TOKENyour_token仓库中的 股票数据获取示例脚本 展示了项目内标准的数据访问方式——先读取环境变量中的 token支持get_env_config().data.tushare_token或ts.get_token()再初始化 pro 接口import tushare as ts import os from src.config.accessor import get_env_config # 读取环境变量中的 token, 或者读取本地记录的 token token get_env_config().data.tushare_token or ts.get_token() # 初始化 pro 接口实例 pro ts.pro_api(token)初始化完成后pro.rt_hk_k(...)即可直接调用港股实时日线接口。输入参数ts_code 与通配符语法rt_hk_k只有一个输入参数但这一参数承载了接口最核心的能力——通配符批量取数。名称类型必选描述ts_codestrY支持通配符方式e.g.00001.HK、02*.HK使用要点必须携带.HK后缀ts_code代码一定要带.HK后缀否则无法正确路由到港交所代码空间。这与项目内港股00700.HK零填充至 5 位的代码约定一致。精确查询传完整代码如00001.HK获取单只股票的实时日线。通配符查询使用*匹配任意字符序列例如01*.HK匹配所有以01开头的港股代码02*.HK匹配所有02开头的代码。接口文档给出的示例即用01*.HK一次性提取今日开盘以来部分港股实时日线。全市场提取由于通配符可以覆盖全部代码形态结合 5000 条的限量覆盖全部在交易港股绰绰有余理论上一个请求即可拉取港股全市场实时快照。输出参数全解析rt_hk_k返回 8 个字段全部默认显示名称类型默认显示描述ts_codestrY股票代码带 .HK 后缀pre_closefloatY昨收价closefloatY收盘价盘中为当前最新价highfloatY最高价当日截至目前的最高价openfloatY开盘价lowfloatY最低价当日截至目前的最低价volfloatY成交量股amountfloatY成交额元字段的业务解读结合接口文档的数据示例OHLC 语义open为今日开盘价high/low为开盘以来至今的日内最高 / 最低价close在盘中表示最新成交价收盘后等同于收盘价。由此可计算当日涨跌幅(close - pre_close) / pre_close。量额单位vol单位是股sharesamount单位是元港币计价。由二者可得全市场均价的近似值amount / vol。无成交股票的哨兵值数据示例中01653.HK一行close0.0、vol0.0、amount0.0而pre_close0.260说明该股当日尚无成交停牌或尚未开市处理时应将其视为今日无成交而非真实价格为 0否则会误算涨跌幅。返回值形态与 Tushare 其他接口一致返回 pandas DataFrame行索引为记录序号可直接与 pandas 生态无缝衔接。接口文档给出的数据示例节选通配符查询结果共 751 行ts_code pre_close close high open low vol amount 0 01508.HK 1.040 1.030 1.050 1.040 1.030 14971000.0 15564320.00 1 01314.HK 0.210 0.211 0.211 0.210 0.210 40000.0 8420.00 2 01848.HK 3.940 3.910 3.950 3.940 3.890 300500.0 1176380.00 ... 746 01653.HK 0.260 0.000 0.000 0.000 0.000 0.0 0.00 747 01729.HK 5.440 5.790 5.800 5.440 5.380 6778621.0 37845706.87实战一单股实时日线获取接口文档给出的标准调用如下获取特定股票的实时日线# 获取特定股票实时日线 df pro.rt_hk_k(ts_code00001.HK) # 获取今日开盘以来部分港股实时日线 df pro.rt_hk_k(ts_code01*.HK)将其封装为带异常处理的函数便于在策略与监控脚本中复用def get_hk_realtime_daily(ts_code: str): 获取港股实时日线rt_hk_k ts_code: 单只代码(00001.HK) 或 通配符(01*.HK) try: df pro.rt_hk_k(ts_codets_code) if df is None or df.empty: print(f无数据返回: {ts_code}) return None # 派生盘中涨跌幅 df[pct_chg] (df[close] - df[pre_close]) / df[pre_close] * 100 return df except Exception as e: print(f获取港股实时日线失败 ({ts_code}): {e}) return None注意对close0的无成交股票计算涨跌幅前应过滤或置空避免-100%的假信号。实战二全市场批量快照与盘中轮询监控通配符接口最常见的用途是全市场扫描。由于单次限量 5000 条且覆盖全部在交易港股可以这样拉取全市场快照# 提取港股全市场实时日线快照单次请求 market_snapshot pro.rt_hk_k(ts_code*.HK)在盘中做定时轮询即可构建简单的异动监控import time import datetime def monitor_hk_market(interval_seconds60, max_rounds120): 盘中轮询港股全市场实时快照输出当日涨幅榜前 10 for i in range(max_rounds): now datetime.datetime.now() df pro.rt_hk_k(ts_code*.HK) if df is not None and not df.empty: live df[df[close] 0].copy() live[pct_chg] (live[close] - live[pre_close]) / live[pre_close] * 100 top live.nlargest(10, pct_chg)[[ts_code, close, pre_close, pct_chg, amount]] print(f[{now:%H:%M:%S}] 全市场 {len(live)} 只有效成交涨幅榜前10) print(top.to_string(indexFalse)) time.sleep(interval_seconds) # 调用前需确保 pro 已初始化 # monitor_hk_market(interval_seconds60)建议将轮询结果持久化到 DataFrame 并追加保存盘中结束时即获得一份完整的当日逐笔快照序列可直接与收盘后入库的hk_daily数据做交叉校验。数据边界与适用场景与 hk_daily 历史行情的定位差异仓库 港股日线行情文档 明确了hk_daily的定位获取港股每日增量与历史行情每日 18 点左右更新当日数据单次最大提取 5000 行记录可多次提取总量不限制且该接口同样需要单独开权限。两者对比如下维度rt_hk_k实时日线hk_daily日线行情数据时效盘中实时滚动收盘后约 18 点更新时间范围仅当日快照历史全量 每日增量取数方式单只 / 通配符一次拉全市场按代码、按日期或日期区间输出字段8 个OHLC 量额 昨收10 个多出 trade_date、change、pct_chg典型用途盘中监控、异动预警历史回测、收盘后归档因此正确的数据链路是盘中用rt_hk_k做实时监控收盘后用hk_daily拉取并归档当日正式数据二者结合覆盖完整的数据闭环。与配套港股接口联动在 Tushare 技能目录 的港股数据分类下rt_hk_k与其他接口可组合出更完整的港股研究链路港股基础信息hk_basic获取港股列表、名称、交易单位、ISIN、货币代码等基础信息可将实时快照中的ts_code关联出股票名称与交易单位。港股交易日历hk_tradecal返回cal_date、is_open、pretrade_date用于判断当日是否为港股交易日避免非交易日的空轮询。港股日线行情hk_daily收盘后正式归档数据输出多出trade_date、change、pct_chg三个字段字段描述中的pct_chg为涨跌幅(%)。港股复权因子hk_adjfactor与港股复权行情hk_daily_adj中长期策略需复权处理时使用。典型组合用法先用hk_basic()拿到全部在交易港股列表 → 盘中用rt_hk_k(ts_code*.HK)拉实时快照并关联名称 → 收盘后用hk_daily(trade_date...)归档 → 用hk_tradecal判断下一个交易日。在 Vibe-Trading 项目中的落地方式本仓库将 Tushare 封装为 Agent 可调用的数据源技能入口为 agent/src/skills/tushare/SKILL.md。该技能文档以统一格式登记了全部数据接口含接口 ID、名称、标题链接、分类、描述其中rt_hk_k的登记 ID 为 383接口文档位于 agent/src/skills/tushare/references/港股数据/港股实时日线.md。references/目录下按业务分类存放各接口的详细参数与示例文档港股数据分类下共收录 11 个港股相关接口文档。调用数据时可参考仓库提供的 股票数据获取示例脚本 的编码范式读取 token →ts.pro_api(token)初始化 → 在try/except中调用接口 → 打印并返回 DataFrame。整个数据源技能通过标准化 API 统一对外服务帮助 Agent 更实时、简洁、轻量地获取行情与基本面数据。常见问题与注意事项必须带.HK后缀rt_hk_k要求ts_code必须携带.HK后缀如00001.HK不带后缀或使用其他市场后缀无法正确取数。权限问题本接口是单独开权限的数据需要按 Tushare 权限列表单独申请未开通权限会报权限错误而非参数错误。5000 条限量单次最大 5000 条覆盖全部在交易港股绰绰有余如需更细粒度处理可用0*.HK、1*.HK、2*.HK分段拉取避免一次请求过大。停牌 / 无成交股close、high、low、vol、amount可能为 0属正常业务状态而非数据缺失计算涨跌幅前务必过滤。数据时效盘中返回的是实时快照收盘后调用得到当日最终数据若需要含change、pct_chg的正式字段请使用收盘后更新的hk_daily。日期格式约定项目内 Tushare 技能的日期参数统一使用YYYYMMDD格式如20241231股票代码使用带后缀的ts_code格式返回格式统一为 pandas DataFrame这些约定在编写跨接口调用代码时需保持一致。【免费下载链接】Vibe-TradingVibe-Trading: Your Personal Trading Agent项目地址: https://gitcode.com/GitHub_Trending/vi/Vibe-Trading创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考