登入取得 API 金鑰

所有 API

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

取得英國受監管市場約 800 家公司的年度財務報表。

取得免費 API 金鑰

閱讀文件 →

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

首次請求

取得年度財務數據

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

回應範例

{
  "id": "gbr:549300MKFYEKVRWML317",
  "currency": "EUR",
  "annual": [
    {
      "fy": 2025,
      "end": "2025-12-31",
      "derived": [],
      "revenue": "50503000000",
      "net_income": "9469000000",
      "total_assets": "70471000000"
    }
  ],
  "as_of": "2026-03-18"
}

端點

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

閱讀指南 →

涵蓋範圍

英國約 800 家受監管市場的公司，僅提供年報。

來源

英國英國受監管市場發行人

相關 API

ESEF API 取得公司年度申報

來自 26 個歐盟與歐洲經濟區國家公司的年度報告

MOPS API 台灣申報文件與報表

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

透過 Narwhal 使用 SEC EDGAR API

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

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

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

常見問題

英國公司 ID 如何運作？

英國公司 ID 由 gbr: 加上公司的 LEI 組成，例如 gbr:<LEI>。

是否包含英國的季報？

否。英國涵蓋範圍僅有年度報告。

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

否。英國公司不包含持股 5% 以上的股東。

選擇報表欄位

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

僅年度報告

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

依申報原幣別

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