財務與分析
財報(損益表)
提供公司損益表關鍵欄位,適合用於基本面分析、估值研究與策略建模。
GET
/v2/datasets/income-statementOverview#
此資料集為「財報資料」的一部分,建議搭配現金流量表一起使用(`/docs/api/financial-growth/cash-flow-statement`)。
損益表 API 提供公司期間性的營收與獲利欄位,適合用於基本面分析與研究流程。
資料來自公開揭露來源,並以結構化欄位回傳。
- 追蹤公司季度與年度獲利表現。
- 搭配估值資料做相對評價分析。
- 建立財務因子與成長性模型。
- 與月營收資料交叉驗證營運趨勢。
Request#
使用此 endpoint 時,建議:
Query Parameters#
| 欄位 | 型別 | Required | 說明 |
|---|---|---|---|
| symbol | string | yes | 股票代碼(內部對應 ticker)。 |
| start_date | string | no | 查詢起始日期(YYYY-MM-DD)。 |
| end_date | string | no | 查詢結束日期(YYYY-MM-DD)。 |
| limit | integer | no | 回傳筆數限制。 |
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[].symbol | string | 股票代碼。 |
| rows[].fiscal_year | integer | 財政年度。 |
| rows[].fiscal_quarter | integer|null | 財政季度。 |
| rows[].period_type | string | 期間類型(quarterly/annual/ttm)。 |
| rows[].period_end_date | string | 財報期間結束日期。 |
| rows[].report_date | string|null | 公告或報告日期。 |
| rows[].revenue | number|null | 營收。 |
| rows[].gross_profit | number|null | 毛利。 |
| rows[].operating_income | number|null | 營業利益。 |
| rows[].pretax_income | number|null | 稅前淨利。 |
| rows[].net_income | number|null | 稅後淨利。 |
| rows[].eps | number|null | 每股盈餘。 |
| count | integer | 回傳資料筆數。 |
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