EN 登入註冊

AI agent？先讀 /llms.txt 取得全站索引。

財務與成長

現金流量表

Name: Cash-flow statement
Creator: TW Market Data
License: https://twmarketdata.com/zh-TW/legal/licensing

上市櫃公司季度現金流量表,來源為公開資訊觀測站(MOPS)——申報之營業、投資與籌資活動現金流量。

← 現金流量表資料集總覽

已驗證來源: MOPS·方案: pro·計費: 2 點·GET /v2/datasets/cash-flow-statement

現金流量表是台灣市場資料集,來源為 MOPS,由 TW Market Data 以 GET /v2/datasets/cash-flow-statement 提供。

總覽

cash-flow-statement 以官方 MOPS 申報為源,每家公司每個會計期間回傳一列;每列附來源角色與 lineage 標明所屬 MOPS 表單,現金流數字可回溯申報稿。

欄位	型別	說明
`symbol`	string	股票代碼。
`ticker`	string
`fiscal_year`	number
`fiscal_quarter`	number
`period_type`	string
`period_end_date`	string
`report_date`	null
`operating_cash_flow`	number	營業活動之淨現金流量(新台幣仟元)。
`investing_cash_flow`	number	投資活動之淨現金流量(新台幣仟元)。
`financing_cash_flow`	number	籌資活動之淨現金流量(新台幣仟元)。
`free_cash_flow`	number
`capital_expenditures`	null
`depreciation`	null
`cash_beginning`	null
`cash_ending`	null
`net_change_in_cash`	null
`source`	string
`fiscal_period`	string
`frequency`	string
`fundamentals_context`	object

涵蓋範圍

列數	約 77,712
涵蓋起訖	2019-05-15 – 2026-08-14
分級	已驗證
量測時間	2026-09-01取自資料集登錄表

範例回應

此為本端點的真實回應。資料列位於 "rows" 之下，來源資訊如下方所示；各資料集形狀不盡相同，請以本頁為準。

{
  "dataset": "cash_flow_statement",
  "rows": [
    {
      "symbol": "3189",
      "ticker": "3189",
      "fiscal_year": 2026,
      "fiscal_quarter": 1,
      "period_type": "quarterly",
      "period_end_date": "2026-03-31",
      "report_date": null,
      "operating_cash_flow": 1449456,
      "investing_cash_flow": -5263490,
      "financing_cash_flow": 3130418,
      "free_cash_flow": -3814034,
      "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-08-06T05:15:14Z",
        "ticker": "3189",
        "period": "2026Q1",
        "period_type": "quarterly",
        "statement_family": "cash_flow_statement",
        "metric_values": {
          "symbol": "3189",
          "period_end_date": "2026-03-31",
          "report_date": null,
          "operating_cash_flow": 1449456,
          "investing_cash_flow": -5263490,
          "financing_cash_flow": 3130418,
          "free_cash_flow": -3814034,
          "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"
        },
        "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": "3189",
      "ticker": "3189",
      "fiscal_year": 2026,
      "fiscal_quarter": 1,
      "period_type": "quarterly",
      "period_end_date": "2026-03-31",
      "report_date": "2026-05-15",
      "operating_cash_flow": 1449456,
      "investing_cash_flow": -5263490,
      "financing_cash_flow": 3130418,
      "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-08-06T05:15:14Z",
        "ticker": "3189",
        "period": "2026Q1",
        "period_type": "quarterly",
        "statement_family": "cash_flow_statement",
        "metric_values": {
          "symbol": "3189",
          "period_end_date": "2026-03-31",
          "report_date": "2026-05-15",
          "operating_cash_flow": 1449456,
          "investing_cash_flow": -5263490,
          "financing_cash_flow": 3130418,
          "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"
        },
        "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。

出處

以下欄位會隨資料一併回傳,記錄這一列的來源。它們屬於出處而非本資料集要講的事實,因此列在這裡而不進欄位表。

source_nameupdated_at

授權與顯名

本服務部分資料取自政府資料開放平臺(data.gov.tw),依「政府資料開放授權條款-第1版」授權利用。資料提供機關:臺灣證券交易所、證券櫃檯買賣中心、臺灣期貨交易所、臺灣集中保管結算所、國家發展委員會、中央銀行、經濟部統計處、財政部關務署。本服務之加值處理、衍生計算與呈現方式由 TWMD 負責,與各資料提供機關無涉。

引用此資料集

TW Market Data. (n.d.). 現金流量表 [Data set]. TW Market Data. Retrieved 2026-09-05, from https://twmarketdata.com/zh-TW/docs/api/financials/cash-flow-statement

版本取自資料集自己的 as_of，不是這一頁的產生日期。沒有 as_of 的資料集就不列這個欄位，不會補一個看起來合理的值。驗證簽章

可與本資料集對齊的其他資料集。每組都標出可用來 join 的欄位,規劃跨表查詢時不必自己猜。

資產負債表
可用 fiscal_quarter + fiscal_year + report_date + ticker 對齊
損益表
可用 fiscal_quarter + fiscal_year + report_date + ticker 對齊
財務比率指標
可用 fiscal_year + ticker 對齊
集保持股分級集中度
可用 report_date + ticker 對齊
股利政策
可用 ticker 對齊

快速開始

把你的金鑰放進 X-API-Key 標頭。
加上查詢參數（symbol、日期區間、limit）。
送出請求並讀取 rows 陣列。

curl "https://api.twmarketdata.com/v2/datasets/cash-flow-statement?symbol=2330" \
  -H "X-API-Key: sk_live_..."

篩選參數

參數	必填	型別	說明
`symbol`	否	string	股票代碼，例如 2330。

Python 範例

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"])

OpenAPI

此端點為 GET /v2/datasets/cash-flow-statement。完整機器可讀 schema（參數、認證、回應封裝）見 OpenAPI spec。

備註與限制

申報財報具時間點敏感性且會重編:回測時請帶 as_of,只會看到當下已公開的數字。

請求與回應

請求

curl "https://api.twmarketdata.com/v2/datasets/cash-flow-statement?symbol=2330" \
  -H "X-API-Key: $TWMD_API_KEY"

回應

{
  "dataset": "cash_flow_statement",
  "rows": [
    {
      "symbol": "<string>",
      "ticker": "<string>",
      "fiscal_year": "<number>",
      "fiscal_quarter": "<number>",
      "period_type": "<string>",
      "period_end_date": "<string>",
      "report_date": "<null>",
      "operating_cash_flow": "<number>",
      "investing_cash_flow": "<number>",
      "financing_cash_flow": "<number>",
      "free_cash_flow": "<number>",
      "capital_expenditures": "<null>",
      "depreciation": "<null>",
      "cash_beginning": "<null>",
      "cash_ending": "<null>",
      "net_change_in_cash": "<null>",
      "source": "<string>",
      "source_name": "<string>",
      "fiscal_period": "<string>",
      "frequency": "<string>",
      "updated_at": "<string>",
      "fundamentals_context": {
        "generated_at": "<string>",
        "ticker": "<string>",
        "period": "<string>",
        "period_type": "<string>",
        "statement_family": "<string>",
        "metric_values": "<object>",
        "source_lineage": "<object>",
        "data_gaps": "<array>",
        "restatement_warning": "<object>",
        "not_investment_advice": "<boolean>",
        "coverage_window": "<object>",
        "safe_usage_notes": "<array>",
        "available_tools_or_endpoints": "<array>"
      }
    }
  ],
  "count": 50,
  "status": "ok"
}