所有 API

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

获取年度和季度期间的标准化财务报表，有半年度报告时一并提供，历史数据范围和推送时效取决于套餐。

获取免费 API 密钥
阅读文档 →
正在检查97.81% uptime, last 30天295 ms 典型响应

首次请求

获取公司财务数据

curl --request GET \
  --url "https://api.narwhalapi.com/v1/companies/usa:0000789019/financials" \
  --header "Authorization: Bearer $NARWHAL_API_KEY"
响应示例
{
  "id": "usa:0000789019",
  "currency": "USD",
  "annual": [
    {
      "fy": 2026,
      "end": "2026-06-30",
      "revenue": "331839000000",
      "net_income": "133749000000",
      "total_assets": "758376000000",
      "operating_cash_flow": "182935000000",
      "eps_diluted": "17.95"
    }
  ]
}

端点

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。

响应字段

  • fy字段

    与报告期相关的财政年度

  • fq字段

    财政季度（适用时）

  • fh字段

    财政半年度（适用时）

  • end字段

    报告期的结束日期

  • derived字段

    标注由披露数值计算得出的数据

  • currency字段

    使用披露文件所用币种，不做换算

完整参考文档 →
GET获取披露文件中所报告的财务数据/v1/filings/{filing_id}/financials/as-reported

披露文件所申报的原始数据，未经标准化。

参数

  • filing_id必填

    披露文件 ID，例如 usa:0000320193:0000320193-25-000079。

完整参考文档 →

使用场景

加载多年的公司数据

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

阅读指南 →

按计划刷新

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

阅读指南 →

不超出你的限额

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

阅读指南 →

向智能体询问某家公司

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

阅读指南 →

覆盖范围

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

来源

相关 API

公司盈利情况的利润表 API

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

探索 API →

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

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

探索 API →

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

经营、投资和筹资现金流，流出带符号

探索 API →

EPS API：每股收益与股息

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

探索 API →

常见问题

是否每个账户都可使用全部 77 个标准项目？

全部 77 个标准项目适用于每个账户。若披露文件中缺少某一项目，响应会将其省略。

首次披露数据和截至日期查询是什么意思？

首次披露的数据保留首次提交时的数字，不含重述。按截至日期查询会返回过去某一日期已知的数字。两者对每个账户均可使用。

同一个系列中会混用合并报表和单体报表吗？

不会。Narwhal 在有合并数据时使用合并数据，并且绝不在同一个系列中混用合并与单体数据。衍生项目会有标注。

完整历史数据

登记机构发布的每一年度和季度数据，实时推送。

首次披露

首次披露时的数据，未经重述。

截至某一日期

过去某一日期已知的数字。