Building an AI agent? Start with /llms.txt for the full site index.

財務與分析

財報（現金流量表）

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

This documentation page is currently available in Chinese only; English versions are coming soon.

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；此頁不代表完整歷史現金流覆蓋，也不是即時資料。

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

Coverage

Instruments	Start year	Update timing	Includes delisted
Not yet available (coming)	Not yet available (coming)	Not yet available (coming)	coming

Figures are measured from the DB; unlisted fields defer to docs coverage (coming) — we don't fabricate cell by cell.

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）：涵蓋 2023Q2..2026Q1 各季；實際覆蓋筆數詳見 /datasets。
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`。

Limitations & notes

Coverage is not the full market or full history; the actual range is defined by the coverage table above and the data_gaps in the response.
Missing data is flagged honestly — we don't fill gaps with estimated values.
The platform focuses on daily-frequency and fundamental data; it does not provide real-time quotes, intraday bars, or cryptocurrencies.
TWSE is the verified baseline; TPEx history depth and adjusted prices are currently beta / deferred, flagged per dataset.

Plan Requirement

Free（限制）
Developer
Pro
Enterprise

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

請求與回應

Request example

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"

Status codes

成功回傳現金流量表資料

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；此頁不代表完整歷史現金流覆蓋，也不是即時資料。

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

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

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

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

Instruments

Start year

Update timing

Includes delisted

Not yet available (coming)

coming

欄位

型別

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）：涵蓋 2023Q2..2026Q1 各季；實際覆蓋筆數詳見 /datasets。

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`。

Limitations & notes

Coverage is not the full market or full history; the actual range is defined by the coverage table above and the data_gaps in the response.

Missing data is flagged honestly — we don't fill gaps with estimated values.

The platform focuses on daily-frequency and fundamental data; it does not provide real-time quotes, intraday bars, or cryptocurrencies.

TWSE is the verified baseline; TPEx history depth and adjusted prices are currently beta / deferred, flagged per dataset.