# 取得現金流量表 **API:** Data API **Endpoint:** `GET /v1/beta/financial/financials/cash-flow-statements` **Tags:** Financial Data 單一公司的現金流量表，每期約 27 個欄位：`net_cash_flow_from_operations`、`net_cash_flow_from_investing`、`net_cash_flow_from_financing`、`capital_expenditure`、`depreciation_and_amortization`、`share_based_compensation`、`issuance_or_repayment_of_debt_securities`、`issuance_or_purchase_of_equity_shares` 與 `dividends_and_other_cash_distributions`，並標註 `report_period`、`fiscal_period` 與 `currency`。`period` 為必填。用於查看現金創造能力，而非會計盈餘。自由現金流量收益率及類似衍生指標位於 `get_financial_financial_metrics`。 ### 計費參考 - 計量方式：以成功請求為固定成本基礎。 - 參考請求估算：0.02 美元。 - 參考客戶倍率：1.0。不得對已結算的客戶金額再次應用。 僅供參考的中繼資料，並非帳戶報價、保證價格或消費上限。資源額度並非 Felo 額度。最終費用依 Felo 計費記錄為準。 ## Base URL - `https://openapi.felo.ai` ## Authentication - `FeloBearerAuth` (http bearer, bearer format Felo API Key) - `FeloApiKey` (apiKey in header `X-API-Key`) ## Parameters | Name | In | Required | Type | Description | | --- | --- | --- | --- | --- | | `cik` | query | no | string | 公司的 Central Index Key（CIK）。 | | `cursor` | query | no | string | 來自先前回應 next_page_url 的不透明分頁游標。提供後，其他所有查詢參數都會被忽略：游標會攜帶原始請求的篩選條件。請將其視為不透明值，不要自行建構或修改。 | | `filing_date` | query | no | string, (date) | 依 SEC 申報日期的確切值篩選，格式為 YYYY-MM-DD。沒有已知申報日期的資料列會被排除。 | | `filing_date_gt` | query | no | string, (date) | 依 SEC 申報日期晚於指定日期篩選，格式為 YYYY-MM-DD。沒有已知申報日期的資料列會被排除。 | | `filing_date_gte` | query | no | string, (date) | 依 SEC 申報日期晚於或等於指定日期篩選，格式為 YYYY-MM-DD。沒有已知申報日期的資料列會被排除。 | | `filing_date_lt` | query | no | string, (date) | 依 SEC 申報日期早於指定日期篩選，格式為 YYYY-MM-DD。沒有已知申報日期的資料列會被排除。 | | `filing_date_lte` | query | no | string, (date) | 依 SEC 申報日期早於或等於指定日期篩選，格式為 YYYY-MM-DD。適用於時點查詢：僅傳回截至該日期已公開申報的資料。沒有已知申報日期的資料列會被排除。 | | `limit` | query | no | integer, (int32) | 要傳回的現金流量表數量上限。這是所有頁面的總數，而非每頁大小：每頁最多 10 筆記錄，透過 `next_page_url` 串接。 | | `period` | query | yes | string, enum: "annual", "quarterly", "ttm" | 現金流量表的時間期間。 | | `report_period` | query | no | string, (date) | 依報告期間日期的確切值篩選，格式為 YYYY-MM-DD。 | | `report_period_gt` | query | no | string, (date) | 篩選報告期間大於 YYYY-MM-DD 格式的日期。 | | `report_period_gte` | query | no | string, (date) | 篩選報告期間大於或等於 YYYY-MM-DD 格式的日期。 | | `report_period_lt` | query | no | string, (date) | 篩選報告期間小於 YYYY-MM-DD 格式的日期。 | | `report_period_lte` | query | no | string, (date) | 篩選報告期間小於或等於 YYYY-MM-DD 格式的日期。 | | `ticker` | query | no | string | 股票代號。未提供 cik 時為必填。 | ## Responses ### 200 — 現金流量表回應 Headers: - `X-Request-Id` (string) — 聯絡 Felo 支援時需提供的請求識別碼。 **application/json** Schema: `ResponseE40Feb4D3D6B_CashFlowStatementResponse` (`#/components/schemas/ResponseE40Feb4D3D6B_CashFlowStatementResponse`) ### 400 — 無法處理該要求。請檢查請求參數。 ### 401 — 需要有效的 Felo API 金鑰。 ### 402 — 由於未符合計費要求，要求無法繼續。 ### 403 — 該帳戶無權執行此操作。 ### 429 — 已達到要求或支出上限。 ### 502 — 服務無法完成該要求。 ### 503 — API 或計費服務暫時無法使用。 ### 504 — 服務在處理要求時逾時。 ### default — 錯誤回應；上游透傳回應可能採用供應商格式 **application/json** Schema: ```json {} ``` ## Schema definitions ### ResponseE40Feb4D3D6B_CashFlowStatement `#/components/schemas/ResponseE40Feb4D3D6B_CashFlowStatement` ```json { "type": "object", "properties": { "ticker": { "type": "string", "description": "股票代號。" }, "report_period": { "type": "string", "format": "date", "description": "現金流量表的報告期間。" }, "fiscal_period": { "type": "string", "description": "現金流量表的會計期間。" }, "period": { "type": "string", "enum": [ "quarterly", "ttm", "annual" ], "description": "現金流量表的時間期間。" }, "currency": { "type": "string", "description": "財務資料報告所用的貨幣。" }, "accession_number": { "type": [ "string", "null" ], "description": "申報文件的 SEC accession number。" }, "form_type": { "type": [ "string", "null" ], "description": "該列資料來源的 SEC 表單（`10-K`、`10-Q/A`、`20-F`、`S-1`……）。這是申報時實際提交的表單，因此修正版會保留 `/A` 後綴。當 `period` 為 `ttm` 時為 null：十二個月滾動窗口可能跨越多個申報文件，因此不會歸屬於單一文件。當第四季由會計年度申報文件推導而來時，`quarterly` 列也可能帶有 `10-K`。" }, "filing_url": { "type": [ "string", "null" ], "format": "uri", "description": "SEC 申報文件的 URL。" }, "filing_date": { "type": [ "string", "null" ], "format": "date", "description": "SEC 受理申報的日曆日，採用美國東部時間（SEC 的營運時區）。與 `filing_datetime` 配對的日曆日。當該列未連結任何帶日期的 SEC 申報文件時為 null。" }, "filing_datetime": { "type": [ "string", "null" ], "format": "date-time", "description": "記錄 SEC 受理申報的日內時間戳，採用美國東部時間。取自 SEC EDGAR submissions API 上的 `acceptanceDateTime` 欄位。與 `filing_date` 配對（同一事件的日曆日精度）。" }, "net_income": { "type": "number", "description": "公司的淨利。" }, "depreciation_and_amortization": { "type": "number", "description": "公司的折舊與攤銷。" }, "share_based_compensation": { "type": "number", "description": "公司的股份基礎給付酬勞。" }, "net_cash_flow_from_operations": { "type": "number", "description": "公司的營業活動淨現金流。" }, "capital_expenditure": { "type": "number", "description": "公司的資本支出。" }, "business_acquisitions_and_disposals": { "type": "number", "description": "公司的業務收購與處置。" }, "investment_acquisitions_and_disposals": { "type": "number", "description": "公司的投資收購與處置。" }, "net_cash_flow_from_investing": { "type": "number", "description": "公司的投資活動淨現金流。" }, "issuance_or_repayment_of_debt_securities": { "type": "number", "description": "公司的債務證券發行或償還。" }, "issuance_or_purchase_of_equity_shares": { "type": "number", "description": "公司的股權發行或買回。" }, "dividends_and_other_cash_distributions": { "type": "number", "description": "公司的股利及其他現金分配。" }, "net_cash_flow_from_financing": { "type": "number", "description": "公司的籌資活動淨現金流。" }, "change_in_cash_and_equivalents": { "type": "number", "description": "公司的現金及約當現金變動。" }, "effect_of_exchange_rate_changes": { "type": "number", "description": "公司的匯率變動影響。" }, "ending_cash_balance": { "type": "number", "description": "公司的期末現金餘額。" }, "free_cash_flow": { "type": "number", "description": "公司的自由現金流。" } } } ``` ### ResponseE40Feb4D3D6B_CashFlowStatementResponse `#/components/schemas/ResponseE40Feb4D3D6B_CashFlowStatementResponse` ```json { "type": "object", "properties": { "cash_flow_statements": { "type": "array", "items": { "$ref": "#/components/schemas/ResponseE40Feb4D3D6B_CashFlowStatement" } }, "next_page_url": { "type": "string", "description": "下一頁結果的絕對 URL。僅在還有更多結果時出現；依原樣要求即可繼續。每頁最多 10 筆記錄。" } } } ```