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
• 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
provider	Literal['fmp', 'nasdaq', 'tmx']	The provider to use for the query, by default None. If None, the provider specified in defaults is selected or 'fmp' if there is no default.	fmp	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
provider	Literal['fmp', 'nasdaq', 'tmx']	The provider to use for the query, by default None. If None, the provider specified in defaults is selected or 'fmp' if there is no default.	fmp	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
provider	Literal['fmp', 'nasdaq', 'tmx']	The provider to use for the query, by default None. If None, the provider specified in defaults is selected or 'fmp' if there is no default.	fmp	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
provider	Literal['fmp', 'nasdaq', 'tmx']	The provider to use for the query, by default None. If None, the provider specified in defaults is selected or 'fmp' if there is no default.	fmp	True

---

Data

• standard
• fmp
• nasdaq
• 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	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.