Skip to main content

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

NameTypeDescriptionDefaultOptional
start_dateUnion[date, str]Start date of the data, in YYYY-MM-DD format.NoneTrue
end_dateUnion[date, str]End date of the data, in YYYY-MM-DD format.NoneTrue

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

NameTypeDescription
report_datedateThe date of the earnings report.
symbolstrSymbol representing the entity requested in the data.
namestrName of the entity.
eps_previousfloatThe earnings-per-share from the same previously reported period.
eps_consensusfloatThe analyst conesus earnings-per-share estimate.