historical_eps
Get historical earnings per share data for a given company.
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'] | None
Default: quarter
Time period of the data to return.
limit: int | None
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 | None
The number of data entries to return. Default is all.
Returns
results: 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: int | float | None
Actual EPS from the earnings date.
eps_estimated: int | float | None
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: int | float | None
Actual EPS from the earnings date.
eps_estimated: int | float | None
Estimated EPS for the earnings date.
surprise: float | None
Surprise in EPS (Actual - Estimated).
surprise_percent: float | str | None
EPS surprise as a normalized percent.
reported_date: date | None
Date of the earnings report.
report_time: str | None
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: int | float | None
Actual EPS from the earnings date.
eps_estimated: int | float | None
Estimated EPS for the earnings date.
revenue_estimated: int | float | None
Estimated consensus revenue for the reporting period.
revenue_actual: int | float | None
The actual reported revenue.
updated: date | None
The date when the data was last updated.