historical_eps

Get historical earnings per share data for a given company.

Examples

from openbb import obb
obb.equity.fundamental.historical_eps(symbol='AAPL', provider='fmp')

---

Parameters

• standard
• alpha_vantage
• fmp

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

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

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

---

Returns

OBBject
    results : List[HistoricalEps]
        Serializable results.

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

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

    chart : Optional[Chart]
        Chart object.

    extra : Dict[str, Any]
        Extra info.

---

Data

• standard
• alpha_vantage
• fmp

Name	Type	Description
date	Union[date, str]	The date of the data.
symbol	str	Symbol representing the entity requested in the data.
announce_time	str	Timing of the earnings announcement.
eps_actual	float	Actual EPS from the earnings date.
eps_estimated	float	Estimated EPS for the earnings date.

Name	Type	Description
date	Union[date, str]	The date of the data.
symbol	str	Symbol representing the entity requested in the data.
announce_time	str	Timing of the earnings announcement.
eps_actual	float	Actual EPS from the earnings date.
eps_estimated	float	Estimated EPS for the earnings date.
surprise	float	Surprise in EPS (Actual - Estimated).
surprise_percent	Union[float, str]	EPS surprise as a normalized percent.
reported_date	date	Date of the earnings report.

Name	Type	Description
date	Union[date, str]	The date of the data.
symbol	str	Symbol representing the entity requested in the data.
announce_time	str	Timing of the earnings announcement.
eps_actual	float	Actual EPS from the earnings date.
eps_estimated	float	Estimated EPS for the earnings date.
revenue_estimated	float	Estimated consensus revenue for the reporting period.
revenue_actual	float	The actual reported revenue.
reporting_time	str	The reporting time - e.g. after market close.
updated_at	date	The date when the data was last updated.
period_ending	date	The fiscal period end date.