calendar
Get the upcoming, or historical, economic calendar of global events.
Parameters
- standard
- fmp
- nasdaq
- tradingeconomics
start_date: Union[date, str]
Start date of the data, in YYYY-MM-DD format.
• Optional: True
end_date: Union[date, str]
End date of the data, in YYYY-MM-DD format.
• Optional: True
start_date: Union[date, str]
Start date of the data, in YYYY-MM-DD format.
• Optional: True
end_date: Union[date, str]
End date of the data, in YYYY-MM-DD format.
• Optional: True
start_date: Union[date, str]
Start date of the data, in YYYY-MM-DD format.
• Optional: True
end_date: Union[date, str]
End date of the data, in YYYY-MM-DD format.
• Optional: True
country: Union[str, list[str]]
Country of the event Multiple items allowed for provider(s): nasdaq.
• Optional: True
start_date: Union[date, str]
Start date of the data, in YYYY-MM-DD format.
• Optional: True
end_date: Union[date, str]
End date of the data, in YYYY-MM-DD format.
• Optional: True
country: Union[str, list[str]]
Country of the event. Multiple items allowed for provider(s): tradingeconomics.
Choices
afghanistanalbaniaalgeriaandorraangolaantigua_and_barbudaargentinaarmeniaarubaaustraliaaustriaazerbaijanbahamasbahrainbangladeshbarbadosbelarusbelgiumbelizebeninbermudabhutanboliviabosnia_and_herzegovinabotswanabrazilbruneibulgariaburkina_fasoburundicambodiacamerooncanadacape_verdecayman_islandscentral_african_republicchadchilechinacolombiacomoroscongocosta_ricacroatiacubacyprusczech_republicdenmarkdjiboutidominicadominican_republiceast_timorecuadoregyptel_salvadorequatorial_guineaeritreaestoniaethiopiaeuro_areafaroe_islandsfijifinlandfrancegabongambiageorgiagermanyghanagreecegrenadaguatemalaguineaguinea_bissauguyanahaitihondurashong_konghungaryicelandindiaindonesiairaniraqirelandisle_of_manisraelitalyivory_coastjamaicajapanjordankazakhstankenyakiribatikosovokuwaitkyrgyzstanlaoslatvialebanonlesotholiberialibyaliechtensteinlithuanialuxembourgmacaomadagascarmalawimalaysiamaldivesmalimaltamauritaniamauritiusmexicomoldovamonacomongoliamontenegromoroccomozambiquemyanmarnamibianepalnetherlandsnew_caledonianew_zealandnicaraguanigernigerianorth_koreanorth_macedonianorwayomanpakistanpalestinepanamapapua_new_guineaparaguayperuphilippinespolandportugalpuerto_ricoqatarrepublic_of_the_congoromaniarussiarwandasamoasao_tome_and_principesaudi_arabiasenegalserbiaseychellessierra_leonesingaporeslovakiasloveniasolomon_islandssomaliasouth_africasouth_koreasouth_sudanspainsri_lankasudansurinameswazilandswedenswitzerlandsyriataiwantajikistantanzaniathailandtogotongatrinidad_and_tobagotunisiaturkeyturkmenistanugandaukraineunited_arab_emiratesunited_kingdomunited_statesuruguayuzbekistanvanuatuvenezuelavietnamyemenzambiazimbabwe
• Optional: True
importance: Literal['low', 'medium', 'high']
Importance of the event.
• Optional: True
group: Literal['interest_rate', 'inflation', 'bonds', 'consumer', 'gdp', 'government', 'housing', 'labour', 'markets', 'money', 'prices', 'trade', 'business']
Grouping of events.
• Optional: True
calendar_id: Union[Union[None, int, str], list[Union[None, int, str]]]
Get events by TradingEconomics Calendar ID. Multiple items allowed for provider(s): tradingeconomics.
• Optional: True
Returns
results: list[EconomicCalendar]
Serializable results.
provider: Optional[Literal['fmp', 'nasdaq', 'tradingeconomics']]
Provider name.
warnings: Optional[list[Warning_]]
list of warnings.
chart: Optional[Chart]
Chart object.
extra: dict[str, Any]
Extra info.
Data
- standard
- fmp
- nasdaq
- tradingeconomics
date: Union[datetime, str]
The date of the data.
country: str
Country of event.
category: str
Category of event.
event: str
Event name.
importance: str
The importance level for the event.
source: str
Source of the data.
currency: str
Currency of the data.
unit: str
Unit of the data.
consensus: Union[float, str]
Average forecast among a representative group of economists.
previous: Union[float, str]
Value for the previous period after the revision (if revision is applicable).
revised: Union[float, str]
Revised previous value, if applicable.
actual: Union[float, str]
Latest released value.
date: Union[datetime, str]
The date of the data.
country: str
Country of event.
category: str
Category of event.
event: str
Event name.
importance: str
The importance level for the event.
source: str
Source of the data.
currency: str
Currency of the data.
unit: str
Unit of the data.
consensus: Union[float, str]
Average forecast among a representative group of economists.
previous: Union[float, str]
Value for the previous period after the revision (if revision is applicable).
revised: Union[float, str]
Revised previous value, if applicable.
actual: Union[float, str]
Latest released value.
change: float
Value change since previous.
change_percent: float
Percentage change since previous.
last_updated: datetime
Last updated timestamp.
created_at: datetime
Created at timestamp.
date: Union[datetime, str]
The date of the data.
country: str
Country of event.
category: str
Category of event.
event: str
Event name.
importance: str
The importance level for the event.
source: str
Source of the data.
currency: str
Currency of the data.
unit: str
Unit of the data.
consensus: Union[float, str]
Average forecast among a representative group of economists.
previous: Union[float, str]
Value for the previous period after the revision (if revision is applicable).
revised: Union[float, str]
Revised previous value, if applicable.
actual: Union[float, str]
Latest released value.
description: str
Event description.
date: Union[datetime, str]
The date of the data.
country: str
Country of event.
category: str
Category of event.
event: str
Event name.
importance: str
The importance level for the event.
source: str
Source of the data.
currency: str
Currency of the data.
unit: str
Unit of the data.
consensus: Union[float, str]
Average forecast among a representative group of economists.
previous: Union[float, str]
Value for the previous period after the revision (if revision is applicable).
revised: Union[float, str]
Revised previous value, if applicable.
actual: Union[float, str]
Latest released value.
forecast: Union[str, float]
TradingEconomics projections.
reference: str
Abbreviated period for which released data refers to.
reference_date: date
Date for the reference period.
calendar_id: int
TradingEconomics Calendar ID.
date_span: int
Date span of the event.
symbol: str
TradingEconomics Symbol.
ticker: str
TradingEconomics Ticker symbol.
te_url: str
TradingEconomics URL path.
source_url: str
Source URL.
last_updated: datetime
Last update of the data.