Vibe-Trading 港股基本面数据接入实战Tushare hk_cashflow 现金流量表接口完全指南【免费下载链接】Vibe-TradingVibe-Trading: Your Personal Trading Agent项目地址: https://gitcode.com/GitHub_Trending/vi/Vibe-Trading本文为 Vibe-Trading 个人交易 Agent 内置数据技能Tushare Skill中的港股财务数据接口实战指南核心围绕hk_cashflow接口展开。通过本文读者将完整掌握港股上市公司现金流量表数据的接口参数、调用方式、返回结构与数据解读方法并能在此基础上构建面向港股标的的盈利质量与现金流分析流程。接口概览从 Skill 注册表到hk_cashflow在 Vibe-Trading 仓库中Tushare 数据源以技能Skill形式组织其入口文档 SKILL.md 中维护了一张完整的数据接口列表覆盖行情、财务、宏观、基金、债券等数百个接口。其中接口 ID391接口名hk_cashflow接口标题港股现金流量表所属分类港股数据接口描述获取港股上市公司现金流量表数据该接口与同属港股财务数据族的 港股利润表hk_incomeID 390、港股资产负债表hk_balancesheetID 389、港股财务指标数据hk_fina_indicatorID 388共同构成港股三张报表的完整数据能力可满足港股基本面的量化研究、回测因子构建与实时分析需求。权限说明调用hk_cashflow需要单独开通接口权限或账户积分达到15000 分。该接口并非所有 Tushare 用户默认可用接入前请先在 Tushare 账户中确认权限状态避免运行时出现权限异常。数据特征当前接口按单只股票获取其历史数据单次请求最大返回 10000 行数据历史数据较长时可通过循环分页提取配合start_date/end_date参数分批拉取。输入参数详解hk_cashflow共支持 5 个输入参数其中仅ts_code为必选其余参数均可选用于精确筛选数据范围。名称类型必选描述ts_codestrY股票代码periodstrN报告期格式YYYYMMDDind_namestrN指标名如新增贷款start_datestrN报告期开始日期格式YYYYMMDDend_datestrN报告结束始日期格式YYYYMMDD各参数实战要点ts_code必选港股代码采用「数字代码 .HK」后缀格式例如腾讯控股为00700.HK。注意与 A 股代码格式如000001.SZ、600000.SH区分。如需获取全部港股代码清单可配合 港股基础信息hk_basic接口取得。period可选指定精确报告期格式为YYYYMMDD如20241231表示 2024 年年度报告。港股财年并非全部与自然年一致个别公司财报期可能为 3 月、6 月等截止日需按标的实际报告期传入。ind_name可选按财务科目名称过滤如新增借款、经营业务现金净额等。通过该参数可以一次性提取某一科目跨多个报告期的历史序列非常适合做指标时序分析。start_date/end_date可选报告期范围过滤。当需要拉取多年历史数据且单次请求可能超过 10000 行上限时用这两个参数配合循环分页最为稳妥。输出参数与返回结构接口返回为长表tidy结构的 pandas DataFrame每一行对应某只股票 某个报告期 某个财务科目的一条记录名称类型默认显示描述ts_codestrY股票代码end_datestrY报告期namestrY股票名称ind_namestrY财务科目名称ind_valuefloatY财务科目值需要特别理解的是长表结构同一报告期内现金流量表的所有科目数十个会被拆成多行返回通过ind_name字段区分科目、ind_value字段给出数值。这种结构天然适合用pivot操作将科目转置为列再与其他指标合并构建面板数据。仓库中的财务分析技能 financial-statement/SKILL.md 正是基于此类三表数据开展盈利质量与现金流分析。数据样例解读以腾讯控股 2024 年报为例原文档给出的数据样例为腾讯控股00700.HK2024 年度20241231现金流量表节选科目完整覆盖了经营、投资、融资三大活动非常适合用来理解港版现金流科目命名习惯ts_code end_date name ind_name ind_value 0 00700.HK 20241231 腾讯控股 除税前溢利(业务利润) 2.414850e11 ... 11 00700.HK 20241231 腾讯控股 营运资金变动前经营溢利 2.828240e11 19 00700.HK 20241231 腾讯控股 经营产生现金 3.047050e11 21 00700.HK 20241231 腾讯控股 经营业务现金净额 2.585210e11 ... 32 00700.HK 20241231 腾讯控股 投资业务现金净额 -1.221870e11 44 00700.HK 20241231 腾讯控股 融资业务现金净额 -1.764940e11 45 00700.HK 20241231 腾讯控股 现金净额 -4.016000e10 ... 49 00700.HK 20241231 腾讯控股 应收帐款减少 -1.048000e09经营业务CFO部分从除税前溢利业务利润出发经过利息支出、折旧及摊销5.621300e10、减值及拨备等加回项以及投资收益、汇兑收益、出售资产之溢利等减除项得到营运资金变动前经营溢利2.828240e11再叠加存货、应收应付、递延收入等营运资本变动得到经营产生现金3.047050e11扣除已付税项4.618400e10后最终得到经营业务现金净额2.585210e11。该数值与利润表中的股东应占溢利1.940730e11见 港股利润表 样例明显同向且规模相当符合净利润 ≈ CFO长期来看的黄金公式。投资业务CFI部分涵盖已收利息、已收股息投资、存款减少增加、购建无形资产及其他资产、收购附属公司、收回投资所得现金等科目最终投资业务现金净额为-1.221870e11反映了公司持续对外扩张投资的现金流出特征。融资业务CFF部分包含新增借款1.145840e11、偿还借款1.146910e11、已付利息融资、已付股息融资、回购股份1.057510e11、赎回债券、偿还融资租赁等科目最终融资业务现金净额为-1.764940e11。腾讯 2024 年大规模回购与派息直接体现在该板块。勾稽关系验证按financial-statement/SKILL.md中的勾稽公式期末现金 期初现金 CFO CFI CFF 1.325190e11 ≈ 1.723200e11 2.585210e11 (-1.221870e11) (-1.764940e11)三者之和与期末现金高度吻合说明该接口数据可用于跨报表一致性校验。这也印证了 financial-statement/SKILL.md 中三表勾稽关系章节的实操价值——将现金流量表与利润表、资产负债表联合使用可检验财务数据质量、识别盈利质量异常。接口用法与代码实战原文档给出的标准调用方式如下pro ts.pro_api() # 获取腾讯控股00700.HK股票的2024年度现金流量表数据 df pro.hk_cashflow(ts_code00700.HK, period20241231) # 获取腾讯控股00700.HK股票历年新增借款数据 df pro.hk_cashflow(ts_code00700.HK, ind_name新增借款)进阶一带 token 的完整初始化参照仓库示例脚本 scripts/stock_data_example.py 与 SKILL.md 的快速上手章节生产环境建议显式传入 token从环境变量或本地配置读取而非依赖默认配置import os import tushare as ts # 方式一环境变量推荐 token os.getenv(TUSHARE_TOKEN) # 方式二仓库示例脚本采用的配置读取方式见 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) df pro.hk_cashflow(ts_code00700.HK, period20241231) print(df)在 Vibe-Trading 项目中Token 可通过 Tushare 官网注册获取后配置环境变量TUSHARE_TOKEN参照 SKILL.md 中的export TUSHARE_TOKENyour_token说明或复用项目配置体系中tushare_token的读取逻辑。进阶二长表转宽表构建指标面板由于接口返回长表结构做跨报告期分析时通常需要透视# 获取腾讯控股 2022-2024 三个年度的全部现金流量表数据 df pro.hk_cashflow(ts_code00700.HK, start_date20220101, end_date20241231) # 透视行 报告期列 财务科目 pivot df.pivot_table(indexend_date, columnsind_name, valuesind_value, aggfuncfirst) print(pivot[[经营业务现金净额, 投资业务现金净额, 融资业务现金净额, 现金净额, 期末现金]])进阶三按报告期循环分页提取全历史对于上市时间长的标的单只股票全历史数据可能超过 10000 行的单次上限。此时应结合start_date/end_date按年度或按区间循环提取再concat合并import pandas as pd pro ts.pro_api(token) frames [] for year in range(2010, 2025): start, end f{year}0101, f{year}1231 part pro.hk_cashflow(ts_code00700.HK, start_datestart, end_dateend) if part is not None and not part.empty: frames.append(part) full pd.concat(frames, ignore_indexTrue) print(f共提取 {len(full)} 行记录报告期范围, full[end_date].min(), ~, full[end_date].max())实战应用将港股现金流数据接入 Agent 分析流程在 Vibe-Trading 的 Agent 体系内Tushare Skill 作为标准化的数据资产服务入口详见 SKILL.md 概述其港股财务数据可直接服务于以下分析场景盈利质量检验结合 financial-statement/SKILL.md 中的现金流质量矩阵CFO/CFI/CFF 正负组合判断企业处于优秀、扩张、危险还是困境状态对港股标的进行现金流画像。例如样例中腾讯 CFO 为正、CFI/CFF 为负 的组合对应优秀赚钱、投资、还债/回报股东状态。应计比率计算利用经营业务现金净额与利润表中净利润的差构造应计比率accrual_ratio (net_income - cfo) / total_assets识别盈利质量恶化信号。跨市场对照A 股对应接口为 股票数据/财务数据/现金流量表.mdcashflow美股对应 美股现金流量表.mdus_cashflow。由于 A 股采用中国会计准则、港股/美股采用 IFRS/US GAAP科目名称与口径存在差异跨市场比较前需要做科目映射与口径调整——这一点在 financial-statement/SKILL.md 的财报会计准则差异说明中亦有提示。回购与分红跟踪通过回购股份、已付股息(融资)等科目筛选高股东回报标的可作为价值型策略的补充信号。相关接口与延伸阅读场景接口文档港股利润表hk_income港股利润表港股资产负债表hk_balancesheet港股资产负债表港股财务指标hk_fina_indicator港股财务指标数据港股基础信息hk_basic港股基础信息港股行情hk_daily港股日线行情A股现金流量表cashflow现金流量表美股现金流量表us_cashflow美股现金流量表常见问题与注意事项权限不足报错提示权限问题时请检查 Tushare 账户积分需 15000 分或单独开通hk_cashflow接口权限可用官方数据工具在线调试接口确认数据与权限状态。代码格式港股代码必须带.HK后缀如00700.HK与 A 股、美股代码体系不同混淆会导致查无数据。长表与透视返回的是科目 × 报告期的长表分析前建议用pivot_table转宽并用ind_name精确匹配科目名称如经营业务现金净额、期末现金。单次行数上限单次最多返回 10000 行全历史拉取务必按start_date/end_date分片循环。财年口径港股公司财年截止日不统一period参数请按目标公司的实际报告期传入避免与自然年混用。至此从接口注册信息、参数语义、返回结构、代码调用到财务分析实战hk_cashflow接口的完整链路已经打通。读者可直接基于本文示例在 Vibe-Trading 的 Agent 工作流中构建属于自己的港股现金流分析模块。【免费下载链接】Vibe-TradingVibe-Trading: Your Personal Trading Agent项目地址: https://gitcode.com/GitHub_Trending/vi/Vibe-Trading创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考