historical_eps
Get historical earnings per share data for a given company.
Parameters
- standard
- alpha_vantage
- fmp
symbol: Union[str, list[str]]
Symbol to get data for. Multiple items allowed for provider(s): alpha_vantage.
• Optional: False
symbol: Union[str, list[str]]
Symbol to get data for. Multiple items allowed for provider(s): alpha_vantage.
• Optional: False
period: Literal['annual', 'quarter']
Time period of the data to return.
• Default: quarter
• Optional: True
limit: int
The number of data entries to return.
• Optional: True
symbol: Union[str, list[str]]
Symbol to get data for. Multiple items allowed for provider(s): alpha_vantage.
• Optional: False
limit: int
The number of data entries to return.
• Optional: True
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
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.
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.
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.