purchase_to_plate

Get ERS Purchase to Plate national average prices - estimated price per 100 edible grams for NHANES foods, pivoted to a price column per biennial survey cycle.

Examples

from openbb import obb
obb.usda.purchase_to_plate(provider='usda')
# Get national average prices for grain products.
obb.usda.purchase_to_plate(food_group='grains', provider='usda')

Parameters

• standard
• usda

food_group: str | None
Default: milk

Description

Food group to retrieve, derived from the FNDDS food-code leading digit. Valid food groups are:
milk, meat, eggs, legumes, grains, fruits, vegetables, fats, sugars

---

Returns

results: PurchaseToPlate

Serializable results.

provider: str | None

Provider name.

warnings: Optional[list[Warning_]]

List of warnings.

chart: Optional[Chart]

Chart object.

extra: dict[str, Any]

Extra info.

---

Data

• standard
• usda

food_code: str
Eight-digit FNDDS food code identifying the food item.

mod_code: str | None
Recipe modification code, '0' for an unmodified item. Non-zero only on the 2011/2012 recipe-modification rows.

food_description: str
Food description, as published in the most recent survey cycle the item appears in.

method_description: str | None
Price-estimation method, as published in the most recent survey cycle the item appears in.

nhanes: str | None
NHANES reporting flag, as published in the most recent survey cycle the item appears in.

cycle_2011_2012: float | None
National average price for the 2011/2012 survey cycle, in nominal U.S. dollars per 100 edible grams.

cycle_2013_2014: float | None
National average price for the 2013/2014 survey cycle, in nominal U.S. dollars per 100 edible grams.

cycle_2015_2016: float | None
National average price for the 2015/2016 survey cycle, in nominal U.S. dollars per 100 edible grams.

cycle_2017_2018: float | None
National average price for the 2017/2018 survey cycle, in nominal U.S. dollars per 100 edible grams.