所有 API

公司獲利損益表 API

讀取公司申報文件中的標準化營收、成本與利潤,成本為正數,計算項目有標示,並分別列出歸屬母公司與合併淨利。

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

首次請求

取得損益表

curl --request GET \
  --url "https://api.narwhalapi.com/v1/companies/usa:0000789019/financials?statement=income" \
  --header "Authorization: Bearer $NARWHAL_API_KEY"
回應範例
{
  "id": "usa:0000789019",
  "currency": "USD",
  "annual": [
    {
      "fy": 2026,
      "end": "2026-06-30",
      "revenue": "331839000000",
      "gross_profit": "225465000000",
      "operating_income": "155237000000",
      "net_income": "133749000000"
    }
  ]
}

端點

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。

回應欄位

  • revenue欄位

    銷售收入總額,扣除退貨與折讓;銀行與保險公司留空。

  • cost_of_revenue欄位

    當期銷售商品與服務的成本。

  • gross_profit欄位

    已申報營收減營業成本;銀行與保險公司留空。

  • research_and_development欄位

    研究與開發產品、服務或流程的費用。

  • selling_general_administrative欄位

    銷售產品與服務、經營業務及一般行政的費用。

  • selling_marketing欄位

    銷售與行銷活動的費用,記為正數成本。

  • general_administrative欄位

    一般行政費用,記為正數成本。

  • operating_expenses欄位

    列為營業費用的費用總額。

  • operating_income欄位

    來自營業活動的損益。

  • ebit欄位

    由營業利益推算,否則為稅前利潤加利息費用;銀行與保險公司不提供。

  • ebitda欄位

    以稅息前利潤加折舊與攤銷計算,標示為推算值。

  • interest_income欄位

    利息所得;銀行則為利息與股利收入合計。

  • interest_expense欄位

    借款及其他附息債務的利息成本,以正數表示。

  • net_interest_income欄位

    銀行的利息收入減利息支出。

  • noninterest_income欄位

    銀行利息以外來源的總收入。

  • noninterest_expense欄位

    銀行利息支出以外的總費用。

  • provision_for_credit_losses欄位

    銀行的信用損失費用,屬費用時以正數表示。

  • premiums_earned欄位

    保險公司在期間內認列為已賺得的保費,扣除分出再保險後的淨額。

  • policy_benefits欄位

    保險公司在期間內發生的保單給付與理賠費用。

  • pretax_income欄位

    來自繼續營業單位的稅前損益。

  • income_tax欄位

    所得稅費用或利益,屬費用時以正數表示。

  • net_income欄位

    歸屬於母公司的稅後淨利,不含非控制權益。

  • net_income_parent欄位

    歸屬於母公司業主的淨利

  • net_income_to_common欄位

    扣除特別股股利後,可供普通股股東分配的淨利。

  • discontinued_ops_income欄位

    停業單位損益,稅後淨額。

  • net_income_including_nci欄位

    稅後合併淨利,含歸屬於非控制權益的部分。

  • net_income_noncontrolling欄位

    歸屬於母公司以外的子公司業主的損益。

  • comprehensive_income欄位

    綜合損益總額,依申報方式含非控制權益

  • jp_ordinary_income欄位

    僅日本適用的利潤,包含營業與營業外損益,未計特別損益與稅項,與美國會計準則(US GAAP)或國際財務報導準則(IFRS)沒有直接對應項目。


完整參考文件 →

使用情境

載入多年的公司資料

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

閱讀指南 →

依排程重新整理

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

閱讀指南 →

不超出用量限制

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

閱讀指南 →

向代理程式詢問某家公司

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

閱讀指南 →

涵蓋範圍

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

來源

相關 API

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

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

探索 API →

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

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

探索 API →

每股盈餘與股利 EPS API

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

探索 API →

財報 API 與公司分析

標準化報表、報告期間與歷史版本

探索 API →

常見問題

銀行與保險公司如何呈現?

銀行與保險公司的營收與毛利為空白。它們改為申報利息收入或保費。

息稅前利潤 如何計算?

息稅前利潤 在有營業利益時採用營業利益,否則採用稅前淨利加利息費用。它是衍生值,銀行與保險公司不提供。

三個淨利項目各代表什麼?

net_income 是母公司的份額,不含非控制權益。net_income_including_nci 是含非控制權益的合併總額。net_income_parent 是另一個項目,代表歸屬母公司業主的淨利。

成本為正數

損益表中的成本為正數。

歸屬母公司淨利

net_income 是母公司的份額;net_income_including_nci 包含非控制權益。

標示計算而得的項目

衍生項目皆有標示,包括計算而得的 息稅前利潤 與 EBITDA。