earnings

Get historical and upcoming company earnings releases. Includes earnings per share (EPS) and revenue data.

Examples

from openbb import obb
obb.equity.calendar.earnings(provider='fmp')
# Get earnings calendar for specific dates.
obb.equity.calendar.earnings(start_date='2024-02-01', end_date='2024-02-07', provider='fmp')

---

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

---

Returns

OBBject
    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

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.