indicators
Get economic indicators by country and indicator.
Examples
from openbb import obb
obb.economy.indicators(provider='econdb', symbol=PCOCO)
# Enter the country as the full name, or iso code. Use `available_indicators()` to get a list of supported indicators from EconDB.
obb.economy.indicators(symbol=CPI, country='united_states,jp', provider='econdb')
# Use the `main` symbol to get the group of main indicators for a country.
obb.economy.indicators(provider='econdb', symbol=main, country='eu')
# When the provider is 'imf', the absence of a symbol will default to 'irfcl_top_lines'. Use 'IRFCL' to get all the data from the set of indicators.
obb.economy.indicators(provider='imf')
# When the provider is 'imf', complete tables are returned by using a 'preset'. Refer to the function's docstring for descriptions of each preset. When no country is supplied, the data is returned for all countries.
obb.economy.indicators(provider='imf', symbol=gold_reserves)
# When the provider is 'imf', multiple countries and symbols can be supplied. Enter countries as a two-letter ISO country code, or the country name in lower_snake_case.
obb.economy.indicators(provider='imf', symbol=RAFA_USD,RAPFA_USD,RAFA_RAPFA_RO, country='us,china,jp,4f,gb', start_date='2010-01-01', end_date='2020-12-31', frequency=annual)
# When the provider is 'imf', additional presets return the core Financial Soundness Indicators.
'fsi_core' - Core FSIs
'fsi_encouraged_set' - Encouraged Set of FSIs,
'fsi_core_underlying' - Underlying data for the Core FSIs.
'fsi_other' - Additional/Other FSIs that are not in the Core or Encouraged Set.
'fsi_all' - all FSI data for a single country.
obb.economy.indicators(provider='imf', symbol=fsi_encouraged_set, country='us,fr,gb', start_date='2022-01-01', end_date='2023-12-31', frequency=annual)
Parameters
- standard
- econdb
- imf
country: str | list[str]
The country to get data. The country represented by the indicator, if available. Multiple items allowed for provider(s): econdb, imf.
Choices
- all
- afghanistan
- albania
- algeria
- american_samoa
- angola
- anguilla
- antigua_and_barbuda
- argentina
- armenia
- aruba
- australia
- austria
- azerbaijan
- bahamas
- bahrain
- bangladesh
- barbados
- belarus
- belgium
- belize
- benin
- bermuda
- bhutan
- bolivia
- bosnia_and_herzegovina
- botswana
- brazil
- brunei_darussalam
- bulgaria
- burkina_faso
- burundi
- cabo_verde
- cambodia
- cameroon
- canada
- central_african_republic
- chad
- chile
- hong_kong
- macao
- china
- colombia
- comoros
- democratic_republic_of_the_congo
- congo
- costa_rica
- ivory_coast
- croatia
- cuba
- curacao
- cyprus
- czech_republic
- denmark
- djibouti
- dominica
- dominican_republic
- ecuador
- egypt
- el_salvador
- equatorial_guinea
- eritrea
- estonia
- eswatini
- ethiopia
- falkland_islands
- faroe_islands
- fiji
- finland
- france
- french_polynesia
- gabon
- gambia
- georgia
- germany
- ghana
- gibraltar
- greece
- greenland
- grenada
- guam
- guatemala
- guinea
- guyana
- haiti
- vatican_city_state
- honduras
- hungary
- iceland
- india
- indonesia
- iran
- iraq
- ireland
- israel
- italy
- jamaica
- japan
- jordan
- kazakhstan
- kenya
- kiribati
- north_korea
- south_korea
- kosovo
- kuwait
- kyrgyzstan
- lao
- latvia
- lebanon
- lesotho
- liberia
- libya
- lithuania
- luxembourg
- madagascar
- malawi
- malaysia
- maldives
- mali
- malta
- marshall_islands
- mauritania
- mauritius
- mexico
- micronesia
- moldova
- mongolia
- montenegro
- montserrat
- morocco
- mozambique
- myanmar
- namibia
- nauru
- nepal
- antilles
- netherlands
- new_caledonia
- new_zealand
- nicaragua
- niger
- nigeria
- north_macedonia
- norway
- oman
- pakistan
- palau
- panama
- papua_new_guinea
- paraguay
- peru
- philippines
- poland
- portugal
- qatar
- romania
- russia
- rwanda
- samoa
- san_marino
- sao_tome_and_principe
- saudi_arabia
- senegal
- serbia_and_montenegro
- serbia
- seychelles
- sierra_leone
- singapore
- sint_maarten
- slovakia
- slovenia
- solomon_islands
- somalia
- south_africa
- south_sudan
- spain
- sri_lanka
- saint_kitts_and_nevis
- saint_lucia
- saint_vincent_and_the_grenadines
- sudan
- suriname
- sweden
- switzerland
- syria
- taiwan
- tajikistan
- tanzania
- thailand
- timor-leste
- togo
- tonga
- trinidad_and_tobago
- tunisia
- turkey
- turkmenistan
- tuvalu
- uganda
- ukraine
- united_arab_emirates
- united_kingdom
- united_states
- uruguay
- uzbekistan
- vanuatu
- venezuela
- viet_nam
- palestine
- yemen
- zambia
- zimbabwe
- euro_area
- europe
- european_union
- unspecified
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: str | list[str]
The country to get data. The country represented by the indicator, if available. Multiple items allowed for provider(s): econdb, imf.
Choices
- all
- afghanistan
- albania
- algeria
- american_samoa
- angola
- anguilla
- antigua_and_barbuda
- argentina
- armenia
- aruba
- australia
- austria
- azerbaijan
- bahamas
- bahrain
- bangladesh
- barbados
- belarus
- belgium
- belize
- benin
- bermuda
- bhutan
- bolivia
- bosnia_and_herzegovina
- botswana
- brazil
- brunei_darussalam
- bulgaria
- burkina_faso
- burundi
- cabo_verde
- cambodia
- cameroon
- canada
- central_african_republic
- chad
- chile
- hong_kong
- macao
- china
- colombia
- comoros
- democratic_republic_of_the_congo
- congo
- costa_rica
- ivory_coast
- croatia
- cuba
- curacao
- cyprus
- czech_republic
- denmark
- djibouti
- dominica
- dominican_republic
- ecuador
- egypt
- el_salvador
- equatorial_guinea
- eritrea
- estonia
- eswatini
- ethiopia
- falkland_islands
- faroe_islands
- fiji
- finland
- france
- french_polynesia
- gabon
- gambia
- georgia
- germany
- ghana
- gibraltar
- greece
- greenland
- grenada
- guam
- guatemala
- guinea
- guyana
- haiti
- vatican_city_state
- honduras
- hungary
- iceland
- india
- indonesia
- iran
- iraq
- ireland
- israel
- italy
- jamaica
- japan
- jordan
- kazakhstan
- kenya
- kiribati
- north_korea
- south_korea
- kosovo
- kuwait
- kyrgyzstan
- lao
- latvia
- lebanon
- lesotho
- liberia
- libya
- lithuania
- luxembourg
- madagascar
- malawi
- malaysia
- maldives
- mali
- malta
- marshall_islands
- mauritania
- mauritius
- mexico
- micronesia
- moldova
- mongolia
- montenegro
- montserrat
- morocco
- mozambique
- myanmar
- namibia
- nauru
- nepal
- antilles
- netherlands
- new_caledonia
- new_zealand
- nicaragua
- niger
- nigeria
- north_macedonia
- norway
- oman
- pakistan
- palau
- panama
- papua_new_guinea
- paraguay
- peru
- philippines
- poland
- portugal
- qatar
- romania
- russia
- rwanda
- samoa
- san_marino
- sao_tome_and_principe
- saudi_arabia
- senegal
- serbia_and_montenegro
- serbia
- seychelles
- sierra_leone
- singapore
- sint_maarten
- slovakia
- slovenia
- solomon_islands
- somalia
- south_africa
- south_sudan
- spain
- sri_lanka
- saint_kitts_and_nevis
- saint_lucia
- saint_vincent_and_the_grenadines
- sudan
- suriname
- sweden
- switzerland
- syria
- taiwan
- tajikistan
- tanzania
- thailand
- timor-leste
- togo
- tonga
- trinidad_and_tobago
- tunisia
- turkey
- turkmenistan
- tuvalu
- uganda
- ukraine
- united_arab_emirates
- united_kingdom
- united_states
- uruguay
- uzbekistan
- vanuatu
- venezuela
- viet_nam
- palestine
- yemen
- zambia
- zimbabwe
- euro_area
- europe
- european_union
- unspecified
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.
symbol: str | list[str]
Symbol to get data for. The base symbol for the indicator (e.g. GDP, CPI, etc.). Use available_indicators() to get a list of available symbols. Multiple items allowed for provider(s): econdb.
transform: Literal['toya', 'tpop', 'tusd', 'tpgp']
Description
The transformation to apply to the data, default is None.
tpop: Change from previous period
toya: Change from one year ago
tusd: Values as US dollars
tpgp: Values as a percent of GDP
Only 'tpop' and 'toya' are applicable to all indicators. Applying transformations across multiple indicators/countries may produce unexpected results.
This is because not all indicators are compatible with all transformations, and the original units and scale differ between entities.
tusd should only be used where values are currencies.
frequency: Literal['annual', 'quarter', 'month']
Default: quarter
The frequency of the data, default is 'quarter'. Only valid when 'symbol' is 'main'.
use_cache: bool
Default: True
If True, the request will be cached for one day. Using cache is recommended to avoid needlessly requesting the same data.
country: str | list[str]
The country to get data. The country represented by the indicator, if available. Multiple items allowed for provider(s): econdb, imf.
Choices
- all
- afghanistan
- albania
- algeria
- american_samoa
- angola
- anguilla
- antigua_and_barbuda
- argentina
- armenia
- aruba
- australia
- austria
- azerbaijan
- bahamas
- bahrain
- bangladesh
- barbados
- belarus
- belgium
- belize
- benin
- bermuda
- bhutan
- bolivia
- bosnia_and_herzegovina
- botswana
- brazil
- brunei_darussalam
- bulgaria
- burkina_faso
- burundi
- cabo_verde
- cambodia
- cameroon
- canada
- central_african_republic
- chad
- chile
- hong_kong
- macao
- china
- colombia
- comoros
- democratic_republic_of_the_congo
- congo
- costa_rica
- ivory_coast
- croatia
- cuba
- curacao
- cyprus
- czech_republic
- denmark
- djibouti
- dominica
- dominican_republic
- ecuador
- egypt
- el_salvador
- equatorial_guinea
- eritrea
- estonia
- eswatini
- ethiopia
- falkland_islands
- faroe_islands
- fiji
- finland
- france
- french_polynesia
- gabon
- gambia
- georgia
- germany
- ghana
- gibraltar
- greece
- greenland
- grenada
- guam
- guatemala
- guinea
- guyana
- haiti
- vatican_city_state
- honduras
- hungary
- iceland
- india
- indonesia
- iran
- iraq
- ireland
- israel
- italy
- jamaica
- japan
- jordan
- kazakhstan
- kenya
- kiribati
- north_korea
- south_korea
- kosovo
- kuwait
- kyrgyzstan
- lao
- latvia
- lebanon
- lesotho
- liberia
- libya
- lithuania
- luxembourg
- madagascar
- malawi
- malaysia
- maldives
- mali
- malta
- marshall_islands
- mauritania
- mauritius
- mexico
- micronesia
- moldova
- mongolia
- montenegro
- montserrat
- morocco
- mozambique
- myanmar
- namibia
- nauru
- nepal
- antilles
- netherlands
- new_caledonia
- new_zealand
- nicaragua
- niger
- nigeria
- north_macedonia
- norway
- oman
- pakistan
- palau
- panama
- papua_new_guinea
- paraguay
- peru
- philippines
- poland
- portugal
- qatar
- romania
- russia
- rwanda
- samoa
- san_marino
- sao_tome_and_principe
- saudi_arabia
- senegal
- serbia_and_montenegro
- serbia
- seychelles
- sierra_leone
- singapore
- sint_maarten
- slovakia
- slovenia
- solomon_islands
- somalia
- south_africa
- south_sudan
- spain
- sri_lanka
- saint_kitts_and_nevis
- saint_lucia
- saint_vincent_and_the_grenadines
- sudan
- suriname
- sweden
- switzerland
- syria
- taiwan
- tajikistan
- tanzania
- thailand
- timor-leste
- togo
- tonga
- trinidad_and_tobago
- tunisia
- turkey
- turkmenistan
- tuvalu
- uganda
- ukraine
- united_arab_emirates
- united_kingdom
- united_states
- uruguay
- uzbekistan
- vanuatu
- venezuela
- viet_nam
- palestine
- yemen
- zambia
- zimbabwe
- euro_area
- europe
- european_union
- unspecified
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.
symbol: str | list[str]
Default: irfcl_top_lines
Description
Symbol to get data for. Use available_indicators() to get the list of available symbols. Use 'IRFCL' to get all the data from International Reserves & Foreign Currency Liquidity indicators. Use 'core_fsi' to get the core Financial Soundness Indicators. Use 'core_fsi_underlying' to include underlying data for the core Financial Soundness Indicators. Complete tables are available only by single country, and are keyed as described below. The default is 'irfcl_top_lines'. Available presets not listed in available_indicators() are:
'IRFCL': All the data from the set of indicators. Not compatible with multiple countries.
'irfcl_top_lines': The default, top line items from the IRFCL data. Compatible with multiple countries.
'reserve_assets_and_other_fx_assets': Table I of the IRFCL data. Not compatible with multiple countries.
'predetermined_drains_on_fx_assets': Table II of the IRFCL data. Not compatible with multiple countries.
'contingent_drains_fx_assets': Table III of the IRFCL data. Not compatible with multiple countries.
'memorandum_items': The memorandum items table of the IRFCL data. Not compatible with multiple countries.
'gold_reserves': Gold reserves as value in USD and Fine Troy Ounces. Compatible with multiple countries.
'derivative_assets': Net derivative assets as value in USD. Compatible with multipile countries.
'fsi_core': The core Financial Soundness Indicators. Compatible with multiple countries.
'fsi_core_underlying': The core FSIs underlying series data. Not compatible with country='all'.
'fsi_encouraged_set': The encouraged set of Financial Soundness Indicators. Not compatible with country='all'.
'fsi_other': The other Financial Soundness Indicators. Not compatible with country='all'.
'fsi_balance_sheets': Data categorized as Balance Sheets and Income Statements. Not compatible with country='all'.
'fsi_all': All the Financial Soundness Indicators. Not compatible with multiple countries. Multiple items allowed for provider(s): imf.
frequency: Literal['annual', 'quarter', 'month']
Default: quarter
Frequency of the data, default is 'quarter'.
Returns
results: list[EconomicIndicators]
Serializable results.
provider: Optional[Literal['econdb', 'imf']]
Provider name.
warnings: Optional[list[Warning_]]
list of warnings.
chart: Optional[Chart]
Chart object.
extra: dict[str, Any]
Extra info.
Data
- standard
- econdb
- imf
date: date | str
The date of the data.
symbol_root: str
The root symbol for the indicator (e.g. GDP).
symbol: str
Symbol representing the entity requested in the data.
country: str
The country represented by the data.
value: Union[float, int]
date: date | str
The date of the data.
symbol_root: str
The root symbol for the indicator (e.g. GDP).
symbol: str
Symbol representing the entity requested in the data.
country: str
The country represented by the data.
value: Union[float, int]
date: date | str
The date of the data.
symbol_root: str
The root symbol for the indicator (e.g. GDP).
symbol: str
Symbol representing the entity requested in the data.
country: str
The country represented by the data.
value: Union[float, int]
unit: str
The unit of the value.
scale: str
The scale of the value.
table: str
The name of the table associated with the symbol.
level: int
The indentation level of the data, relative to the table and symbol_root
order: Union[float, int]
Order of the data, relative to the table.
reference_sector: str
The reference sector for the data.
title: str
The title of the series associated with the symbol.