AI agent？先讀 /llms.txt 取得全站索引。
財務與成長
上市櫃公司季度現金流量表,來源為公開資訊觀測站(MOPS)——申報之營業、投資與籌資活動現金流量。
GET /v2/datasets/cash-flow-statementcash-flow-statement 以官方 MOPS 申報為源,每家公司每個會計期間回傳一列;每列附來源角色與 lineage 標明所屬 MOPS 表單,現金流數字可回溯申報稿。
| 欄位 | 型別 | 說明 |
|---|---|---|
symbol | string | 股票代碼。 |
period | string | 會計期間(如 2026-Q1)。 |
operating_cash_flow | number | 營業活動之淨現金流量(新台幣仟元)。 |
investing_cash_flow | number | 投資活動之淨現金流量(新台幣仟元)。 |
financing_cash_flow | number | 籌資活動之淨現金流量(新台幣仟元)。 |
source_role | string | 正規來源角色(official_mops_cash_flow_statement)。 |
| 列數 | 77,712 |
| 涵蓋起訖 | 2013-03-31 至 2026-03-31 |
| 分級 | 已驗證 |
此為本端點的真實回應。資料列位於 "rows" 之下，來源資訊如下方所示；各資料集形狀不盡相同，請以本頁為準。
{ "dataset": "cash_flow_statement", "rows": [ { "symbol": "2330", "ticker": "2330", "fiscal_year": 2026, "fiscal_quarter": 1, "period_type": "quarterly", "period_end_date": "2026-03-31", "report_date": "2026-05-15", "operating_cash_flow": 698976265, "investing_cash_flow": -356853756, "financing_cash_flow": -119910612, "free_cash_flow": null, "capital_expenditures": null, "depreciation": null, "cash_beginning": null, "cash_ending": null, "net_change_in_cash": null, "source": "mops_t163sb20", "source_name": "mops_t163sb20", "fiscal_period": "2026-Q1", "frequency": "quarterly", "updated_at": "2026-07-18T14:43:59.997885", "fundamentals_context": { "generated_at": "2026-07-20T18:31:54Z", "ticker": "2330", "period": "2026Q1", "period_type": "quarterly", "statement_family": "cash_flow_statement", "metric_values": { "symbol": "2330", "period_end_date": "2026-03-31", "report_date": "2026-05-15", "operating_cash_flow": 698976265, "investing_cash_flow": -356853756, "financing_cash_flow": -119910612, "free_cash_flow": null, "capital_expenditures": null, "depreciation": null, "cash_beginning": null, "cash_ending": null, "net_change_in_cash": null, "source": "mops_t163sb20", "source_name": "mops_t163sb20", "fiscal_period": "2026-Q1", "frequency": "quarterly", "updated_at": "2026-07-18T14:43:59.997885" }, "source_lineage": { "provider": "mops_t163sb20", "source_role": "official_mops_cash_flow_statement", "source_table": "fundamental_cash_flows", "ingestion_run_id": null, "transformation_version": "fundamentals_ai_context_v1" }, "data_gaps": [], "restatement_warning": { "has_restatement": false, "reason": null, "previous_version_ref": null }, "not_investment_advice": true, "coverage_window": { "min_period": null, "max_period": null, "coverage_confidence": "medium", "row_count": 0 }, "safe_usage_notes": [ "not_investment_advice", "official_public_first_policy", "period_semantics_explicit" ], "available_tools_or_endpoints": [ { "name": "cash_flow_statement", "path": "/v2/datasets/cash-flow-statement" }, { "name": "cash_flow_statement", "path": "/v2/datasets/financials" } ] } }, { "symbol": "2330", "ticker": "2330", "fiscal_year": 2026, "fiscal_quarter": 1, "period_type": "quarterly", "period_end_date": "2026-03-31", "report_date": null, "operating_cash_flow": 698976265, "investing_cash_flow": -356853756, "financing_cash_flow": -119910612, "free_cash_flow": 342122509, "capital_expenditures": null, "depreciation": null, "cash_beginning": null, "cash_ending": null, "net_change_in_cash": null, "source": "official_mopsov_ajax_t163sb20", "source_name": "official_mopsov_ajax_t163sb20", "fiscal_period": "2026-Q1", "frequency": "quarterly", "updated_at": "2026-05-25T10:25:58.801061", "fundamentals_context": { "generated_at": "2026-07-20T18:31:54Z", "ticker": "2330", "period": "2026Q1", "period_type": "quarterly", "statement_family": "cash_flow_statement", "metric_values": { "symbol": "2330", "period_end_date": "2026-03-31", "report_date": null, "operating_cash_flow": 698976265, "investing_cash_flow": -356853756, "financing_cash_flow": -119910612, "free_cash_flow": 342122509, "capital_expenditures": null, "depreciation": null, "cash_beginning": null, "cash_ending": null, "net_change_in_cash": null, "source": "official_mopsov_ajax_t163sb20", "source_name": "official_mopsov_ajax_t163sb20", "fiscal_period": "2026-Q1", "frequency": "quarterly", "updated_at": "2026-05-25T10:25:58.801061" }, "source_lineage": { "provider": "official_mopsov_ajax_t163sb20", "source_role": "official_mops_cash_flow_statement", "source_table": "fundamental_cash_flows", "ingestion_run_id": null, "transformation_version": "fundamentals_ai_context_v1" }, "data_gaps": [], "restatement_warning": { "has_restatement": false, "reason": null, "previous_version_ref": null }, "not_investment_advice": true, "coverage_window": { "min_period": null, "max_period": null, "coverage_confidence": "medium", "row_count": 0 }, "safe_usage_notes": [ "not_investment_advice", "official_public_first_policy", "period_semantics_explicit" ], "available_tools_or_endpoints": [ { "name": "cash_flow_statement", "path": "/v2/datasets/cash-flow-statement" }, { "name": "cash_flow_statement", "path": "/v2/datasets/financials" } ] } } ], "count": 50, "status": "ok"}擷取自 2026-07-20 的線上 API。
curl "https://api.twmarketdata.com/v2/datasets/cash-flow-statement?symbol=2330" \ -H "X-API-Key: sk_live_..."| 參數 | 必填 | 型別 | 說明 |
|---|---|---|---|
symbol | 是 | string | 股票代碼，例如 2330。 |
start_date | 否 | string (YYYY-MM-DD) | 查詢起始日期。 |
end_date | 否 | string (YYYY-MM-DD) | 查詢結束日期。 |
limit | 否 | integer | 回傳筆數上限。 |
第一個呼叫：
import requests resp = requests.get( "https://api.twmarketdata.com/v2/datasets/cash-flow-statement", params={"symbol": "2330"}, headers={"X-API-Key": "sk_live_..."},)resp.raise_for_status()print(resp.json()["rows"])帶日期區間篩選：
import requests # The full verified example — the same call with every supported filter set.resp = requests.get( "https://api.twmarketdata.com/v2/datasets/cash-flow-statement", params={"symbol": "2330"}, headers={"X-API-Key": "sk_live_..."},)resp.raise_for_status()for row in resp.json()["rows"]: print(row)此端點為 GET /v2/datasets/cash-flow-statement。完整機器可讀 schema（參數、認證、回應封裝）見 OpenAPI spec。