Calendar Earnings

---

Implementation details

Class names

Model name	Parameters class	Data class
CalendarEarnings	CalendarEarningsQueryParams	CalendarEarningsData

Import Statement

from openbb_core.provider.standard_models.calendar_earnings import (
CalendarEarningsData,
CalendarEarningsQueryParams,
)

---

Parameters

• standard
• fmp
• nasdaq
• seeking_alpha
• tmx

Name	Type	Description	Default	Optional
start_date	Union[date, str]	Start date of the data, in YYYY-MM-DD format.	None	True
end_date	Union[date, str]	End date of the data, in YYYY-MM-DD format.	None	True

Name	Type	Description	Default	Optional
start_date	Union[date, str]	Start date of the data, in YYYY-MM-DD format.	None	True
end_date	Union[date, str]	End date of the data, in YYYY-MM-DD format.	None	True

Name	Type	Description	Default	Optional
start_date	Union[date, str]	Start date of the data, in YYYY-MM-DD format.	None	True
end_date	Union[date, str]	End date of the data, in YYYY-MM-DD format.	None	True

Name	Type	Description	Default	Optional
start_date	Union[date, str]	Start date of the data, in YYYY-MM-DD format.	None	True
end_date	Union[date, str]	End date of the data, in YYYY-MM-DD format.	None	True
country	Literal['us', 'ca']	The country to get calendar data for.	us	True

Name	Type	Description	Default	Optional
start_date	Union[date, str]	Start date of the data, in YYYY-MM-DD format.	None	True
end_date	Union[date, str]	End date of the data, in YYYY-MM-DD format.	None	True

---

Data

• standard
• fmp
• nasdaq
• seeking_alpha
• tmx

Name	Type	Description
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.

Name	Type	Description
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.

Name	Type	Description
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.

Name	Type	Description
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.

Name	Type	Description
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.