Felo API PlatformFelo API Platform

数据 API / Financial Data / Financial Metrics

Get financial metrics

Computed ratios for one company over time, about 49 per period: 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, the turnover and liquidity ratios, each stamped with report_period and fiscal_period. period is required; identify by ticker or cik. Use it to trend a ratio across periods. For the current values only, get_financial_financial_metrics_snapshot is one row and much smaller.

参数

查询

  • tickerstring可选

    The ticker symbol of the company. Required if cik is not provided.

  • cikstring可选

    The Central Index Key (CIK) of the company. Can be used instead of ticker.

  • periodstring必填

    允许值： annual · quarterly · ttm

    The time period for the financial data.

  • limitinteger可选

    The maximum number of results to return.

  • report_periodstring可选

    Filter by exact report period date in YYYY-MM-DD format.

  • report_period_gtestring可选

    Filter by report period greater than or equal to date in YYYY-MM-DD format.

  • report_period_ltestring可选

    Filter by report period less than or equal to date in YYYY-MM-DD format.

  • report_period_gtstring可选

    Filter by report period greater than date in YYYY-MM-DD format.

  • report_period_ltstring可选

    Filter by report period less than date in YYYY-MM-DD format.

请求示例

curl -G "https://openapi.felo.ai/v1/beta/financial/financial-metrics" \
  --data-urlencode "period=<string>" \
  -H "Authorization: Bearer $FELO_API_KEY"

响应

响应字段

  • financial_metricsobject[]可选

    Historical financial metrics and ratios for the requested ticker.

  • tickerstring可选

    The ticker symbol of the company.

  • market_capnumber可选

    The market capitalization of the company.

  • enterprise_valuenumber可选

    The total value of the company (market cap + debt - cash).

  • price_to_earnings_rationumber可选

    Price to earnings ratio.

  • price_to_book_rationumber可选

    Price to book ratio.

  • price_to_sales_rationumber可选

    Price to sales ratio.

  • enterprise_value_to_ebitda_rationumber可选

    Enterprise value to EBITDA ratio.

  • enterprise_value_to_revenue_rationumber可选

    Enterprise value to revenue ratio.

  • free_cash_flow_yieldnumber可选

    Free cash flow yield.

  • peg_rationumber可选

    Price to earnings growth ratio.

  • gross_marginnumber可选

    Gross profit as a percentage of revenue.

  • operating_marginnumber可选

    Operating income as a percentage of revenue.

  • net_marginnumber可选

    Net income as a percentage of revenue.

  • return_on_equitynumber可选

    Net income as a percentage of shareholders' equity.

  • return_on_assetsnumber可选

    Net income as a percentage of total assets.

  • return_on_invested_capitalnumber可选

    Net operating profit after taxes as a percentage of invested capital.

  • asset_turnovernumber可选

    Revenue divided by average total assets.

  • inventory_turnovernumber可选

    Cost of goods sold divided by average inventory.

  • receivables_turnovernumber可选

    Revenue divided by average accounts receivable.

  • days_sales_outstandingnumber可选

    Average accounts receivable divided by revenue over the period.

  • operating_cyclenumber可选

    Inventory turnover + receivables turnover.

  • working_capital_turnovernumber可选

    Revenue divided by average working capital.

  • current_rationumber可选

    Current assets divided by current liabilities.

  • quick_rationumber可选

    Quick assets divided by current liabilities.

  • cash_rationumber可选

    Cash and cash equivalents divided by current liabilities.

  • operating_cash_flow_rationumber可选

    Operating cash flow divided by current liabilities.

  • debt_to_equitynumber可选

    Total debt divided by shareholders' equity.

  • debt_to_assetsnumber可选

    Total debt divided by total assets.

  • interest_coveragenumber可选

    EBIT divided by interest expense.

  • revenue_growthnumber可选

    Year-over-year growth in revenue.

  • earnings_growthnumber可选

    Year-over-year growth in earnings.

  • book_value_growthnumber可选

    Year-over-year growth in book value.

  • earnings_per_share_growthnumber可选

    Growth in earnings per share over the period.

  • free_cash_flow_growthnumber可选

    Growth in free cash flow over the period.

  • operating_income_growthnumber可选

    Growth in operating income over the period.

  • ebitda_growthnumber可选

    Growth in EBITDA over the period.

  • payout_rationumber可选

    Dividends paid as a percentage of net income.

  • earnings_per_sharenumber可选

    Net income divided by weighted average shares outstanding.

  • book_value_per_sharenumber可选

    Shareholders' equity divided by shares outstanding.

  • free_cash_flow_per_sharenumber可选

    Free cash flow divided by shares outstanding.