財務與分析
財報（現金流量表）
提供公司現金流量表關鍵欄位，適合用於現金品質分析與基本面研究。
GET
/v2/datasets/cash-flow-statementOverview#
此資料集為「財報資料」的一部分，建議搭配損益表一起使用（`/docs/api/financial-growth/income-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": "cash_flow_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",
"operating_cash_flow": 1320000000000,
"investing_cash_flow": -742000000000,
"financing_cash_flow": -221000000000,
"free_cash_flow": 578000000000
}
],
"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[].operating_cash_flow | number|null | 營運活動現金流。 |
| rows[].investing_cash_flow | number|null | 投資活動現金流。 |
| rows[].financing_cash_flow | number|null | 籌資活動現金流。 |
| rows[].free_cash_flow | number|null | 自由現金流。 |
| count | integer | 回傳資料筆數。 |
Usage Notes / 使用建議#
- 財報資料互補：建議搭配損益表 `/v2/datasets/income-statement` 一起分析獲利與現金品質。
- 欄位完整度會因公司與期間不同而有差異，缺值應以 null 處理。
- 日期欄位以 Asia/Taipei 財報語意（YYYY-MM-DD）為準。
- 若需三大表完整欄位，請搭配財報三表相關資料主題。
- Canonical 補充：`/v2/datasets/financials` 為較低層查詢面，支援 statement_type/period_type。
- 一般產品整合建議優先使用本頁主公開 endpoint `/v2/datasets/cash-flow-statement`。
Plan Requirement#
- Free（限制）
- Developer
- Pro
- Enterprise