retail_prices
Get retail prices for common items.
Examples
from openbb import obb
obb.economy.retail_prices(provider='fred')
# The price of eggs in the northeast census region.
obb.economy.retail_prices(item='eggs', region=northeast, provider='fred')
# The percentage change in price, from one-year ago, of various meats, US City Average.
obb.economy.retail_prices(item='meats', transform=pc1, provider='fred')
Parameters
- standard
- fred
item: str
The item or basket of items to query.
• Optional: True
country: str
The country to get data.
• Default: united_states
• 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
item: Literal['beverages', 'cereals', 'dairy', 'fuel', 'produce', 'meats', 'bacon', 'bananas', 'beans', 'beef', 'beer', 'bread', 'butter', 'cheese', 'chicken', 'chops', 'coffee', 'cookies', 'corn', 'diesel', 'eggs', 'electricity', 'flour', 'gas', 'gasoline', 'grapefruit', 'ground_beef', 'ham', 'ice_cream', 'lemons', 'lettuce', 'malt_beverages', 'milk', 'oil', 'orange_juice', 'oranges', 'pork', 'potato_chips', 'potatoes', 'rice', 'soft_drinks', 'spaghetti', 'steak', 'strawberries', 'sugar', 'tomatoes', 'unleaded', 'usda', 'vodka', 'wine', 'yogurt']
The item or basket of items to query.
• Default: fuel
• Optional: True
country: Literal['united_states']
The country to get data.
• Default: united_states
• 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
region: Literal['all_city', 'northeast', 'midwest', 'south', 'west']
The region to get average price levels for.
• Default: all_city
• Optional: True
frequency: Literal['annual', 'quarter', 'monthly']
The frequency of the data.
• Default: monthly
• Optional: True
transform: Literal['chg', 'ch1', 'pch', 'pc1', 'pca', 'cch', 'cca', 'log']
Description
Transformation type
None = No transformation
chg = Change
ch1 = Change from Year Ago
pch = Percent Change
pc1 = Percent Change from Year Ago
pca = Compounded Annual Rate of Change
cch = Continuously Compounded Rate of Change
cca = Continuously Compounded Annual Rate of Change
log = Natural Log
• Optional: True
Returns
results: list[RetailPrices]
Serializable results.
provider: Optional[Literal['fred']]
Provider name.
warnings: Optional[list[Warning_]]
list of warnings.
chart: Optional[Chart]
Chart object.
extra: dict[str, Any]
Extra info.
Data
- standard
- fred
date: Union[date, str]
The date of the data.
symbol: str
Symbol representing the entity requested in the data.
country: str
description: str
Description of the item.
value: float
Price, or change in price, per unit.
date: Union[date, str]
The date of the data.
symbol: str
Symbol representing the entity requested in the data.
country: str
description: str
Description of the item.
value: float
Price, or change in price, per unit.