按计划刷新
用一个小脚本每天拉取新的披露文件和数据。
阅读指南 →所有 API
公司公告 API：列表与单条记录
列出公司的披露文件、获取披露文件记录，或读取跨公司的最新披露文件，并提供监管机构官方副本的链接。
首次请求
列出公司的年度披露文件
curl --request GET \
--url "https://api.narwhalapi.com/v1/companies/usa:0000789019/filings?type=annual" \
--header "Authorization: Bearer $NARWHAL_API_KEY"响应示例
{
"id": "usa:0000789019",
"filings": [
{
"id": "usa:0000789019:0001193125-26-323660",
"date": "2026-07-29",
"type": "annual",
"title": "10-K"
}
]
}端点
GET列出公司的披露文件/v1/companies/{company_id}/filings
一家公司的披露文件，按时间从新到旧排列，每份都附有官方原件链接。
参数
company_id必填公司 ID，例如 usa:0000789019，或股票代码别名，例如 usa:MSFT。
type可选披露文件类别，例如 annual。
响应字段
id字段披露文件标识符
date字段披露文件的提交日期
type字段披露文件类别，例如年度、季度、事件或所有权
title字段披露文件标题
url字段指向监管机构网站上官方披露文件的链接
company_id字段与披露文件相关的公司标识符
form字段监管机构的表格编号，例如 10-K 或 13D
period_end字段披露文件所涵盖报告期的结束日期
filing_id (on stock earnings)字段覆盖某次历史财报的年报、半年报或季报。将其传给披露文件接口即可读取该记录。若没有匹配的披露文件，或没有报告符合该日期，则不返回此项。
完整参考文档 →
GET获取跨公司的最新披露文件/v1/filings/latest
GET获取披露文件记录/v1/filings/{filing_id}
使用场景
覆盖范围
- 美国披露文件与财务报表。历史数据始于 2009 年。
- 日本超过 3,800 家公司，含年度和半年度数据。
- 韩国目前已覆盖约一半的上市公司。
- 台湾约 1,980 家公司。2026 年半年度报告。
- 欧盟和欧洲经济区约 3,200 家公司，覆盖 26 个国家，仅年度数据。
- 英国约 800 家受监管市场上的公司，仅年度数据。
来源
- 美国SEC EDGAR
- 日本EDINET，金融厅
- 韩国DART，金融监督院
- 台湾TWSE 和 TPEx 上市公司
- 欧盟和欧洲经济区ESEF 年度报告
- 英国英国受监管市场的发行人
相关 API
通过 Narwhal 使用 SEC EDGAR API
来自 SEC EDGAR 的美国实时披露文件和标准化 XBRL 财务数据
探索 API →EDINET API 覆盖范围已上线
日本披露文件和财务报表，已上线
探索 API →DART API 覆盖范围已上线
韩国披露文件和财务报表，已上线
探索 API →MOPS API：台湾公告与报表
来自 TWSE OpenAPI 和 data.gov.tw 上 TPEx 开放数据的台湾公司财务数据
探索 API →面向公司年度公告的 ESEF API
来自 26 个欧盟及欧洲经济区国家公司的年度报告
探索 API →英国上市公司财报 API：受监管市场公司
来自英国受监管市场发行人的年度报告
探索 API →常见问题
哪些表格适用于外国私人发行人？
表格 20-F 归为年度类，表格 6-K 归为事件类。
可以按 ID 获取某份披露文件吗？
使用 GET /v1/filings/{filing_id} 获取特定披露文件的记录。
在哪里可以阅读原始披露文件？
通过记录中的 url 前往监管机构网站上的官方副本。该文件始终是权威来源。
如何从财报找到对应的披露文件？
当我们持有对应的报告时，股票接口中的历史财报行会带有披露文件 ID。将它传给披露文件接口即可。财报 EPS 与披露文件财务数据中的 EPS 可能不同，因为财报数据采用市场数据口径。
公司披露文件列表
按类型、表格和日期读取公司的披露文件。
最新申报文件
通过一个端点获取跨公司的最新披露文件。
官方链接
每条记录包含 ID、日期、类型、标题和指向官方披露文件的链接。
从免费密钥开始
12 个月内每月赠送 10 美元免费额度，无需绑卡。每月 10 美元免费额度，无需绑卡。