財務與分析

財報（現金流量表）

提供公司現金流量表關鍵欄位，適合用於現金品質分析與基本面研究。

GET/v2/datasets/cash-flow-statement

Overview#

此 endpoint 提供現金流量表資料，對應 backend `cash_flow_statement` / `fundamental_cash_flows`，來源為 `official_mopsov_ajax_t163sb20`。

Cash Flow Phase A conservative baseline final freeze 已通過；目前 scope 僅限 TWSE（TYPEK=sii）且排除 TPEx / OTC。

凍結覆蓋區間為 2023Q2..2026Q1，總筆數 12,685；此頁不代表完整歷史現金流覆蓋，也不是即時資料。

檢查營運現金流與自由現金流的變化趨勢。
搭配損益表交叉驗證獲利品質與現金轉換能力。
做財務健康度與風險指標研究。
與估值資料整合做資本效率分析。

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": null,      "source": "official_mopsov_ajax_t163sb20",      "operating_cash_flow": 1320000000000,      "investing_cash_flow": -742000000000,      "financing_cash_flow": -221000000000,      "free_cash_flow": null    }  ],  "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	報告日期；在目前 Phase A conservative baseline 屬 deferred，若無核准直接來源欄位則為 null。
rows[].source	string	來源識別；目前 frozen baseline 為 `official_mopsov_ajax_t163sb20`。
rows[].operating_cash_flow	number\|null	營運活動現金流（來源可得時提供）。
rows[].investing_cash_flow	number\|null	投資活動現金流（來源可得時提供）。
rows[].financing_cash_flow	number\|null	籌資活動現金流（來源可得時提供）。
rows[].free_cash_flow	number\|null	自由現金流；目前 Phase A conservative baseline 屬 deferred，無核准直接來源欄位。
count	integer	回傳資料筆數。

Usage Notes / 使用建議#

Coverage（Phase A conservative baseline）：2026Q1=1044、2025Q4=1078、2025Q3=1079、2025Q2=1077、2025Q1=1060、2024Q4=1078、2024Q3=1043、2024Q2=1070、2024Q1=1026、2023Q4=1077、2023Q3=1008、2023Q2=1045（total=12,685）。
Scope / exclusions：僅 TWSE（TYPEK=sii）Non-TPEx；2023Q1 excluded；TPEx / OTC excluded。
欄位完整度會因公司與期間不同而有差異，缺值應以 null 處理；`free_cash_flow` 與 `report_date` 在目前 frozen baseline 為 deferred 欄位語意。
Frozen baseline 不保留 raw_payload（raw_payload 非對外欄位，且不作為可查詢內容）。
此 endpoint 不宣稱即時資料、不構成投資建議，且不代表 full historical cash flow coverage。
財報資料互補：建議搭配損益表 `/v2/datasets/income-statement` 一起分析獲利與現金品質。
Canonical 補充：`/v2/datasets/financials` 為較低層查詢面，支援 statement_type/period_type。
一般產品整合建議優先使用本頁主公開 endpoint `/v2/datasets/cash-flow-statement`。

Plan Requirement#

Free（限制）
Developer
Pro
Enterprise

此 API 屬於 TW Market Data 資料集目錄。查看資料集總覽

請求與回應

請求範例

curl --request GET \  --url "https://api.twmarketdata.com/v2/datasets/cash-flow-statement?symbol=2330&start_date=2025-01-01&end_date=2026-12-31&limit=12" \  --header "X-API-Key: your_api_key_here"

狀態碼

成功回傳現金流量表資料

JSON

{  "dataset": "cash_flow_statement",  "rows": [    {      "symbol": "2330",      "fiscal_year": 2025,      "fiscal_quarter": 4,      "period_type": "quarterly",      "period_end_date": "2025-12-31",      "report_date": null,      "source": "official_mopsov_ajax_t163sb20",      "operating_cash_flow": 1320000000000,      "investing_cash_flow": -742000000000,      "financing_cash_flow": -221000000000,      "free_cash_flow": null    }  ],  "count": 1}

Overview#

此 endpoint 提供現金流量表資料，對應 backend `cash_flow_statement` / `fundamental_cash_flows`，來源為 `official_mopsov_ajax_t163sb20`。

Cash Flow Phase A conservative baseline final freeze 已通過；目前 scope 僅限 TWSE（TYPEK=sii）且排除 TPEx / OTC。

凍結覆蓋區間為 2023Q2..2026Q1，總筆數 12,685；此頁不代表完整歷史現金流覆蓋，也不是即時資料。

檢查營運現金流與自由現金流的變化趨勢。

搭配損益表交叉驗證獲利品質與現金轉換能力。

做財務健康度與風險指標研究。

與估值資料整合做資本效率分析。

欄位

型別

Required

說明

symbol

string

yes

股票代碼（內部對應 ticker）。

start_date

string

查詢起始日期（YYYY-MM-DD）。

end_date

string

查詢結束日期（YYYY-MM-DD）。

limit

integer

回傳筆數限制。

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": null,      "source": "official_mopsov_ajax_t163sb20",      "operating_cash_flow": 1320000000000,      "investing_cash_flow": -742000000000,      "financing_cash_flow": -221000000000,      "free_cash_flow": null    }  ],  "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	報告日期；在目前 Phase A conservative baseline 屬 deferred，若無核准直接來源欄位則為 null。
rows[].source	string	來源識別；目前 frozen baseline 為 `official_mopsov_ajax_t163sb20`。
rows[].operating_cash_flow	number\|null	營運活動現金流（來源可得時提供）。
rows[].investing_cash_flow	number\|null	投資活動現金流（來源可得時提供）。
rows[].financing_cash_flow	number\|null	籌資活動現金流（來源可得時提供）。
rows[].free_cash_flow	number\|null	自由現金流；目前 Phase A conservative baseline 屬 deferred，無核准直接來源欄位。
count	integer	回傳資料筆數。

Usage Notes / 使用建議#

Coverage（Phase A conservative baseline）：2026Q1=1044、2025Q4=1078、2025Q3=1079、2025Q2=1077、2025Q1=1060、2024Q4=1078、2024Q3=1043、2024Q2=1070、2024Q1=1026、2023Q4=1077、2023Q3=1008、2023Q2=1045（total=12,685）。

Scope / exclusions：僅 TWSE（TYPEK=sii）Non-TPEx；2023Q1 excluded；TPEx / OTC excluded。

欄位完整度會因公司與期間不同而有差異，缺值應以 null 處理；`free_cash_flow` 與 `report_date` 在目前 frozen baseline 為 deferred 欄位語意。

Frozen baseline 不保留 raw_payload（raw_payload 非對外欄位，且不作為可查詢內容）。

此 endpoint 不宣稱即時資料、不構成投資建議，且不代表 full historical cash flow coverage。

財報資料互補：建議搭配損益表 `/v2/datasets/income-statement` 一起分析獲利與現金品質。

Canonical 補充：`/v2/datasets/financials` 為較低層查詢面，支援 statement_type/period_type。

一般產品整合建議優先使用本頁主公開 endpoint `/v2/datasets/cash-flow-statement`。