財務與分析

財報(損益表)

提供公司損益表關鍵欄位,適合用於基本面分析、估值研究與策略建模。

GET/v2/datasets/income-statement

Overview#

此資料集為「財報資料」的一部分,建議搭配現金流量表一起使用(`/docs/api/financial-growth/cash-flow-statement`)。

損益表 API 提供公司期間性的營收與獲利欄位,適合用於基本面分析與研究流程。

資料來自公開揭露來源,並以結構化欄位回傳。

  • 追蹤公司季度與年度獲利表現。
  • 搭配估值資料做相對評價分析。
  • 建立財務因子與成長性模型。
  • 與月營收資料交叉驗證營運趨勢。

Request#

使用此 endpoint 時,建議:

Query Parameters#

欄位型別Required說明
symbolstringyes股票代碼(內部對應 ticker)。
start_datestringno查詢起始日期(YYYY-MM-DD)。
end_datestringno查詢結束日期(YYYY-MM-DD)。
limitintegerno回傳筆數限制。

Response Shape#

回應結構固定為 dataset、rows、count。

{
  "dataset": "income_statement",
  "rows": [
    {
      "symbol": "2330",
      "fiscal_year": 2025,
      "fiscal_quarter": 4,
      "period_type": "quarterly",
      "period_end_date": "2025-12-31",
      "report_date": "2026-03-08",
      "source": "mops_official",
      "revenue": 625000000000,
      "gross_profit": 320000000000,
      "operating_income": 250000000000,
      "pretax_income": 246000000000,
      "net_income": 210000000000,
      "eps": 8.1
    }
  ],
  "count": 1
}

Field 說明#

欄位路徑型別說明
rows[].symbolstring股票代碼。
rows[].fiscal_yearinteger財政年度。
rows[].fiscal_quarterinteger|null財政季度。
rows[].period_typestring期間類型(quarterly/annual/ttm)。
rows[].period_end_datestring財報期間結束日期。
rows[].report_datestring|null公告或報告日期。
rows[].revenuenumber|null營收。
rows[].gross_profitnumber|null毛利。
rows[].operating_incomenumber|null營業利益。
rows[].pretax_incomenumber|null稅前淨利。
rows[].net_incomenumber|null稅後淨利。
rows[].epsnumber|null每股盈餘。
countinteger回傳資料筆數。

Usage Notes / 使用建議#

  • 財報資料互補:建議搭配現金流量表 `/v2/datasets/cash-flow-statement` 一起分析公司獲利與現金品質。
  • 欄位完整度會因公司與期間不同而有差異,缺值應以 null 處理。
  • 日期欄位以 Asia/Taipei 財報語意(YYYY-MM-DD)為準。
  • 若需三大表完整欄位,請搭配財報三表相關資料主題。
  • Canonical 補充:`/v2/datasets/financials` 為較低層查詢面,支援 statement_type/period_type。
  • 一般產品整合建議優先使用本頁主公開 endpoint `/v2/datasets/income-statement`。

Plan Requirement#

  • Free(限制)
  • Developer
  • Pro
  • Enterprise