ratios

Get an extensive set of financial and accounting ratios for a given company over time.

Examples

from openbb import obb
obb.equity.fundamental.ratios(symbol='AAPL', provider='fmp')
obb.equity.fundamental.ratios(symbol='AAPL', period=annual, limit=12, provider='intrinio')

---

Parameters

• standard
• fmp
• intrinio

Name	Type	Description	Default	Optional
symbol	str	Symbol to get data for.		False
limit	int	The number of data entries to return.	12	True

Name	Type	Description	Default	Optional
symbol	str	Symbol to get data for.		False
limit	int	The number of data entries to return.	12	True
period	Literal['annual', 'quarter', 'ttm']	Time period of the data to return.	annual	True

Name	Type	Description	Default	Optional
symbol	str	Symbol to get data for.		False
limit	int	The number of data entries to return.	12	True
period	Literal['annual', 'quarter', 'ttm', 'ytd']	Time period of the data to return.	annual	True
fiscal_year	int	The specific fiscal year. Reports do not go beyond 2008.	None	True

---

Returns

OBBject
    results : List[FinancialRatios]
        Serializable results.

    provider : Optional[Literal['fmp', 'intrinio']]
        Provider name.

    warnings : Optional[List[Warning_]]
        List of warnings.

    chart : Optional[Chart]
        Chart object.

    extra : Dict[str, Any]
        Extra info.

---

Data

• standard
• fmp
• intrinio

Name	Type	Description
period_ending	str	The date of the data.
fiscal_period	str	Period of the financial ratios.
fiscal_year	int	Fiscal year.

Name	Type	Description
period_ending	str	The date of the data.
fiscal_period	str	Period of the financial ratios.
fiscal_year	int	Fiscal year.
current_ratio	float	Current ratio.
quick_ratio	float	Quick ratio.
cash_ratio	float	Cash ratio.
days_of_sales_outstanding	float	Days of sales outstanding.
days_of_inventory_outstanding	float	Days of inventory outstanding.
operating_cycle	float	Operating cycle.
days_of_payables_outstanding	float	Days of payables outstanding.
cash_conversion_cycle	float	Cash conversion cycle.
gross_profit_margin	float	Gross profit margin.
operating_profit_margin	float	Operating profit margin.
pretax_profit_margin	float	Pretax profit margin.
net_profit_margin	float	Net profit margin.
effective_tax_rate	float	Effective tax rate.
return_on_assets	float	Return on assets.
return_on_equity	float	Return on equity.
return_on_capital_employed	float	Return on capital employed.
net_income_per_ebt	float	Net income per EBT.
ebt_per_ebit	float	EBT per EBIT.
ebit_per_revenue	float	EBIT per revenue.
debt_ratio	float	Debt ratio.
debt_equity_ratio	float	Debt equity ratio.
long_term_debt_to_capitalization	float	Long term debt to capitalization.
total_debt_to_capitalization	float	Total debt to capitalization.
interest_coverage	float	Interest coverage.
cash_flow_to_debt_ratio	float	Cash flow to debt ratio.
company_equity_multiplier	float	Company equity multiplier.
receivables_turnover	float	Receivables turnover.
payables_turnover	float	Payables turnover.
inventory_turnover	float	Inventory turnover.
fixed_asset_turnover	float	Fixed asset turnover.
asset_turnover	float	Asset turnover.
operating_cash_flow_per_share	float	Operating cash flow per share.
free_cash_flow_per_share	float	Free cash flow per share.
cash_per_share	float	Cash per share.
payout_ratio	float	Payout ratio.
operating_cash_flow_sales_ratio	float	Operating cash flow sales ratio.
free_cash_flow_operating_cash_flow_ratio	float	Free cash flow operating cash flow ratio.
cash_flow_coverage_ratios	float	Cash flow coverage ratios.
short_term_coverage_ratios	float	Short term coverage ratios.
capital_expenditure_coverage_ratio	float	Capital expenditure coverage ratio.
dividend_paid_and_capex_coverage_ratio	float	Dividend paid and capex coverage ratio.
dividend_payout_ratio	float	Dividend payout ratio.
price_book_value_ratio	float	Price book value ratio.
price_to_book_ratio	float	Price to book ratio.
price_to_sales_ratio	float	Price to sales ratio.
price_earnings_ratio	float	Price earnings ratio.
price_to_free_cash_flows_ratio	float	Price to free cash flows ratio.
price_to_operating_cash_flows_ratio	float	Price to operating cash flows ratio.
price_cash_flow_ratio	float	Price cash flow ratio.
price_earnings_to_growth_ratio	float	Price earnings to growth ratio.
price_sales_ratio	float	Price sales ratio.
dividend_yield	float	Dividend yield.
dividend_yield_percentage	float	Dividend yield percentage.
dividend_per_share	float	Dividend per share.
enterprise_value_multiple	float	Enterprise value multiple.
price_fair_value	float	Price fair value.

Name	Type	Description
period_ending	str	The date of the data.
fiscal_period	str	Period of the financial ratios.
fiscal_year	int	Fiscal year.