登录获取 API 密钥

所有 API

通过 Narwhal 使用 SEC EDGAR API

通过 Narwhal 以 JSON 获取美国披露文件记录和标准化 XBRL 财务数据，无需自己处理原始 EDGAR 数据。

获取免费 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"

响应示例

{
  "id": "usa:0000789019",
  "filings": [
    {
      "id": "usa:0000789019:0001193125-26-323660",
      "date": "2026-07-29",
      "type": "annual",
      "title": "10-K"
    }
  ]
}

端点

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。

完整参考文档 →

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

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

参数

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

完整参考文档 →

使用场景

按计划刷新

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

阅读指南 →

接收新披露文件通知

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

阅读指南 →

加载多年的公司数据

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

阅读指南 →

不超出你的限额

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

阅读指南 →

向智能体询问某家公司

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

阅读指南 →

覆盖范围

美国披露文件与财务报表。历史数据始于 2009 年。

来源

美国SEC EDGAR

相关 API

EDINET API 覆盖范围已上线

日本披露文件和财务报表，已上线

DART API 覆盖范围已上线

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

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

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

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

标准化报表、报告期间和历史版本

MOPS API：台湾公告与报表

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

面向公司年度公告的 ESEF API

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

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

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

常见问题

Narwhal 从 SEC EDGAR 返回什么？

Narwhal 返回公司披露文件记录、标准化财务报表，以及 Schedule 13D 和 13G 中披露的持股 5% 或以上的股东。

SEC 公司标识符如何构成？

美国公司 ID 由 usa: 加其 SEC 中央索引键（CIK）组成，例如 usa:0000789019。也接受股票代码别名，例如 usa:MSFT。

标准化会取代官方披露文件吗？

SEC 披露文件仍具权威性。Narwhal 提供 JSON 记录和标准化数据，供你的应用使用。

披露文件元数据

Narwhal 返回披露文件 ID、日期、类型、标题和官方链接。

标准报表项目

XBRL 财务数据已标准化为 77 个项目，所有账户均可使用。

一个 API 密钥

通过 REST 和 MCP 访问 Narwhal 的披露文件 API。