Felo API PlatformFelo API Platform

Data 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.

Parameters

query

  • tickerstringOptional

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

  • cikstringOptional

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

  • periodstringRequired

    Allowed values: annual · quarterly · ttm

    The time period for the financial data.

  • limitintegerOptional

    The maximum number of results to return.

  • report_periodstringOptional

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

  • report_period_gtestringOptional

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

  • report_period_ltestringOptional

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

  • report_period_gtstringOptional

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

  • report_period_ltstringOptional

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

Example request

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

Response

Response fields

  • financial_metricsobject[]Optional

    Historical financial metrics and ratios for the requested ticker.

  • tickerstringOptional

    The ticker symbol of the company.

  • market_capnumberOptional

    The market capitalization of the company.

  • enterprise_valuenumberOptional

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

  • price_to_earnings_rationumberOptional

    Price to earnings ratio.

  • price_to_book_rationumberOptional

    Price to book ratio.

  • price_to_sales_rationumberOptional

    Price to sales ratio.

  • enterprise_value_to_ebitda_rationumberOptional

    Enterprise value to EBITDA ratio.

  • enterprise_value_to_revenue_rationumberOptional

    Enterprise value to revenue ratio.

  • free_cash_flow_yieldnumberOptional

    Free cash flow yield.

  • peg_rationumberOptional

    Price to earnings growth ratio.

  • gross_marginnumberOptional

    Gross profit as a percentage of revenue.

  • operating_marginnumberOptional

    Operating income as a percentage of revenue.

  • net_marginnumberOptional

    Net income as a percentage of revenue.

  • return_on_equitynumberOptional

    Net income as a percentage of shareholders' equity.

  • return_on_assetsnumberOptional

    Net income as a percentage of total assets.

  • return_on_invested_capitalnumberOptional

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

  • asset_turnovernumberOptional

    Revenue divided by average total assets.

  • inventory_turnovernumberOptional

    Cost of goods sold divided by average inventory.

  • receivables_turnovernumberOptional

    Revenue divided by average accounts receivable.

  • days_sales_outstandingnumberOptional

    Average accounts receivable divided by revenue over the period.

  • operating_cyclenumberOptional

    Inventory turnover + receivables turnover.

  • working_capital_turnovernumberOptional

    Revenue divided by average working capital.

  • current_rationumberOptional

    Current assets divided by current liabilities.

  • quick_rationumberOptional

    Quick assets divided by current liabilities.

  • cash_rationumberOptional

    Cash and cash equivalents divided by current liabilities.

  • operating_cash_flow_rationumberOptional

    Operating cash flow divided by current liabilities.

  • debt_to_equitynumberOptional

    Total debt divided by shareholders' equity.

  • debt_to_assetsnumberOptional

    Total debt divided by total assets.

  • interest_coveragenumberOptional

    EBIT divided by interest expense.

  • revenue_growthnumberOptional

    Year-over-year growth in revenue.

  • earnings_growthnumberOptional

    Year-over-year growth in earnings.

  • book_value_growthnumberOptional

    Year-over-year growth in book value.

  • earnings_per_share_growthnumberOptional

    Growth in earnings per share over the period.

  • free_cash_flow_growthnumberOptional

    Growth in free cash flow over the period.

  • operating_income_growthnumberOptional

    Growth in operating income over the period.

  • ebitda_growthnumberOptional

    Growth in EBITDA over the period.

  • payout_rationumberOptional

    Dividends paid as a percentage of net income.

  • earnings_per_sharenumberOptional

    Net income divided by weighted average shares outstanding.

  • book_value_per_sharenumberOptional

    Shareholders' equity divided by shares outstanding.

  • free_cash_flow_per_sharenumberOptional

    Free cash flow divided by shares outstanding.