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
start_date: date | str
Start date of the data, in YYYY-MM-DD format.
end_date: date | str
End date of the data, in YYYY-MM-DD format.
start_date: date | str
Start date of the data, in YYYY-MM-DD format.
end_date: date | str
End date of the data, in YYYY-MM-DD format.
start_date: date | str
Start date of the data, in YYYY-MM-DD format.
end_date: date | str
End date of the data, in YYYY-MM-DD format.
start_date: date | str
Start date of the data, in YYYY-MM-DD format.
end_date: date | str
End date of the data, in YYYY-MM-DD format.
country: Literal['us', 'ca']
Default: us
The country to get calendar data for.
start_date: date | str
Start date of the data, in YYYY-MM-DD format.
end_date: date | str
End date of the data, in YYYY-MM-DD format.
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_consensus: float
The revenue forecast consensus.
revenue_actual: float
The actual reported revenue.
last_updated: 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.