登录获取 API 密钥

所有 API

面向公司年度公告的 ESEF API

获取约 3,200 家公司的年度财务报表。

获取免费 API 密钥

阅读文档 →

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

首次请求

获取年度财务数据

curl --request GET \
  --url "https://api.narwhalapi.com/v1/companies/nld:724500Y6DUVHQD6OXN27/financials?period=annual&fields=revenue,net_income,total_assets" \
  --header "Authorization: Bearer $NARWHAL_API_KEY"

响应示例

{
  "id": "nld:724500Y6DUVHQD6OXN27",
  "currency": "EUR",
  "annual": [
    {
      "fy": 2025,
      "end": "2025-12-31",
      "derived": [],
      "revenue": "32667300000",
      "net_income": "10213000000",
      "total_assets": "55576800000"
    }
  ],
  "as_of": "2026-02-25"
}

端点

GET列出公司/v1/companies

按名称搜索公司并获取其 ID。在其他所有调用中使用该 ID。

参数

q可选
搜索文本，例如公司名称。

完整参考文档 →

GET列出公司的披露文件/v1/companies/{company_id}/filings

一家公司的披露文件，按时间从新到旧排列，每份都附有官方原件链接。

参数

company_id必填
公司 ID，例如 usa:0000789019，或股票代码别名，例如 usa:MSFT。
type可选
披露文件类别，例如 annual。

完整参考文档 →

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。

完整参考文档 →

使用场景

加载多年的公司数据

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

阅读指南 →

按计划刷新

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

阅读指南 →

不超出你的限额

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

阅读指南 →

向智能体询问某家公司

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

阅读指南 →

覆盖范围

欧盟和欧洲经济区约 3,200 家公司，覆盖 26 个国家，仅年度数据。

来源

欧盟和欧洲经济区ESEF 年度报告

相关 API

英国上市公司财报 API：受监管市场公司

来自英国受监管市场发行人的年度报告

MOPS API：台湾公告与报表

来自 TWSE OpenAPI 和 data.gov.tw 上 TPEx 开放数据的台湾公司财务数据

通过 Narwhal 使用 SEC EDGAR API

来自 SEC EDGAR 的美国实时披露文件和标准化 XBRL 财务数据

公司公告 API：列表与单条记录

披露文件列表、单条记录以及跨公司的最新披露文件

常见问题

ESEF 公司 ID 如何构成？

公司 ID 由国家代码加公司的 LEI 组成，例如 nld:<LEI>。在两个国家上市的公司可能出现在各国之下。

是否包含季度或半年度报表？

不会。覆盖范围仅限年度报告，没有季度或半年度报表。

是否包含持股 5% 或以上的股东？

不会。这些公司不包含持股 5% 或以上的股东。

选择报表字段

使用 fields=revenue,net_income,total_assets 选择报表项目。

仅限年度报告

使用 period=annual 请求年度报表。

按披露币种

金额保持各公司披露时使用的币种。