登录获取 API 密钥

所有 API

MOPS API：台湾公告与报表

获取约 1,980 家在台湾 TWSE 和 TPEx 上市公司的财务报表。该 API 目前覆盖 2026 年半年度报告。

获取免费 API 密钥

阅读文档 →

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

首次请求

获取半年度财务数据

curl --request GET \
  --url "https://api.narwhalapi.com/v1/companies/twn:2330/financials?period=semiannual&fields=revenue,net_income,total_assets" \
  --header "Authorization: Bearer $NARWHAL_API_KEY"

响应示例

{
  "id": "twn:2330",
  "currency": "TWD",
  "semiannual": [
    {
      "fy": 2026,
      "fh": 1,
      "end": "2026-06-30",
      "derived": [],
      "revenue": "2404483690000",
      "net_income": "1279041690000",
      "total_assets": "9375654727000"
    }
  ],
  "as_of": "2026-10-24"
}

端点

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。

完整参考文档 →

使用场景

加载多年的公司数据

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

阅读指南 →

按计划刷新

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

阅读指南 →

不超出你的限额

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

阅读指南 →

向智能体询问某家公司

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

阅读指南 →

覆盖范围

台湾约 1,980 家公司。2026 年半年度报告。

来源

台湾TWSE 和 TPEx 上市公司

相关 API

面向公司年度公告的 ESEF API

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

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

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

EDINET API 覆盖范围已上线

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

DART API 覆盖范围已上线

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

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

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

常见问题

台湾公司 ID 如何构成？

台湾公司 ID 由 twn: 加股票代码组成，例如 twn:2330。

资产负债表涵盖哪些日期？

资产负债表按每个报告日期提供。

是否包含台湾持股 5% 或以上的股东？

不会。台湾不包含持股 5% 或以上的股东。

TWSE OpenAPI 和 TPEx 开放数据

我们使用 data.gov.tw 上的台湾证券交易所（TWSE）OpenAPI 和台北交易所（TPEx）开放数据，遵循台湾政府资料开放授权条款第 1 版。这些数据源与 MOPS 披露文件一致。

半年度数据

收入和每股数据为半年度的年初至今累计值（period=semiannual）。年度数据将随年度报告提供。

整数新台币

金额为整数新台币，由以千为单位的源数据放大而来。EPS 等每股数据为小数，不做缩放。