按计划刷新
用一个小脚本每天拉取新的披露文件和数据。
阅读指南 →所有 API
财务报表 API：公司公告与大股东
通过 Narwhal 获取公司披露文件、标准化财务报表和持股 5% 或以上的股东，REST 和 MCP 共用一个 API 密钥。
首次请求
查找公司
curl --request GET \
--url "https://api.narwhalapi.com/v1/companies?q=microsoft" \
--header "Authorization: Bearer $NARWHAL_API_KEY"响应示例
{
"results": [
{
"id": "usa:0000789019",
"name": "Microsoft Corp",
"country": "USA",
"registry": "usa",
"status": "active",
"exchange": "XNAS",
"code": "MSFT",
"matched": "name"
}
]
}端点
GET列出公司/v1/companies
按名称搜索公司并获取其 ID。在其他所有调用中使用该 ID。
参数
q可选搜索文本，例如公司名称。
响应字段
listings (on a company)字段与该公司关联的股票上市 ID，例如 XNAS:MSFT，用于股票接口。上市记录按交易所和股票代码的精确匹配关联，且必须当前有效，绝不按名称关联。列表为空表示没有关联。
完整参考文档 →
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。
完整参考文档 →
使用场景
覆盖范围
- 美国披露文件与财务报表。历史数据始于 2009 年。
- 日本超过 3,800 家公司，含年度和半年度数据。
- 韩国目前已覆盖约一半的上市公司。
- 台湾约 1,980 家公司。2026 年半年度报告。
- 欧盟和欧洲经济区约 3,200 家公司，覆盖 26 个国家，仅年度数据。
- 英国约 800 家受监管市场上的公司，仅年度数据。
来源
- 美国SEC EDGAR
- 日本EDINET，金融厅
- 韩国DART，金融监督院
- 台湾TWSE 和 TPEx 上市公司
- 欧盟和欧洲经济区ESEF 年度报告
- 英国英国受监管市场的发行人
相关 API
常见问题
可以用股票代码代替公司 ID 吗？
可以。使用 usa:0000789019 这样的标识符，或 usa:MSFT 这样的有效股票代码别名。
披露文件发布时可以收到通知吗？
每个账户都可以设置 Webhook，在披露文件发布时通知你。
财务金额是否经过换算或缩放？
金额为披露文件所用币种的小数字符串，不做换算，也不缩放为百万。缺失的项目会被省略，而已披露的零值仍为零。
如何从公司找到它的股票上市记录？
一家公司带有其股票上市 ID 列表。将其中一个 ID 用于股票接口，可获取价格、历史、股息、拆股和估值。股票上市记录会回带公司 ID，因此两个方向都能查。
披露文件记录
读取披露日期、类型和标题，并提供官方副本的链接。
标准化财务数据
在利润表、资产负债表、现金流量表、每股和股数中使用 77 个标准项目。
大股东
获取美国、日本和韩国持股 5% 或以上的股东。
从免费密钥开始
12 个月内每月赠送 10 美元免费额度，无需绑卡。每月 10 美元免费额度，无需绑卡。