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. |