登入取得 API 金鑰

所有 API

ESEF API 取得公司年度申報

取得約 3,200 家公司的年度財務報表。

取得免費 API 金鑰

閱讀文件 →

在線97.81% uptime, last 30天295 ms 一般回應

首次請求

取得年度財務數據

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

回應範例

{
  "id": "nld:724500Y6DUVHQD6OXN27",
  "currency": "EUR",
  "annual": [
    {
      "fy": 2025,
      "end": "2025-12-31",
      "derived": [],
      "revenue": "32667300000",
      "net_income": "10213000000",
      "total_assets": "55576800000"
    }
  ],
  "as_of": "2026-02-25"
}

端點

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 代理程式讀取申報文件與財務數據。

閱讀指南 →

涵蓋範圍

歐盟與歐洲經濟區約 3,200 家公司，涵蓋 26 個國家，僅提供年報。

來源

歐盟與歐洲經濟區ESEF 年度報告

相關 API

受規範市場公司的英國財報 API

來自英國受監管市場發行人的年度報告

MOPS API 台灣申報文件與報表

來自 data.gov.tw 上 TWSE OpenAPI 與 TPEx 開放資料的台灣公司財務數字

透過 Narwhal 使用 SEC EDGAR API

來自 SEC EDGAR 的美國即時申報文件與標準化 XBRL 財務數字

公司申報文件 API 清單與單筆紀錄

申報文件清單、單筆記錄，以及各公司的最新申報文件

常見問題

ESEF 公司 ID 如何運作？

公司 ID 由國家代碼與公司的 LEI 組成，例如 nld:<LEI>。同時在兩個國家上市的公司，可能會分別出現在各國之下。

是否包含季度或半年度報表？

否。涵蓋範圍僅有年度報告，沒有季度或半年度報表。

是否包含持股 5% 以上的股東？

否。這些公司不包含持股 5% 以上的股東。

選擇報表欄位

使用 fields=revenue,net_income,total_assets 選擇報表項目。

僅年度報告

使用 period=annual 請求年度報表。

依申報原幣別

金額維持各公司申報時所用的幣別，與申報內容一致。