登录获取 API 密钥

所有 API

EDINET API 覆盖范围已上线

来自 EDINET 的日本披露文件和标准化财务报表已上线，涵盖 3,800 多家公司，金额以披露的日元为准，期间包括年度和半年度。

获取免费 API 密钥

阅读文档 →

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

首次请求

列出公司的披露文件

curl --request GET \
  --url "https://api.narwhalapi.com/v1/companies/usa:0000789019/filings" \
  --header "Authorization: Bearer $NARWHAL_API_KEY"

端点

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。

完整参考文档 →

GET获取持股 5% 以上的股东/v1/companies/{company_id}/holders

持股 5% 以上的股东，附带申报的持股比例、股数以及对应的披露文件。

参数

company_id必填
公司 ID，例如 usa:0000789019，或股票代码别名，例如 usa:MSFT。

完整参考文档 →

使用场景

按计划刷新

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

阅读指南 →

接收新披露文件通知

披露文件发布时接收 webhook 并进行验证。

阅读指南 →

加载多年的公司数据

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

阅读指南 →

不超出你的限额

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

阅读指南 →

向智能体询问某家公司

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

阅读指南 →

覆盖范围

日本超过 3,800 家公司，含年度和半年度数据。

来源

日本EDINET，金融厅

相关 API

通过 Narwhal 使用 SEC EDGAR API

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

DART API 覆盖范围已上线

韩国披露文件和财务报表，已上线

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

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

MOPS API：台湾公告与报表

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

面向公司年度公告的 ESEF API

来自 26 个欧盟及欧洲经济区国家公司的年度报告

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

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

常见问题

现在可以通过 Narwhal 访问日本披露文件吗？

日本披露文件和财务报表已上线，涵盖 3,800 多家公司。

日本有季度报表吗？

日本报表覆盖仅限年度和半年度。

是否包含日本的大量持股报告？

是的。包含 EDINET 大量持股报告。

EDINET 数据来源

覆盖范围使用日本金融厅的 EDINET。

年度和半年度

日本报表期间仅限年度和半年度。

按披露的日元

财务金额保留日元数值，不做换算，也不缩放为百万。