QVeris
金融数据 API 指南

免费现金流量表 API
数据、公式与示例

查找、比较并验证现金流量表数据,
用于筛选、估值、研究与自动化财务分析。

Hand-drawn free cash flow statement API workflow from request and cash flow fields to FCF calculation and data quality checks

核心摘要

现金流量表 API 应完整保留现金在经营、投资和融资活动中的变化,并能从期初现金勾稽到期末现金。自由现金流属于根据部分报表科目计算的衍生指标,并非所有企业都会直接披露。可靠的接入方案应保留原始现金流量表,明确所采用的自由现金流公式,并避免混用累计期间与单季度数据。

定义

免费现金流量表 API 提供计算所需的财务报表字段,用于得出企业扣除资本性支出后的现金流。

核心公式

按常用核心口径,以经营活动产生的现金流量净额减去资本性支出。

数据检查

核对报告期、币种、单位、报表提交日期、重述情况,以及供应商采用的正负号规则。

QVeris 的作用

QVeris 帮助智能体发现并核查金融 API,以便在接入前选择合适的接口端点和供应商。

如何使用 API 数据计算自由现金流

应从现金流量表字段入手,而不是依赖供应商预先计算的指标。企业自由现金流的常用公式为:经营活动现金流减去资本性支出。如果 API 将资本性支出这一现金流出记为负值,计算时应加上这个带符号的数值,而不是再次相减。代码中还应明确记录正负号约定、纳入哪些长期资产购置、资本化软件如何处理,以及是否排除并购支出。有杠杆自由现金流、无杠杆自由现金流和股权自由现金流属于不同指标,不能共用一个未注明口径的字段。

年度计算示例

经营活动现金流为 12.5 亿美元、资本性支出为 4.5 亿美元时,自由现金流为 8 亿美元。

滚动十二个月口径

应汇总同一版财务报表中四个互不重叠季度的数据,不得将全年数据与已包含在其中的季度数据混合计算。

单季度与年初至今累计期间

许多中期申报文件披露的是从财年开始累计至今的现金流。只有两个累计期间在会计范围、币种和文件口径上完全兼容时,才能通过相减得到单季度数据。

不同自由现金流公式

有些分析采用购建固定资产的全部现金支出,有些使用净资本性支出,或把处置长期资产所得计入计算。应保存公式版本和构成项,避免把口径不同的自由现金流序列直接比较。

实算示例:发布自由现金流前先完成现金勾稽

假设 API 以正数表示现金流入、负数表示现金流出。公司期初现金为 3 亿美元,本期经营活动现金流 5 亿美元、投资活动现金流 -2.4 亿美元、融资活动现金流 -1 亿美元,汇率影响为 -0.1 亿美元。投资活动现金流中包含 -1.8 亿美元资本性支出,以及单独列示的 -0.6 亿美元并购付款。

核对项目计算结果与含义
期末现金300 + 500 - 240 - 100 - 10 = 4504.5 亿美元;在采用相同现金定义时,应与现金流量表合计及资产负债表一致。
标准自由现金流500 + (-180) = 3203.2 亿美元;资本性支出已按流出记为负数,因此与经营现金流相加,并购付款仍单独保留。
现金净变动450 - 300 = 1501.5 亿美元;它与自由现金流不同,因为融资、并购、其他投资活动及汇率变化也会影响现金。

自由现金流计算正确,并不等于整张现金流量表完整。应同时保留公式构成项、来源期间、申报版本、币种、单位和勾稽差额。若期末现金无法勾稽,应暂停发布衍生指标并进入复核,不能返回一个表面完整却无法审计的数值。

免费现金流量表 API 应返回哪些字段

字段含义用途验证要点
经营活动现金流核心经营活动产生的现金流量。计算标准自由现金流的起始值。需谨慎映射 GAAP 与 IFRS 的科目标签。
资本性支出用于购置或改良长期资产的现金支出。计算时从经营活动现金流中扣除。确认供应商采用的正负号规则。
投资活动现金流长期资产购置与处置、并购、投资和投资退出。区分经常性资本投入与战略性交易。不能把并购支出当作普通资本性支出。
融资活动现金流债务融资与偿还、股息、股票回购和股权融资。解释企业如何分配现金,或如何补充资金。区分债务本金与利息的现金流分类。
现金余额勾稽期初现金、净变动、汇率影响、受限现金和期末现金。验证现金流量表是否完整。与资产负债表采用相同的现金口径。
报告期信息财务报告期、期初日期、期末日期和报表提交日期。用于避免报告期相互重叠造成的错误。各发行人的财年安排可能不同。
数据标准化信息币种、计量单位、原始申报文件和重述状态。支持数据比较和审计追踪。缺少计量单位信息时,不得擅自推断。

如何评估免费现金流量表 API 服务商

覆盖范围与期间构造

核对 API 覆盖的交易所和公司类型、季度历史数据深度、是否纳入已退市证券,以及股票代码变更后历史报表能否继续访问。同时确认季度值属于单季度还是累计期间,以及滚动期间如何构造。

字段明细与正负号约定

不能只测试经营活动现金流合计,还应检查营运资本调整、非现金费用、资本性支出、并购、债务、股息、回购、汇率影响,以及现金流出采用何种正负号。

数据血缘与修订版本

优先选择能够提供来源文件、申报编号或文档链接、监管系统接收日期、列示币种、标准化状态和修订版本的 API,并用原始构成项抽样复算合计数。

运维能力与许可适配

实测分页、历史回填时间、限流行为和更新延迟,并核对缓存、来源标注、再分发与商业使用权。即使公式正确,数据许可也可能不适合计划中的产品。

从 API 响应构建可审计的自由现金流序列

生产接入不能只保存最后算出的自由现金流,而应先完整保留现金流量表。一次响应中可能同时出现年度数据、中期累计数据、重述后的比较期数据和供应商标准化字段。应先把这些记录区分开,只有经营活动现金流与资本性支出在发行人、报告期、币种、单位、会计范围和来源版本上完全一致时,才能用于计算自由现金流。

1. 保存来源报表与获取背景

保存原始响应、请求参数、供应商、获取时间、来源文件或文档 ID、监管系统接收时间、修订状态、报告币种、单位和标准化标记。原始值应与标准化值并列保留,使后续字段映射调整仍然可以解释。

2. 统一期间与正负号,但不丢失原始含义

把每条记录明确归类为年度、单季度或年初至今累计数据。可以在内部统一现金流入与流出的正负号,但必须保留供应商原始符号。资本性支出已经以负数返回时不能再次相减,九个月累计值也不能被标成第三季度单季数据。

3. 完成计算与现金勾稽

使用口径兼容的构成项计算选定的自由现金流,并附上公式版本。同时独立核对期初现金、经营、投资、融资活动现金流、汇率影响和其他明确调整是否能够勾稽到期末现金,再使用相同的现金与受限现金定义和资产负债表核对。

4. 使用固定样本完成验收

样本应覆盖工业企业、银行、资本密集型公司、发生并购的企业、财年与自然年不一致的发行人,以及后来提交修订文件的公司。逐项验证报表合计、单季度推导、公式结果、空值处理、重述行为和来源链接,并保存预期结果与容差,以便自动发现供应商或解析器后续发生的变化。

使用 QVeris 发现合适的金融数据 API

QVeris 为智能体提供统一的发现层,用于查找并核查现金流、监管文件和财务报表能力。智能体可以先比较报告期参数、数据结构和调用要求,再决定调用哪个接口,而不必直接围绕找到的第一个端点编写代码。应用方仍需负责期间构造、正负号统一、公式选择、现金余额勾稽,以及自由现金流结论所附带的证据。

  • 按用途搜索现金流量表相关数据接口,而不局限于供应商的产品名称。
  • 将接口接入生产代码前,先检查输入参数和响应字段。
  • 使用稳定的内部财务报表模型,封装各供应商特有的数据转换逻辑。

常见问题

财务报表通常会直接披露自由现金流吗?

不一定。许多 API 会根据财报披露的经营活动现金流和资本性支出计算自由现金流,因此不同供应商对这一指标的定义可能有所不同。

可以免费获取自由现金流数据吗?

部分供应商提供免费套餐,但数据覆盖范围、请求频率限制、历史数据跨度和更新速度各不相同,使用前应核对最新条款。

为什么现金流与净利润不同?

现金流会在权责发生制利润基础上调整非现金项目和营运资本变化,并单独记录投资与融资现金活动。两者存在差异是正常现象,而且往往具有重要分析价值。

如何验证现金流量表?

使用一致的现金与受限现金定义,把期初现金、经营、投资、融资活动现金流和汇率影响勾稽到期末现金,并与资产负债表核对。

并购支出应计入资本性支出吗?

在“经营活动现金流减资本性支出”的常用口径中通常不计入。企业并购应单独保留;若采用所有者收益或并购调整后现金流等更宽口径,需要明确说明公式。

健康企业的自由现金流也可能为负吗?

可能。大规模投资、营运资本增加或收付款时点都可能导致自由现金流为负。分析时应查看构成和持续时间,而不能只凭正负号下结论。

外部参考链接

免费现金流量表 API 数据、公式与示例 | QVeris Guides