所有 API

財報 API 與公司分析

取得年度與季度期間的標準化財務報表，若有半年度報告也一併提供，歷史資料與送達時間依方案而定。

取得免費 API 金鑰
閱讀文件 →
正在檢查97.81% uptime, last 30天295 ms 一般回應

首次請求

取得公司財務數據

curl --request GET \
  --url "https://api.narwhalapi.com/v1/companies/usa:0000789019/financials" \
  --header "Authorization: Bearer $NARWHAL_API_KEY"
回應範例
{
  "id": "usa:0000789019",
  "currency": "USD",
  "annual": [
    {
      "fy": 2026,
      "end": "2026-06-30",
      "revenue": "331839000000",
      "net_income": "133749000000",
      "total_assets": "758376000000",
      "operating_cash_flow": "182935000000",
      "eps_diluted": "17.95"
    }
  ]
}

端點

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。

回應欄位

  • fy欄位

    與報告期間相關的會計年度

  • fq欄位

    會計季度（適用時）

  • fh欄位

    會計半年度（適用時）

  • end欄位

    報告期間的結束日期

  • derived欄位

    標示由申報數值計算而得的數字

  • currency欄位

    申報文件所用的幣別，不做換算

完整參考文件 →
GET取得申報文件中的原始財務數字/v1/filings/{filing_id}/financials/as-reported

逐筆如單一申報文件所報告的數字，未經標準化。

參數

  • filing_id必填

    申報文件 ID，例如 usa:0000320193:0000320193-25-000079。

完整參考文件 →

使用情境

載入多年的公司資料

分頁讀取長期歷史資料，並在工作中斷時接續。

閱讀指南 →

依排程重新整理

用小型腳本每天拉取新的申報文件與數據。

閱讀指南 →

不超出用量限制

快取回應並處理 429 錯誤，不遺失請求。

閱讀指南 →

向代理程式詢問某家公司

透過 MCP 讓 LLM 代理程式讀取申報文件與財務數據。

閱讀指南 →

涵蓋範圍

  • 美國申報文件與財務報表。歷史資料自 2009 年起。
  • 日本超過 3,800 家公司，涵蓋年報與半年報。
  • 韓國目前約涵蓋一半的上市公司。
  • 臺灣約 1,980 家公司。2026 年半年度報告。
  • 歐盟與歐洲經濟區約 3,200 家公司，涵蓋 26 個國家，僅提供年報。
  • 英國約 800 家受監管市場的公司，僅提供年報。

來源

相關 API

公司獲利損益表 API

來自公司申報文件的營收、成本與利潤

探索 API →

公司財務狀況資產負債表 API

資產、負債、權益與衍生的資產負債表項目

探索 API →

公司資金流動的現金流量表 API

含正負號流出的營業、投資與籌資現金流量

探索 API →

每股盈餘與股利 EPS API

主要普通股類別的盈餘、股利與股數

探索 API →

常見問題

所有帳戶都能使用全部 77 個標準項目嗎？

所有帳戶皆可使用全部 77 個標準項目。若申報文件缺少某個項目，回應會省略該項目。

首次申報數字與截至某日查詢是什麼意思？

首次申報數字會保留申報文件最初的數字，不含重編。截至某日查詢會回傳過去某一日期當時已知的數字。兩者在所有帳戶皆可使用。

同一個數列會混用合併與個體報表嗎？

否。Narwhal 有合併數字時就採用合併數字，且同一個數列內絕不混用合併與個體數字。衍生項目會加以標示。

完整歷史資料

登記機構發布的每一年度，包含年度與季度，皆即時送達。

首次申報

依申報原始內容呈現的數字，未經重編。

截至某一日期

過去某一日期當時已知的數字。