Free Cash Flow Statement API
Data, Formula & Examples免费现金流量表 API
数据、公式与示例
Find, compare, and validate cash flow statement data for screening, valuation, research, and automated financial analysis.
查找、比较并验证现金流量表数据，
用于筛选、估值、研究与自动化财务分析。
TL;DR核心摘要
A cash flow statement API should preserve how cash moved through operating, investing, and financing activities and reconcile opening cash to closing cash. Free cash flow is a derived measure built from selected statement fields, not a universally reported line item. A trustworthy integration therefore keeps the reported cash-flow statement intact, documents the chosen free-cash-flow formula, and avoids mixing cumulative and standalone periods.
现金流量表 API 应完整保留现金在经营、投资和融资活动中的变化，并能从期初现金勾稽到期末现金。自由现金流属于根据部分报表科目计算的衍生指标，并非所有企业都会直接披露。可靠的接入方案应保留原始现金流量表，明确所采用的自由现金流公式，并避免混用累计期间与单季度数据。
A free cash flow statement API exposes the statement inputs needed to calculate cash generated after capital investment.
For the standard headline measure, subtract capital expenditures from net cash provided by operating activities.
Confirm reporting period, currency, units, filing date, restatements, and the provider's sign convention.
QVeris helps agents discover and inspect financial APIs before committing to an endpoint or provider.
免费现金流量表 API 提供计算所需的财务报表字段，用于得出企业扣除资本性支出后的现金流。
按常用核心口径，以经营活动产生的现金流量净额减去资本性支出。
核对报告期、币种、单位、报表提交日期、重述情况，以及供应商采用的正负号规则。
QVeris 帮助智能体发现并核查金融 API，以便在接入前选择合适的接口端点和供应商。
How to calculate free cash flow from API data如何使用 API 数据计算自由现金流
Start with the cash flow statement, not a provider's precomputed ratio. The usual company-level formula is free cash flow equals operating cash flow minus capital expenditures. If an API returns capital expenditure as a negative cash outflow, add the signed value instead of subtracting it again. Document the sign convention, included asset purchases, treatment of capitalized software, and whether acquisitions are excluded. Levered free cash flow, unlevered free cash flow, and free cash flow to equity are different measures and should not share one unlabeled field.
应从现金流量表字段入手，而不是依赖供应商预先计算的指标。企业自由现金流的常用公式为：经营活动现金流减去资本性支出。如果 API 将资本性支出这一现金流出记为负值，计算时应加上这个带符号的数值，而不是再次相减。代码中还应明确记录正负号约定、纳入哪些长期资产购置、资本化软件如何处理，以及是否排除并购支出。有杠杆自由现金流、无杠杆自由现金流和股权自由现金流属于不同指标，不能共用一个未注明口径的字段。
Operating cash flow of $1.25 billion and capital expenditures of $450 million produce $800 million of free cash flow.
Sum four non-overlapping quarters from the same statement version. Do not mix fiscal-year results with one of their component quarters.
Many interim filings report cumulative cash flow from the start of the fiscal year. Derive a standalone quarter only by subtracting compatible cumulative periods with the same scope, currency, and filing basis.
Some analysts subtract total purchases of property and equipment; others use net capital expenditure or add proceeds from asset sales. Store the formula version and components so two free-cash-flow series are not compared as if they were identical.
经营活动现金流为 12.5 亿美元、资本性支出为 4.5 亿美元时，自由现金流为 8 亿美元。
应汇总同一版财务报表中四个互不重叠季度的数据，不得将全年数据与已包含在其中的季度数据混合计算。
许多中期申报文件披露的是从财年开始累计至今的现金流。只有两个累计期间在会计范围、币种和文件口径上完全兼容时，才能通过相减得到单季度数据。
有些分析采用购建固定资产的全部现金支出，有些使用净资本性支出，或把处置长期资产所得计入计算。应保存公式版本和构成项，避免把口径不同的自由现金流序列直接比较。
Worked example: reconcile cash before publishing free cash flow实算示例：发布自由现金流前先完成现金勾稽
Assume the API uses positive numbers for inflows and negative numbers for outflows. The company begins the period with $300m of cash. It reports $500m of operating cash flow, -$240m of investing cash flow, -$100m of financing cash flow, and a -$10m foreign-exchange effect. Investing cash flow includes -$180m of capital expenditure and a separate -$60m acquisition payment.
假设 API 以正数表示现金流入、负数表示现金流出。公司期初现金为 3 亿美元，本期经营活动现金流 5 亿美元、投资活动现金流 -2.4 亿美元、融资活动现金流 -1 亿美元，汇率影响为 -0.1 亿美元。投资活动现金流中包含 -1.8 亿美元资本性支出，以及单独列示的 -0.6 亿美元并购付款。
| Check核对项目 | Calculation计算 | Result and meaning结果与含义 |
|---|---|---|
| Closing cash期末现金 | 300 + 500 - 240 - 100 - 10 = 450 | $450m; this must match the statement total and the balance sheet under the same cash definition.4.5 亿美元；在采用相同现金定义时，应与现金流量表合计及资产负债表一致。 |
| Standard free cash flow标准自由现金流 | 500 + (-180) = 320 | $320m; because capex is already signed as an outflow, add it to operating cash flow. The acquisition payment remains separate.3.2 亿美元；资本性支出已按流出记为负数，因此与经营现金流相加，并购付款仍单独保留。 |
| Net change in cash现金净变动 | 450 - 300 = 150 | $150m; it differs from free cash flow because financing, acquisitions, other investing flows, and FX also move cash.1.5 亿美元；它与自由现金流不同，因为融资、并购、其他投资活动及汇率变化也会影响现金。 |
A correct FCF number does not prove the statement is complete. Publish the formula components, source period, filing version, currency, units, and reconciliation difference. If closing cash fails to reconcile, hold the derived metric for review instead of returning a polished but unauditable value.
自由现金流计算正确，并不等于整张现金流量表完整。应同时保留公式构成项、来源期间、申报版本、币种、单位和勾稽差额。若期末现金无法勾稽，应暂停发布衍生指标并进入复核，不能返回一个表面完整却无法审计的数值。
Fields a free cash flow statement API should return免费现金流量表 API 应返回哪些字段
| Field字段 | Meaning含义 | Use用途 | Validation验证要点 |
|---|---|---|---|
| Operating cash flow经营活动现金流 | Cash generated by core operations.核心经营活动产生的现金流量。 | The starting value for standard FCF.计算标准自由现金流的起始值。 | Map GAAP and IFRS labels carefully.需谨慎映射 GAAP 与 IFRS 的科目标签。 |
| Capital expenditures资本性支出 | Cash used to acquire or improve long-lived assets.用于购置或改良长期资产的现金支出。 | Subtracted from operating cash flow.计算时从经营活动现金流中扣除。 | Confirm the provider's sign convention.确认供应商采用的正负号规则。 |
| Investing cash flow投资活动现金流 | Asset purchases and sales, acquisitions, investments, and disposals.长期资产购置与处置、并购、投资和投资退出。 | Separates recurring capital needs from strategic transactions.区分经常性资本投入与战略性交易。 | Do not classify acquisitions as ordinary capex.不能把并购支出当作普通资本性支出。 |
| Financing cash flow融资活动现金流 | Debt issuance and repayment, dividends, repurchases, and equity issuance.债务融资与偿还、股息、股票回购和股权融资。 | Explains how cash generation is distributed or funded.解释企业如何分配现金，或如何补充资金。 | Separate debt principal from interest classification.区分债务本金与利息的现金流分类。 |
| Cash reconciliation现金余额勾稽 | Opening cash, net change, FX effect, restricted cash, and closing cash.期初现金、净变动、汇率影响、受限现金和期末现金。 | Validates statement completeness.验证现金流量表是否完整。 | Match the cash definition to the balance sheet.与资产负债表采用相同的现金口径。 |
| Period metadata报告期信息 | Fiscal period, start date, end date, and filing date.财务报告期、期初日期、期末日期和报表提交日期。 | Prevents overlapping-period errors.用于避免报告期相互重叠造成的错误。 | Fiscal calendars vary by issuer.各发行人的财年安排可能不同。 |
| Normalization metadata数据标准化信息 | Currency, units, source filing, and restatement status.币种、计量单位、原始申报文件和重述状态。 | Supports comparisons and audit trails.支持数据比较和审计追踪。 | Never infer missing units silently.缺少计量单位信息时，不得擅自推断。 |
How to evaluate free cash flow API providers如何评估免费现金流量表 API 服务商
Check exchanges, company types, quarterly depth, delisted securities, and whether historical statements remain available after symbol changes. Confirm whether quarterly values are standalone or cumulative and how trailing periods are built.
Test more than headline operating cash flow. Inspect working-capital adjustments, non-cash charges, capital expenditures, acquisitions, debt, dividends, repurchases, FX effects, and how cash outflows are signed.
Prefer responses that identify the source filing, accession or document link, accepted date, reported currency, normalization status, and amendment version. Recalculate selected totals from reported components.
Measure pagination, backfill time, rate-limit behavior, update delay, caching rights, attribution, redistribution, and commercial use. A formula can be correct while the data license is unsuitable for the product.
核对 API 覆盖的交易所和公司类型、季度历史数据深度、是否纳入已退市证券，以及股票代码变更后历史报表能否继续访问。同时确认季度值属于单季度还是累计期间，以及滚动期间如何构造。
不能只测试经营活动现金流合计，还应检查营运资本调整、非现金费用、资本性支出、并购、债务、股息、回购、汇率影响，以及现金流出采用何种正负号。
优先选择能够提供来源文件、申报编号或文档链接、监管系统接收日期、列示币种、标准化状态和修订版本的 API，并用原始构成项抽样复算合计数。
实测分页、历史回填时间、限流行为和更新延迟，并核对缓存、来源标注、再分发与商业使用权。即使公式正确，数据许可也可能不适合计划中的产品。
From an API response to an auditable free cash flow series从 API 响应构建可审计的自由现金流序列
A production integration should preserve the statement before calculating a headline number. The same response may contain annual values, cumulative interim values, restated comparatives, and provider-normalized fields. Separate those records first, then calculate free cash flow only when operating cash flow and capital expenditure share the same issuer, period, currency, units, accounting scope, and source version.
生产接入不能只保存最后算出的自由现金流，而应先完整保留现金流量表。一次响应中可能同时出现年度数据、中期累计数据、重述后的比较期数据和供应商标准化字段。应先把这些记录区分开，只有经营活动现金流与资本性支出在发行人、报告期、币种、单位、会计范围和来源版本上完全一致时，才能用于计算自由现金流。
Store the raw payload, request parameters, provider, retrieval time, source filing or document ID, filing acceptance time, amendment status, reported currency, units, and normalization flag. Keep the raw value beside the normalized value so a later mapping correction remains explainable.
Classify each record as annual, standalone quarter, or year-to-date cumulative. Map cash inflows and outflows into an internal convention, but preserve the provider's original sign. A negative capital-expenditure value must not be subtracted twice, and a nine-month cumulative value must not be labelled as the third quarter.
Calculate the selected free-cash-flow formula from compatible components and attach the formula version. Independently reconcile opening cash, operating, investing, financing, foreign-exchange effects, and other defined adjustments to closing cash. Also compare closing cash with the balance sheet under the same cash and restricted-cash definition.
Use an industrial company, a bank, a capital-intensive issuer, a company with acquisitions, an off-calendar fiscal year, and a filing later amended. Verify reported totals, standalone-quarter derivation, formula output, null handling, restatement behavior, and source links. Record expected results and tolerances so future provider or parser changes can be detected automatically.
保存原始响应、请求参数、供应商、获取时间、来源文件或文档 ID、监管系统接收时间、修订状态、报告币种、单位和标准化标记。原始值应与标准化值并列保留，使后续字段映射调整仍然可以解释。
把每条记录明确归类为年度、单季度或年初至今累计数据。可以在内部统一现金流入与流出的正负号，但必须保留供应商原始符号。资本性支出已经以负数返回时不能再次相减，九个月累计值也不能被标成第三季度单季数据。
使用口径兼容的构成项计算选定的自由现金流，并附上公式版本。同时独立核对期初现金、经营、投资、融资活动现金流、汇率影响和其他明确调整是否能够勾稽到期末现金，再使用相同的现金与受限现金定义和资产负债表核对。
样本应覆盖工业企业、银行、资本密集型公司、发生并购的企业、财年与自然年不一致的发行人，以及后来提交修订文件的公司。逐项验证报表合计、单季度推导、公式结果、空值处理、重述行为和来源链接，并保存预期结果与容差，以便自动发现供应商或解析器后续发生的变化。
Use QVeris to discover financial data APIs使用 QVeris 发现合适的金融数据 API
QVeris gives agents a discovery layer for finding and inspecting cash-flow, filing, and financial-statement capabilities. An agent can compare period parameters, schemas, and invocation requirements before making a call instead of hardcoding the first endpoint found. The application still owns period construction, sign normalization, formula choice, cash reconciliation, and the evidence attached to a free-cash-flow conclusion.
QVeris 为智能体提供统一的发现层，用于查找并核查现金流、监管文件和财务报表能力。智能体可以先比较报告期参数、数据结构和调用要求，再决定调用哪个接口，而不必直接围绕找到的第一个端点编写代码。应用方仍需负责期间构造、正负号统一、公式选择、现金余额勾稽，以及自由现金流结论所附带的证据。
- Search for cash flow statement capabilities by intent, not only by a provider's product name.
- Inspect input parameters and response fields before wiring an endpoint into production code.
- Keep provider-specific transformations behind a stable internal financial statement model.
- 按用途搜索现金流量表相关数据接口，而不局限于供应商的产品名称。
- 将接口接入生产代码前，先检查输入参数和响应字段。
- 使用稳定的内部财务报表模型，封装各供应商特有的数据转换逻辑。
FAQ常见问题
Not always. Many APIs calculate it from reported operating cash flow and capital expenditures, so definitions can differ.
Some providers offer a free plan, but coverage, request frequency limits, history, and update speed vary. Verify the current terms.
Cash flow adjusts accrual earnings for non-cash items and working-capital changes, then separately records investing and financing cash movements. The difference is expected and often analytically useful.
Reconcile opening cash plus operating, investing, financing, and FX effects to closing cash using the same definition of cash and restricted cash as the balance sheet.
Usually not in the standard operating-cash-flow-minus-capex measure. Keep business acquisitions separate and document any broader formula used for owner earnings or acquisition-adjusted cash flow.
Yes. Heavy investment, working-capital builds, or timing can produce negative free cash flow. Review the components and persistence rather than treating the sign alone as a verdict.
不一定。许多 API 会根据财报披露的经营活动现金流和资本性支出计算自由现金流，因此不同供应商对这一指标的定义可能有所不同。
部分供应商提供免费套餐，但数据覆盖范围、请求频率限制、历史数据跨度和更新速度各不相同，使用前应核对最新条款。
现金流会在权责发生制利润基础上调整非现金项目和营运资本变化，并单独记录投资与融资现金活动。两者存在差异是正常现象，而且往往具有重要分析价值。
使用一致的现金与受限现金定义，把期初现金、经营、投资、融资活动现金流和汇率影响勾稽到期末现金，并与资产负债表核对。
在“经营活动现金流减资本性支出”的常用口径中通常不计入。企业并购应单独保留；若采用所有者收益或并购调整后现金流等更宽口径，需要明确说明公式。
可能。大规模投资、营运资本增加或收付款时点都可能导致自由现金流为负。分析时应查看构成和持续时间，而不能只凭正负号下结论。