forward_eps

Get forward EPS estimates.

Examples

from openbb import obb
obb.equity.estimates.forward_eps(symbol='AAPL', provider='intrinio')
obb.equity.estimates.forward_eps(fiscal_year=2025, fiscal_period=fy, provider='intrinio')

---

Parameters

• standard
• fmp
• intrinio
• seeking_alpha

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

Name	Type	Description	Default	Optional
symbol	Union[str, List[str]]	Symbol to get data for. Multiple items allowed for provider(s): fmp, intrinio, seeking_alpha.	None	True
fiscal_period	Literal['annual', 'quarter']	The future fiscal period to retrieve estimates for.	annual	True
limit	int	The number of data entries to return.	None	True
include_historical	bool	If True, the data will include all past data and the limit will be ignored.	False	True

Name	Type	Description	Default	Optional
symbol	Union[str, List[str]]	Symbol to get data for. Multiple items allowed for provider(s): fmp, intrinio, seeking_alpha.	None	True
fiscal_year	int	The future fiscal year to retrieve estimates for. When no symbol and year is supplied the current calendar year is used.	None	True
fiscal_period	Literal['fy', 'q1', 'q2', 'q3', 'q4']	The future fiscal period to retrieve estimates for.	None	True
calendar_year	int	The future calendar year to retrieve estimates for. When no symbol and year is supplied the current calendar year is used.	None	True
calendar_period	Literal['q1', 'q2', 'q3', 'q4']	The future calendar period to retrieve estimates for.	None	True

Name	Type	Description	Default	Optional
symbol	Union[str, List[str]]	Symbol to get data for. Multiple items allowed for provider(s): fmp, intrinio, seeking_alpha.	None	True
period	Literal['annual', 'quarter']	The reporting period.	quarter	True

---

Returns

OBBject
    results : List[ForwardEpsEstimates]
        Serializable results.

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

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

    chart : Optional[Chart]
        Chart object.

    extra : Dict[str, Any]
        Extra info.

---

Data

• standard
• fmp
• intrinio
• seeking_alpha

Name	Type	Description
symbol	str	Symbol representing the entity requested in the data.
name	str	Name of the entity.
date	Union[date, str]	The date of the data.
fiscal_year	int	Fiscal year for the estimate.
fiscal_period	str	Fiscal quarter for the estimate.
calendar_year	int	Calendar year for the estimate.
calendar_period	str	Calendar quarter for the estimate.
low_estimate	float	Estimated EPS low for the period.
high_estimate	float	Estimated EPS high for the period.
mean	float	Estimated EPS mean for the period.
median	float	Estimated EPS median for the period.
standard_deviation	float	Estimated EPS standard deviation for the period.
number_of_analysts	int	Number of analysts providing estimates for the period.

Name	Type	Description
symbol	str	Symbol representing the entity requested in the data.
name	str	Name of the entity.
date	Union[date, str]	The date of the data.
fiscal_year	int	Fiscal year for the estimate.
fiscal_period	str	Fiscal quarter for the estimate.
calendar_year	int	Calendar year for the estimate.
calendar_period	str	Calendar quarter for the estimate.
low_estimate	float	Estimated EPS low for the period.
high_estimate	float	Estimated EPS high for the period.
mean	float	Estimated EPS mean for the period.
median	float	Estimated EPS median for the period.
standard_deviation	float	Estimated EPS standard deviation for the period.
number_of_analysts	int	Number of analysts providing estimates for the period.

Name	Type	Description
symbol	str	Symbol representing the entity requested in the data.
name	str	Name of the entity.
date	Union[date, str]	The date of the data.
fiscal_year	int	Fiscal year for the estimate.
fiscal_period	str	Fiscal quarter for the estimate.
calendar_year	int	Calendar year for the estimate.
calendar_period	str	Calendar quarter for the estimate.
low_estimate	float	Estimated EPS low for the period.
high_estimate	float	Estimated EPS high for the period.
mean	float	Estimated EPS mean for the period.
median	float	Estimated EPS median for the period.
standard_deviation	float	Estimated EPS standard deviation for the period.
number_of_analysts	int	Number of analysts providing estimates for the period.
revisions_change_percent	float	The earnings per share (EPS) percent change in estimate for the period.
mean_1w	float	The mean estimate for the period one week ago.
mean_1m	float	The mean estimate for the period one month ago.
mean_2m	float	The mean estimate for the period two months ago.
mean_3m	float	The mean estimate for the period three months ago.

Name	Type	Description
symbol	str	Symbol representing the entity requested in the data.
name	str	Name of the entity.
date	Union[date, str]	The date of the data.
fiscal_year	int	Fiscal year for the estimate.
fiscal_period	str	Fiscal quarter for the estimate.
calendar_year	int	Calendar year for the estimate.
calendar_period	str	Calendar quarter for the estimate.
low_estimate	float	Estimated EPS low for the period.
high_estimate	float	Estimated EPS high for the period.
mean	float	Estimated EPS mean for the period.
median	float	Estimated EPS median for the period.
standard_deviation	float	Estimated EPS standard deviation for the period.
number_of_analysts	int	Number of analysts providing estimates for the period.
normalized_actual	float	Actual normalized EPS.
period_growth	float	Estimated (or actual if reported) EPS growth for the period.
low_estimate_gaap	float	Estimated GAAP EPS low for the period.
high_estimate_gaap	float	Estimated GAAP EPS high for the period.
mean_gaap	float	Estimated GAAP EPS mean for the period.
gaap_actual	float	Actual GAAP EPS.