earnings
Get historical and upcoming company earnings releases. Includes earnings per share (EPS) and revenue data.
Parameters
- standard
- fmp
- nasdaq
- seeking_alpha
- tmx
start_date
: Union[date, str]
Start date of the data, in YYYY-MM-DD format.
• Optional: True
end_date
: Union[date, str]
End date of the data, in YYYY-MM-DD format.
• Optional: True
start_date
: Union[date, str]
Start date of the data, in YYYY-MM-DD format.
• Optional: True
end_date
: Union[date, str]
End date of the data, in YYYY-MM-DD format.
• Optional: True
start_date
: Union[date, str]
Start date of the data, in YYYY-MM-DD format.
• Optional: True
end_date
: Union[date, str]
End date of the data, in YYYY-MM-DD format.
• Optional: True
start_date
: Union[date, str]
Start date of the data, in YYYY-MM-DD format.
• Optional: True
end_date
: Union[date, str]
End date of the data, in YYYY-MM-DD format.
• Optional: True
country
: Literal['us', 'ca']
The country to get calendar data for.
• Default: us
• Optional: True
start_date
: Union[date, str]
Start date of the data, in YYYY-MM-DD format.
• Optional: True
end_date
: Union[date, str]
End date of the data, in YYYY-MM-DD format.
• Optional: True
Returns
results
: list[CalendarEarnings]
Serializable results.
provider
: Optional[Literal['fmp', 'nasdaq', 'seeking_alpha', 'tmx']]
Provider name.
warnings
: Optional[list[Warning_]]
list of warnings.
chart
: Optional[Chart]
Chart object.
extra
: dict[str, Any]
Extra info.
Data
- standard
- fmp
- nasdaq
- seeking_alpha
- tmx
report_date
: date
The date of the earnings report.
symbol
: str
Symbol representing the entity requested in the data.
name
: str
Name of the entity.
eps_previous
: float
The earnings-per-share from the same previously reported period.
eps_consensus
: float
The analyst conesus earnings-per-share estimate.
report_date
: date
The date of the earnings report.
symbol
: str
Symbol representing the entity requested in the data.
name
: str
Name of the entity.
eps_previous
: float
The earnings-per-share from the same previously reported period.
eps_consensus
: float
The analyst conesus earnings-per-share estimate.
eps_actual
: float
The actual earnings per share announced.
revenue_actual
: float
The actual reported revenue.
revenue_consensus
: float
The revenue forecast consensus.
period_ending
: date
The fiscal period end date.
reporting_time
: str
The reporting time - e.g. after market close.
updated_date
: date
The date the data was updated last.
report_date
: date
The date of the earnings report.
symbol
: str
Symbol representing the entity requested in the data.
name
: str
Name of the entity.
eps_previous
: float
The earnings-per-share from the same previously reported period.
eps_consensus
: float
The analyst conesus earnings-per-share estimate.
eps_actual
: float
The actual earnings per share (USD) announced.
surprise_percent
: float
The earnings surprise as normalized percentage points.
num_estimates
: int
The number of analysts providing estimates for the consensus.
period_ending
: str
The fiscal period end date.
previous_report_date
: date
The previous report date for the same period last year.
reporting_time
: str
The reporting time - e.g. after market close.
market_cap
: int
The market cap (USD) of the reporting entity.
report_date
: date
The date of the earnings report.
symbol
: str
Symbol representing the entity requested in the data.
name
: str
Name of the entity.
eps_previous
: float
The earnings-per-share from the same previously reported period.
eps_consensus
: float
The analyst conesus earnings-per-share estimate.
market_cap
: float
Market cap of the entity.
reporting_time
: str
The reporting time - e.g. after market close.
exchange
: str
The primary trading exchange.
sector_id
: int
The Seeking Alpha Sector ID.
report_date
: date
The date of the earnings report.
symbol
: str
Symbol representing the entity requested in the data.
name
: str
The company's name.
eps_previous
: float
The earnings-per-share from the same previously reported period.
eps_consensus
: float
The consensus estimated EPS in dollars.
eps_actual
: float
The actual EPS in dollars.
eps_surprise
: float
The EPS surprise in dollars.
surprise_percent
: float
The EPS surprise as a normalized percent.
reporting_time
: str
The time of the report - i.e., before or after market.