historical

Get historical analyst estimates for earnings and revenue.

Examples

from openbb import obb
obb.equity.estimates.historical(symbol='AAPL', provider='fmp')

---

Parameters

• standard
• fmp

Name	Type	Description	Default	Optional
symbol	Union[str, List[str]]	Symbol to get data for. Multiple items allowed for provider(s): fmp.		False

Name	Type	Description	Default	Optional
symbol	Union[str, List[str]]	Symbol to get data for. Multiple items allowed for provider(s): fmp.		False
period	Literal['quarter', 'annual']	Time period of the data to return.	annual	True
limit	int	The number of data entries to return.	None	True

---

Returns

OBBject
    results : List[AnalystEstimates]
        Serializable results.

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

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

    chart : Optional[Chart]
        Chart object.

    extra : Dict[str, Any]
        Extra info.

---

Data

• standard
• fmp

Name	Type	Description
symbol	str	Symbol representing the entity requested in the data.
date	Union[date, str]	The date of the data.
estimated_revenue_low	int	Estimated revenue low.
estimated_revenue_high	int	Estimated revenue high.
estimated_revenue_avg	int	Estimated revenue average.
estimated_sga_expense_low	int	Estimated SGA expense low.
estimated_sga_expense_high	int	Estimated SGA expense high.
estimated_sga_expense_avg	int	Estimated SGA expense average.
estimated_ebitda_low	int	Estimated EBITDA low.
estimated_ebitda_high	int	Estimated EBITDA high.
estimated_ebitda_avg	int	Estimated EBITDA average.
estimated_ebit_low	int	Estimated EBIT low.
estimated_ebit_high	int	Estimated EBIT high.
estimated_ebit_avg	int	Estimated EBIT average.
estimated_net_income_low	int	Estimated net income low.
estimated_net_income_high	int	Estimated net income high.
estimated_net_income_avg	int	Estimated net income average.
estimated_eps_avg	float	Estimated EPS average.
estimated_eps_high	float	Estimated EPS high.
estimated_eps_low	float	Estimated EPS low.
number_analyst_estimated_revenue	int	Number of analysts who estimated revenue.
number_analysts_estimated_eps	int	Number of analysts who estimated EPS.

Name	Type	Description
symbol	str	Symbol representing the entity requested in the data.
date	Union[date, str]	The date of the data.
estimated_revenue_low	int	Estimated revenue low.
estimated_revenue_high	int	Estimated revenue high.
estimated_revenue_avg	int	Estimated revenue average.
estimated_sga_expense_low	int	Estimated SGA expense low.
estimated_sga_expense_high	int	Estimated SGA expense high.
estimated_sga_expense_avg	int	Estimated SGA expense average.
estimated_ebitda_low	int	Estimated EBITDA low.
estimated_ebitda_high	int	Estimated EBITDA high.
estimated_ebitda_avg	int	Estimated EBITDA average.
estimated_ebit_low	int	Estimated EBIT low.
estimated_ebit_high	int	Estimated EBIT high.
estimated_ebit_avg	int	Estimated EBIT average.
estimated_net_income_low	int	Estimated net income low.
estimated_net_income_high	int	Estimated net income high.
estimated_net_income_avg	int	Estimated net income average.
estimated_eps_avg	float	Estimated EPS average.
estimated_eps_high	float	Estimated EPS high.
estimated_eps_low	float	Estimated EPS low.
number_analyst_estimated_revenue	int	Number of analysts who estimated revenue.
number_analysts_estimated_eps	int	Number of analysts who estimated EPS.