登录获取 API 密钥

所有 API

DART API 覆盖范围已上线

来自 DART 的韩国公司披露文件和财务报表已上线，金额以披露的韩元为准。

获取免费 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 智能体读取披露文件和财务数据。

阅读指南 →

覆盖范围

韩国目前已覆盖约一半的上市公司。

来源

韩国DART，金融监督院

相关 API

通过 Narwhal 使用 SEC EDGAR API

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

EDINET API 覆盖范围已上线

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

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

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

MOPS API：台湾公告与报表

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

面向公司年度公告的 ESEF API

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

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

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

常见问题

韩国披露文件覆盖已上线吗？

是的。约一半的上市公司已加载，更多公司正在陆续加入。

韩国使用哪些报告期间？

韩国报表覆盖仅限年度和季度。

是否包含韩国的大量持股报告？

是的。包含 DART 5% 报告。

DART 数据来源

DART 是韩国金融监督院的披露系统。

韩元金额

财务金额保持披露文件中的韩元。

部分加载

约一半的上市公司已加载。