所有 API

公司现金流动的现金流量表 API

以带符号的小数字符串读取经营、投资和筹资现金流,包括收购、已付利息和已付税款的负数流出。

在线97.81% uptime, last 30天295 ms 典型响应

首次请求

获取现金流量表

curl --request GET \
  --url "https://api.narwhalapi.com/v1/companies/usa:0000789019/financials?statement=cash_flow" \
  --header "Authorization: Bearer $NARWHAL_API_KEY"
响应示例
{
  "id": "usa:0000789019",
  "currency": "USD",
  "annual": [
    {
      "fy": 2026,
      "end": "2026-06-30",
      "operating_cash_flow": "182935000000",
      "capex": "-115948000000"
    }
  ]
}

端点

GET获取标准化的公司财务报表/v1/companies/{company_id}/financials

公司的标准化财务报表,每个报告期一行,币种为其申报币种。

参数

  • company_id必填

    公司 ID,例如 usa:0000789019,或股票代码别名,例如 usa:MSFT。

  • period可选

    annual 或 semiannual,取决于注册机构。

  • statement可选

    income、balance、cash_flow 或 per_share。

  • fields可选

    以逗号分隔的项目名称,例如 revenue,net_income。

响应字段

  • operating_cash_flow字段

    经营活动产生或使用的现金净额。

  • investing_cash_flow字段

    投资活动产生或使用的现金净额。

  • financing_cash_flow字段

    融资活动产生或使用的现金净额。

  • capex字段

    购置物业、厂房及设备所支付的现金,记为负的现金流出。

  • acquisitions字段

    收购所支付的现金(扣除所获现金后的净额),记为负的现金流出。

  • free_cash_flow字段

    始终按经营现金流加资本支出计算,其中资本支出记为负数现金流出。

  • depreciation_amortization字段

    在将利润调节为经营现金流时加回的折旧与摊销。

  • stock_based_compensation字段

    在将利润调节为经营现金流时加回的股权激励费用。

  • dividends_paid字段

    已支付的现金股息,记为负的现金流出。

  • share_repurchases字段

    回购公司自身股份所支付的现金,记为负的现金流出。

  • fx_effect_on_cash字段

    汇率变动对现金的影响额。

  • interest_paid字段

    已支付的利息现金,记为负的现金流出。

  • taxes_paid字段

    已支付的税款现金(扣除退税后的净额),记为负的现金流出。

  • net_change_in_cash字段

    现金的净增加或净减少额,含汇率变动的影响。


完整参考文档 →

使用场景

加载多年的公司数据

分页读取较长的历史,任务中断后可以继续。

阅读指南 →

按计划刷新

用一个小脚本每天拉取新的披露文件和数据。

阅读指南 →

不超出你的限额

缓存响应并处理 429 错误,避免丢失请求。

阅读指南 →

向智能体询问某家公司

通过 MCP 让 LLM 智能体读取披露文件和财务数据。

阅读指南 →

覆盖范围

  • 美国披露文件与财务报表。历史数据始于 2009 年。
  • 日本超过 3,800 家公司,含年度和半年度数据。
  • 韩国目前已覆盖约一半的上市公司。
  • 台湾约 1,980 家公司。2026 年半年度报告。
  • 欧盟和欧洲经济区约 3,200 家公司,覆盖 26 个国家,仅年度数据。
  • 英国约 800 家受监管市场上的公司,仅年度数据。

来源

相关 API

公司盈利情况的利润表 API

来自公司披露文件的营业收入、成本和利润

探索 API →

公司财务状况的资产负债表 API

资产、负债、权益及衍生的资产负债表项目

探索 API →

EPS API:每股收益与股息

主要普通股类别的收益、股息和股数

探索 API →

面向公司分析的财务报表 API

标准化报表、报告期间和历史版本

探索 API →

常见问题

利息支出是否为负数?

是的。interest_paid 表示现金流出,带负号。

收购项目如何处理所获现金?

收购项目用收购所支付的现金减去所获现金,并将该付款记为负数流出。

现金流金额是否以百万为单位?

不做缩放为百万的处理。响应使用原始披露币种的小数字符串。

负数流出

公司流出的现金记为负数。

收购付款

收购金额按已付现金扣除所获现金后的净额列示。

已付税款

税款支付按扣除退税后的净额计,并记为负数流出。