Financial Data
Company fundamentals, financial statements, market prices and economic data.
取得全部財務報表
一次呼叫取得單一公司的全部三張報表。傳回一個 financials 物件，包含 income_statements、balance_sheets 與 cash_flow_statements，每張的結構與專用工具傳回的相同。period 為必填（annual、quarterly 或 ttm）；透過 ticker 或 cik 指定公司，並用 limit 限制數量。當你需要全貌、否則得呼叫三次時使用它。若只需一張報表，get_financial_financials_income_statements、get_financial_financials_balance_sheets 或 get_financial_financials_cash_flow_statements 傳回的資料少得多；若需跨多家公司取得少量指定欄位，post_financial_financials_search_line_items 的範圍更窄。
計費參考
- 計量方式：以成功請求為固定成本基礎。
- 參考請求估算：0.02 美元。
- 參考客戶倍率：1.0。不得對已結算的客戶金額再次應用。
僅供參考的中繼資料，並非帳戶報價、保證價格或消費上限。資源額度並非 Felo 額度。最終費用依 Felo 計費記錄為準。
- 類型: stringcik
公司的 Central Index Key（CIK）。
- 類型: stringcursor
來自先前回應 next_page_url 的不透明分頁游標。提供後，其他所有查詢參數都會被忽略：游標會攜帶原始請求的篩選條件。請將其視為不透明值，不要自行建構或修改。
- 類型: string 格式: datefiling
_date 依 SEC 申報日期的確切值篩選，格式為 YYYY-MM-DD。沒有已知申報日期的資料列會被排除。
- 類型: string 格式: datefiling
_date _gt 依 SEC 申報日期晚於指定日期篩選，格式為 YYYY-MM-DD。沒有已知申報日期的資料列會被排除。
- 類型: string 格式: datefiling
_date _gte 依 SEC 申報日期晚於或等於指定日期篩選，格式為 YYYY-MM-DD。沒有已知申報日期的資料列會被排除。
- 類型: string 格式: datefiling
_date _lt 依 SEC 申報日期早於指定日期篩選，格式為 YYYY-MM-DD。沒有已知申報日期的資料列會被排除。
- 類型: string 格式: datefiling
_date _lte 依 SEC 申報日期早於或等於指定日期篩選，格式為 YYYY-MM-DD。適用於時點查詢：僅傳回截至該日期已公開申報的資料。沒有已知申報日期的資料列會被排除。
- 類型: integer 格式: int32limit
要傳回的最大財務報表數。這是所有頁面的總數，而非頁面大小：每頁最多包含 10 筆記錄，並透過
next_page_url連結。 - 類型: string 列舉period必填
財務報表的時間期間。
值- annual
- quarterly
- ttm
- 類型: string 格式: datereport
_period 依報告期間日期的確切值篩選，格式為 YYYY-MM-DD。
- 類型: string 格式: datereport
_period _gt 篩選報告期間大於 YYYY-MM-DD 格式的日期。
- 類型: string 格式: datereport
_period _gte 篩選報告期間大於或等於 YYYY-MM-DD 格式的日期。
- 類型: string 格式: datereport
_period _lt 篩選報告期間小於 YYYY-MM-DD 格式的日期。
- 類型: string 格式: datereport
_period _lte 篩選報告期間小於或等於 YYYY-MM-DD 格式的日期。
- 類型: stringticker
股票代號。未提供 cik 時為必填。
- 類型: object · ResponseE40Feb4D3D6B_FinancialsResponse200
財務報表回應
- 類型: objectfinancials
- balance類型: array object[] · ResponseE40Feb4D3D6B_BalanceSheet[]
_sheets - accession類型: string | null
_number 申報文件的 SEC accession number。
- accumulated類型: number
_other _comprehensive _income 公司的累計其他綜合損益。
- cash類型: number
_and _equivalents 公司的現金及約當現金。
- currency類型: string
財務資料報告所用的貨幣。
- current類型: number
_assets 公司的流動資產。
- current類型: number
_debt 公司的短期債務。
- current類型: number
_investments 公司的流動投資。
- current類型: number
_liabilities 公司的流動負債。
- deferred類型: number
_revenue 公司的遞延收入。
- deposit類型: number
_liabilities 公司的存款負債。
- filing類型: string | null 格式: date
_date SEC 受理申報的日曆日，採用美國東部時間（SEC 的營運時區）。與
filing_datetime配對的日曆日。當該列未連結任何帶日期的 SEC 申報文件時為 null。 - filing類型: string | null 格式: date-time
_datetime 記錄 SEC 受理申報的日內時間戳，採用美國東部時間。取自 SEC EDGAR submissions API 上的
acceptanceDateTime欄位。與filing_date配對（同一事件的日曆日精度）。 - filing類型: string | null 格式: uri
_url SEC 申報文件的 URL。
- fiscal類型: string
_period 資產負債表的會計期間。
- form類型: string | null
_type 該列資料來源的 SEC 表單（
10-K、10-Q/A、20-F、S-1……）。這是申報時實際提交的表單，因此修正版會保留/A後綴。當period為ttm時為 null：十二個月滾動窗口可能跨越多個申報文件，因此不會歸屬於單一文件。當第四季由會計年度申報文件推導而來時，quarterly列也可能帶有10-K。 - goodwill類型: number
_and _intangible _assets 公司的商譽及無形資產。
- inventory類型: number
公司的存貨。
- investments類型: number
公司的投資。
- non類型: number
_current _assets 公司的非流動資產。
- non類型: number
_current _debt 公司的非流動債務。
- non類型: number
_current _investments 公司的非流動投資。
- non類型: number
_current _liabilities 公司的非流動負債。
- outstanding類型: number
_shares 公司的流通在外股數。
- period類型: string 列舉
資產負債表的時間期間。
值- quarterly
- ttm
- annual
- property類型: number
_plant _and _equipment 公司的不動產、廠房及設備。
- report類型: string 格式: date
_period 資產負債表的報告期間。
- retained類型: number
_earnings 公司的保留盈餘。
- shareholders類型: number
_equity 公司的股東權益。
- tax類型: number
_assets 公司的稅務資產。
- tax類型: number
_liabilities 公司的稅務負債。
- ticker類型: string
股票代號。
- total類型: number
_assets 公司的總資產。
- total類型: number
_debt 公司的總債務。
- total類型: number
_liabilities 公司的總負債。
- trade類型: number
_and _non _trade _payables 公司的應付帳款及非貿易應付款。
- trade類型: number
_and _non _trade _receivables 公司的應收帳款及非貿易應收款。
- cash類型: array object[] · ResponseE40Feb4D3D6B_CashFlowStatement[]
_flow _statements - accession類型: string | null
_number 申報文件的 SEC accession number。
- business類型: number
_acquisitions _and _disposals 公司的業務收購與處置。
- capital類型: number
_expenditure 公司的資本支出。
- change類型: number
_in _cash _and _equivalents 公司的現金及約當現金變動。
- currency類型: string
財務資料報告所用的貨幣。
- depreciation類型: number
_and _amortization 公司的折舊與攤銷。
- dividends類型: number
_and _other _cash _distributions 公司的股利及其他現金分配。
- effect類型: number
_of _exchange _rate _changes 公司的匯率變動影響。
- ending類型: number
_cash _balance 公司的期末現金餘額。
- filing類型: string | null 格式: date
_date SEC 受理申報的日曆日，採用美國東部時間（SEC 的營運時區）。與
filing_datetime配對的日曆日。當該列未連結任何帶日期的 SEC 申報文件時為 null。 - filing類型: string | null 格式: date-time
_datetime 記錄 SEC 受理申報的日內時間戳，採用美國東部時間。取自 SEC EDGAR submissions API 上的
acceptanceDateTime欄位。與filing_date配對（同一事件的日曆日精度）。 - filing類型: string | null 格式: uri
_url SEC 申報文件的 URL。
- fiscal類型: string
_period 現金流量表的會計期間。
- form類型: string | null
_type 該列資料來源的 SEC 表單（
10-K、10-Q/A、20-F、S-1……）。這是申報時實際提交的表單，因此修正版會保留/A後綴。當period為ttm時為 null：十二個月滾動窗口可能跨越多個申報文件，因此不會歸屬於單一文件。當第四季由會計年度申報文件推導而來時，quarterly列也可能帶有10-K。 - free類型: number
_cash _flow 公司的自由現金流。
- investment類型: number
_acquisitions _and _disposals 公司的投資收購與處置。
- issuance類型: number
_or _purchase _of _equity _shares 公司的股權發行或買回。
- issuance類型: number
_or _repayment _of _debt _securities 公司的債務證券發行或償還。
- net類型: number
_cash _flow _from _financing 公司的籌資活動淨現金流。
- net類型: number
_cash _flow _from _investing 公司的投資活動淨現金流。
- net類型: number
_cash _flow _from _operations 公司的營業活動淨現金流。
- net類型: number
_income 公司的淨利。
- period類型: string 列舉
現金流量表的時間期間。
值- quarterly
- ttm
- annual
- report類型: string 格式: date
_period 現金流量表的報告期間。
- share類型: number
_based _compensation 公司的股份基礎給付酬勞。
- ticker類型: string
股票代號。
- income類型: array object[] · ResponseE40Feb4D3D6B_IncomeStatement[]
_statements - accession類型: string | null
_number 申報文件的 SEC accession number。
- consolidated類型: number
_income 公司的合併收益。
- cost類型: number
_of _revenue 公司的營收成本。
- currency類型: string
財務資料報告所用的貨幣。
- dividends類型: number
_per _common _share 公司的每股普通股股利。
- earnings類型: number
_per _share 公司的每股盈餘。
- earnings類型: number
_per _share _diluted 公司的稀釋每股盈餘。
- ebit類型: number
公司的息稅前利益。
- filing類型: string | null 格式: date
_date SEC 受理申報的日曆日，採用美國東部時間（SEC 的營運時區）。與
filing_datetime配對的日曆日。當該列未連結任何帶日期的 SEC 申報文件時為 null。 - filing類型: string | null 格式: date-time
_datetime 記錄 SEC 受理申報的日內時間戳，採用美國東部時間。取自 SEC EDGAR submissions API 上的
acceptanceDateTime欄位。與filing_date配對（同一事件的日曆日精度）。 - filing類型: string | null 格式: uri
_url SEC 申報文件的 URL。
- fiscal類型: string
_period 損益表的會計期間。
- form類型: string | null
_type 該列資料來源的 SEC 表單（
10-K、10-Q/A、20-F、S-1……）。這是申報時實際提交的表單，因此修正版會保留/A後綴。當period為ttm時為 null：十二個月滾動窗口可能跨越多個申報文件，因此不會歸屬於單一文件。當第四季由會計年度申報文件推導而來時，quarterly列也可能帶有10-K。 - gross類型: number
_profit 公司的毛利。
- income類型: number
_tax _expense 公司的所得稅費用。
- interest類型: number
_expense 公司的利息費用。
- net類型: number
_income 公司的淨利。
- net類型: number
_income _common _stock 公司的普通股股東可獲得的淨利。
- net類型: number
_income _discontinued _operations 公司的終止經營淨利。
- net類型: number
_income _non _controlling _interests 公司的非控制權益淨利。
- operating類型: number
_expense 公司的營業費用。
- operating類型: number
_income 公司的營業利益。
- period類型: string 列舉
損益表的時間期間。
值- quarterly
- ttm
- annual
- preferred類型: number
_dividends _impact 特別股股利對公司淨利的影響。
- report類型: string 格式: date
_period 損益表的報告期間。
- research類型: number
_and _development 公司的研發費用。
- revenue類型: number
公司的總營收。
- selling類型: number
_general _and _administrative _expenses 公司的銷售、一般及管理費用。
- ticker類型: string
股票代號。
- weighted類型: number
_average _shares 公司的加權平均股數。
- weighted類型: number
_average _shares _diluted 公司的稀釋加權平均股數。
- 類型: stringnext
_page _url 下一頁結果的絕對 URL。僅在還有更多結果時出現；依原樣要求即可繼續。每頁最多 10 筆記錄。
application/json - 400
無法處理該要求。請檢查請求參數。
- 401
需要有效的 Felo API 金鑰。
- 402
由於未符合計費要求，要求無法繼續。
- 403
該帳戶無權執行此操作。
- 429
已達到要求或支出上限。
- 502
服務無法完成該要求。
- 503
API 或計費服務暫時無法使用。
- 504
服務在處理要求時逾時。
- default
錯誤回應；上游透傳回應可能採用供應商格式
application/json
curl 'https://openapi.felo.ai/v1/beta/financial/financials?period=annual' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN'
{
"financials": {
"income_statements": [
{
"ticker": "string",
"report_period": "2026-10-26",
"fiscal_period": "string",
"period": "quarterly",
"currency": "string",
"accession_number": null,
"form_type": null,
"filing_url": null,
"filing_date": null,
"filing_datetime": null,
"revenue": 1,
"cost_of_revenue": 1,
"gross_profit": 1,
"operating_expense": 1,
"selling_general_and_administrative_expenses": 1,
"research_and_development": 1,
"operating_income": 1,
"interest_expense": 1,
"ebit": 1,
"income_tax_expense": 1,
"net_income_discontinued_operations": 1,
"net_income_non_controlling_interests": 1,
"net_income": 1,
"net_income_common_stock": 1,
"preferred_dividends_impact": 1,
"consolidated_income": 1,
"earnings_per_share": 1,
"earnings_per_share_diluted": 1,
"dividends_per_common_share": 1,
"weighted_average_shares": 1,
"weighted_average_shares_diluted": 1
}
],
"balance_sheets": [
{
"ticker": "string",
"report_period": "2026-10-26",
"fiscal_period": "string",
"period": "quarterly",
"currency": "string",
"accession_number": null,
"form_type": null,
"filing_url": null,
"filing_date": null,
"filing_datetime": null,
"total_assets": 1,
"current_assets": 1,
"cash_and_equivalents": 1,
"inventory": 1,
"current_investments": 1,
"trade_and_non_trade_receivables": 1,
"non_current_assets": 1,
"property_plant_and_equipment": 1,
"goodwill_and_intangible_assets": 1,
"investments": 1,
"non_current_investments": 1,
"outstanding_shares": 1,
"tax_assets": 1,
"total_liabilities": 1,
"current_liabilities": 1,
"current_debt": 1,
"trade_and_non_trade_payables": 1,
"deferred_revenue": 1,
"deposit_liabilities": 1,
"non_current_liabilities": 1,
"non_current_debt": 1,
"tax_liabilities": 1,
"shareholders_equity": 1,
"retained_earnings": 1,
"accumulated_other_comprehensive_income": 1,
"total_debt": 1
}
],
"cash_flow_statements": [
{
"ticker": "string",
"report_period": "2026-10-26",
"fiscal_period": "string",
"period": "quarterly",
"currency": "string",
"accession_number": null,
"form_type": null,
"filing_url": null,
"filing_date": null,
"filing_datetime": null,
"net_income": 1,
"depreciation_and_amortization": 1,
"share_based_compensation": 1,
"net_cash_flow_from_operations": 1,
"capital_expenditure": 1,
"business_acquisitions_and_disposals": 1,
"investment_acquisitions_and_disposals": 1,
"net_cash_flow_from_investing": 1,
"issuance_or_repayment_of_debt_securities": 1,
"issuance_or_purchase_of_equity_shares": 1,
"dividends_and_other_cash_distributions": 1,
"net_cash_flow_from_financing": 1,
"change_in_cash_and_equivalents": 1,
"effect_of_exchange_rate_changes": 1,
"ending_cash_balance": 1,
"free_cash_flow": 1
}
]
},
"next_page_url": "string"
}