cpi
Get Consumer Price Index (CPI).
Returns either the rescaled index value, or a rate of change (inflation).
Examples
from openbb import obb
obb.economy.cpi(country='japan,china,turkey', provider='fred')
# Use the `transform` parameter to define the reference period for the change in values. Default is YoY.
obb.economy.cpi(country='united_states,united_kingdom', transform='period', provider='oecd')
Parameters
- standard
- fred
- oecd
country: str | list[str]
Default: united_states
The country to get data. Multiple items allowed for provider(s): fred, oecd.
transform: Literal['index', 'yoy', 'period']
Default: yoy
Transformation of the CPI data. Period represents the change since previous. Defaults to change from one year ago (yoy).
frequency: Literal['annual', 'quarter', 'monthly']
Default: monthly
The frequency of the data.
harmonized: bool
Default: False
If true, returns harmonized data.
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: Union[Literal['australia', 'austria', 'belgium', 'brazil', 'bulgaria', 'canada', 'chile', 'china', 'croatia', 'cyprus', 'czech_republic', 'denmark', 'estonia', 'finland', 'france', 'germany', 'greece', 'hungary', 'iceland', 'india', 'indonesia', 'ireland', 'israel', 'italy', 'japan', 'korea', 'latvia', 'lithuania', 'luxembourg', 'malta', 'mexico', 'netherlands', 'new_zealand', 'norway', 'poland', 'portugal', 'romania', 'russian_federation', 'slovak_republic', 'slovakia', 'slovenia', 'south_africa', 'spain', 'sweden', 'switzerland', 'turkey', 'united_kingdom', 'united_states'], str]
Default: united_states
The country to get data.
transform: Literal['index', 'yoy', 'period']
Default: yoy
Transformation of the CPI data. Period represents the change since previous. Defaults to change from one year ago (yoy).
frequency: Literal['annual', 'quarter', 'monthly']
Default: monthly
The frequency of the data.
harmonized: bool
Default: False
If true, returns harmonized data.
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
Default: united_states
Country to get CPI for. This is the list of OECD supported countries
transform: Literal['index', 'yoy', 'period']
Default: yoy
Transformation of the CPI data. Period represents the change since previous. Defaults to change from one year ago (yoy).
frequency: Literal['annual', 'quarter', 'monthly']
Default: monthly
The frequency of the data.
harmonized: bool
Default: False
If true, returns harmonized data.
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.
expenditure: Literal['total', 'all', 'actual_rentals', 'alcoholic_beverages_tobacco_narcotics', 'all_non_food_non_energy', 'clothing_footwear', 'communication', 'education', 'electricity_gas_other_fuels', 'energy', 'overall_excl_energy_food_alcohol_tobacco', 'food_non_alcoholic_beverages', 'fuels_lubricants_personal', 'furniture_household_equipment', 'goods', 'housing', 'housing_excluding_rentals', 'housing_water_electricity_gas', 'health', 'imputed_rentals', 'maintenance_repair_dwelling', 'miscellaneous_goods_services', 'recreation_culture', 'residuals', 'restaurants_hotels', 'services_less_housing', 'services_less_house_excl_rentals', 'services', 'transport', 'water_supply_other_services']
Default: total
Expenditure component of CPI.
Returns
results: list[ConsumerPriceIndex]
Serializable results.
provider: Optional[Literal['fred', 'oecd']]
Provider name.
warnings: Optional[list[Warning_]]
list of warnings.
chart: Optional[Chart]
Chart object.
extra: dict[str, Any]
Extra info.
Data
- standard
- fred
- oecd
date: date | str
The date of the data.
country: str
None
value: float
CPI index value or period change.
date: date | str
The date of the data.
country: str
None
value: float
CPI index value or period change.
date: date | str
The date of the data.
country: str
None
value: float
CPI index value or period change.
expenditure: str
Expenditure component of CPI.