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
symbol: str | list[str]
Symbol to get data for. Multiple items allowed for provider(s): alpha_vantage, fmp.
symbol: str | list[str]
Symbol to get data for. Multiple items allowed for provider(s): alpha_vantage, fmp.
period: Literal['annual', 'quarter']
Default: quarter
Time period of the data to return.
limit: int
The number of data entries to return.
symbol: str | list[str]
Symbol to get data for. Multiple items allowed for provider(s): alpha_vantage, fmp.
limit: int
The number of data entries to return. Default is all.
Returns
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
symbol: str
Symbol representing the entity requested in the data.
date: date | str
The date of the data.
eps_actual: Union[float, int]
Actual EPS from the earnings date.
eps_estimated: Union[float, int]
Estimated EPS for the earnings date.
symbol: str
Symbol representing the entity requested in the data.
date: date | str
The date of the data.
eps_actual: Union[float, int]
Actual EPS from the earnings date.
eps_estimated: Union[float, int]
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.
report_time: str
Time of day when the earnings report was released, e.g., 'post-market'.
symbol: str
Symbol representing the entity requested in the data.
date: date | str
The date of the data.
eps_actual: Union[float, int]
Actual EPS from the earnings date.
eps_estimated: Union[float, int]
Estimated EPS for the earnings date.
revenue_estimated: Union[float, int]
Estimated consensus revenue for the reporting period.
revenue_actual: Union[float, int]
The actual reported revenue.
updated: date
The date when the data was last updated.