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.

Параметры

запрос

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