Financial Data
Company fundamentals, financial statements, market prices and economic data.
取得財務指標
單一公司隨時間計算的比率，每期約 49 項：market_cap、enterprise_value、price_to_earnings_ratio、price_to_book_ratio、price_to_sales_ratio、enterprise_value_to_ebitda_ratio、free_cash_flow_yield、peg_ratio、gross_margin、operating_margin、net_margin、return_on_equity、return_on_assets、return_on_invested_capital、週轉率與流動性比率，每項都標註 report_period 與 fiscal_period。period 為必填；透過 ticker 或 cik 指定公司。用於觀察某個比率跨期的趨勢。若只需目前數值，get_financial_financial_metrics_snapshot 只傳回一列，體積小得多。
計費參考
- 計量方式：以成功請求為固定成本基礎。
- 參考請求估算：0.02 美元。
- 參考客戶倍率：1.0。不得對已結算的客戶金額再次應用。
僅供參考的中繼資料，並非帳戶報價、保證價格或消費上限。資源額度並非 Felo 額度。最終費用依 Felo 計費記錄為準。
- 類型: stringcik
公司的 Central Index Key（CIK）。可用於替代 ticker。
- 類型: 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。適用於時點查詢：僅傳回截至該日期已公開申報的資料。沒有已知申報日期的資料列會被排除。
- 類型: integerlimit
要傳回的最大結果數。這是所有頁面的總數，而非頁面大小：每頁最多包含 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_FinancialMetricsResponse200
某個 ticker 的歷史財務指標與比率
- 類型: string | nullaccession
_number 申報文件的 SEC accession number。
- 類型: numberasset
_turnover 營收除以平均總資產。
- 類型: numberbook
_value _growth 帳面價值的年增率。
- 類型: number
股東權益除以流通在外股數。
- 類型: numbercash
_ratio 現金及約當現金除以流動負債。
- 類型: stringcurrency
財務資料報告所用的貨幣。
- 類型: numbercurrent
_ratio 流動資產除以流動負債。
- 類型: numberdays
_sales _outstanding 期間平均應收帳款除以營收。
- 類型: numberdebt
_to _assets 總債務除以總資產。
- 類型: numberdebt
_to _equity 總債務除以股東權益。
- 類型: numberearnings
_growth 盈餘的年增率。
- 類型: number
淨利除以加權平均流通在外股數。
- 類型: number
期間內每股盈餘的成長。
- 類型: numberebitda
_growth 期間內 EBITDA 的成長。
- 類型: numberenterprise
_value 公司的總價值（市值 + 債務 - 現金）。
- 類型: numberenterprise
_value _to _ebitda _ratio 企業價值對 EBITDA 比率。
- 類型: numberenterprise
_value _to _revenue _ratio 企業價值對營收比率。
- 類型: string | null 格式: datefiling
_date SEC 受理申報的日曆日，採用美國東部時間（SEC 的營運時區）。與
filing_datetime配對的日曆日。當該列未連結任何帶日期的 SEC 申報文件時為 null。 - 類型: string | null 格式: date-timefiling
_datetime 記錄 SEC 受理申報的日內時間戳，採用美國東部時間。取自 SEC EDGAR submissions API 上的
acceptanceDateTime欄位。與filing_date配對（同一事件的日曆日精度）。 - 類型: string | null 格式: urifiling
_url SEC 申報文件的 URL。
- 類型: stringfiscal
_period 財務指標的會計期間。
- 類型: string | nullform
_type 該列資料來源的 SEC 表單（
10-K、10-Q/A、20-F、S-1……）。這是申報時實際提交的表單，因此修正版會保留/A後綴。當period為ttm時為 null：十二個月滾動窗口可能跨越多個申報文件，因此不會歸屬於單一文件。當第四季由會計年度申報文件推導而來時，quarterly列也可能帶有10-K。 - 類型: numberfree
_cash _flow _growth 期間內自由現金流的成長。
- 類型: number
自由現金流除以流通在外股數。
- 類型: numberfree
_cash _flow _yield 自由現金流殖利率。
- 類型: numbergross
_margin 毛利占營收的百分比。
- 類型: numberinterest
_coverage EBIT 除以利息費用。
- 類型: numberinventory
_turnover 銷貨成本除以平均存貨。
- 類型: numbernet
_margin 淨利占營收的百分比。
- 類型: stringnext
_page _url 下一頁結果的絕對 URL。僅在還有更多結果時出現；依原樣要求即可繼續。每頁最多 10 筆記錄。
- 類型: numberoperating
_cash _flow _ratio 營業現金流除以流動負債。
- 類型: numberoperating
_cycle 存貨週轉率 + 應收帳款週轉率。
- 類型: numberoperating
_income _growth 期間內營業利益的成長。
- 類型: numberoperating
_margin 營業利益占營收的百分比。
- 類型: numberpayout
_ratio 已付股利占淨利的百分比。
- 類型: numberpeg
_ratio 本益成長比。
- 類型: string 列舉period
財務指標的時間期間。
值- quarterly
- ttm
- annual
- 類型: numberprice
_to _book _ratio 股價淨值比。
- 類型: numberprice
_to _earnings _ratio 本益比。
- 類型: numberprice
_to _sales _ratio 股價營收比。
- 類型: numberquick
_ratio 速動資產除以流動負債。
- 類型: numberreceivables
_turnover 營收除以平均應收帳款。
- 類型: string 格式: datereport
_period 財務指標的報告期間。
- 類型: numberreturn
_on _assets 淨利占總資產的百分比。
- 類型: numberreturn
_on _equity 淨利占股東權益的百分比。
- 類型: numberreturn
_on _invested _capital 稅後淨營業利益占投入資本的百分比。
- 類型: numberrevenue
_growth 營收的年增率。
- 類型: stringticker
公司的 ticker 代碼。
- 類型: numberworking
_capital _turnover 營收除以平均營運資金。
application/json - 400
無法處理該要求。請檢查請求參數。
- 401
需要有效的 Felo API 金鑰。
- 402
由於未符合計費要求，要求無法繼續。
- 403
該帳戶無權執行此操作。
- 429
已達到要求或支出上限。
- 502
服務無法完成該要求。
- 503
API 或計費服務暫時無法使用。
- 504
服務在處理要求時逾時。
- default
錯誤回應；上游透傳回應可能採用供應商格式
application/json
curl 'https://openapi.felo.ai/v1/beta/financial/financial-metrics?period=annual' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN'
{
"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,
"enterprise_value": 1,
"price_to_earnings_ratio": 1,
"price_to_book_ratio": 1,
"price_to_sales_ratio": 1,
"enterprise_value_to_ebitda_ratio": 1,
"enterprise_value_to_revenue_ratio": 1,
"free_cash_flow_yield": 1,
"peg_ratio": 1,
"gross_margin": 1,
"operating_margin": 1,
"net_margin": 1,
"return_on_equity": 1,
"return_on_assets": 1,
"return_on_invested_capital": 1,
"asset_turnover": 1,
"inventory_turnover": 1,
"receivables_turnover": 1,
"days_sales_outstanding": 1,
"operating_cycle": 1,
"working_capital_turnover": 1,
"current_ratio": 1,
"quick_ratio": 1,
"cash_ratio": 1,
"operating_cash_flow_ratio": 1,
"debt_to_equity": 1,
"debt_to_assets": 1,
"interest_coverage": 1,
"revenue_growth": 1,
"earnings_growth": 1,
"book_value_growth": 1,
"earnings_per_share_growth": 1,
"free_cash_flow_growth": 1,
"operating_income_growth": 1,
"ebitda_growth": 1,
"payout_ratio": 1,
"earnings_per_share": 1,
"book_value_per_share": 1,
"free_cash_flow_per_share": 1,
"next_page_url": "string"
}