season_average_price_forecasts

Get ERS season-average price forecasts - weekly ERS model and monthly WASDE marketing-year average price forecasts, with farm-bill PLC and ARC benchmarks, for corn, soybeans, wheat, and cotton.

Examples

from openbb import obb
obb.usda.season_average_price_forecasts(provider='usda')
# Get only the latest weekly forecast vintage for soybeans.
obb.usda.season_average_price_forecasts(commodity='Soybeans', latest=True, provider='usda')
# Get wheat season-average price forecasts since 2015.
obb.usda.season_average_price_forecasts(commodity='Wheat', start_year=2015, provider='usda')

Parameters

• standard
• usda

commodity: str | None
Default: Corn

Description

Commodity to retrieve. Valid commodities are:
Corn, Cotton, Soybeans, Wheat

start_year: int | None
Start year for filtering the data, compared against the marketing year. If None, returns from the beginning of the series.

end_year: int | None
End year for filtering the data, compared against the marketing year. If None, returns up to the most recent year.

latest: bool | None
Default: False
Return only the most recent weekly model forecast vintage. If False, every historical vintage is returned.

---

Returns

results: SeasonAveragePriceForecasts

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

model_forecast_date: str
Weekly forecast vintage date the model was run, as published (YYYY-MM-DD).

marketing_year: str
Marketing year of the forecast, as published.

commodity: str
Commodity name, as published.

futures_model_type: str
Futures model type: 'Single contract' or 'Three contract aggregate'. Wheat publishes both on the same date.

futures_exchange: str
Futures exchange the model prices reference, as published.

mya_price_model_forecast: float | None
ERS model forecast of the marketing-year average price.

mya_price_wasde_forecast: float | None
WASDE forecast of the marketing-year average price.

wasde_forecast_date: str | None
Date of the WASDE forecast, as published.

target_price: float | None
Farm-bill target price for the marketing year.

national_loan_rate: float | None
Farm-bill national loan rate for the marketing year.

direct_payment_rate: float | None
Farm-bill direct payment rate for the marketing year.

reference_price: float | None
Farm-bill statutory reference price for the marketing year.

ccp_effective_price_model_forecast: float | None
Counter-cyclical payment effective price, model forecast.

ccp_rate_model_forecast: float | None
Counter-cyclical payment rate, model forecast.

ccp_effective_price_wasde_forecast: float | None
Counter-cyclical payment effective price, WASDE forecast.

ccp_rate_wasde_forecast: float | None
Counter-cyclical payment rate, WASDE forecast.

historical_mya_price_year1: float | None
Marketing-year average price of the first historical year in the five-year benchmark window.

historical_mya_price_year2: float | None
Marketing-year average price of the second historical year in the five-year benchmark window.

historical_mya_price_year3: float | None
Marketing-year average price of the third historical year in the five-year benchmark window.

historical_mya_price_year4: float | None
Marketing-year average price of the fourth historical year in the five-year benchmark window.

historical_mya_price_year5: float | None
Marketing-year average price of the fifth historical year in the five-year benchmark window.

historical_mya_5year_range: str | None
Range of years spanned by the five-year benchmark window, as published, e.g. '2019-2023'.

historical_mya_price_5year_olympic_average: float | None
Olympic average of the five historical marketing-year average prices.

effective_reference_price: float | None
Farm-bill effective reference price for the marketing year.

effective_price_model_forecast: float | None
Price Loss Coverage effective price, model forecast.

plc_payment_rate_model_forecast: float | None
Price Loss Coverage payment rate, model forecast.

effective_price_wasde_forecast: float | None
Price Loss Coverage effective price, WASDE forecast.

plc_payment_rate_wasde_forecast: float | None
Price Loss Coverage payment rate, WASDE forecast.

maximum_plc_payment_rate: float | None
Maximum Price Loss Coverage payment rate for the year.

arc_annual_benchmark_price_year1: float | None
Agriculture Risk Coverage annual benchmark price of the first historical year in the window.

arc_annual_benchmark_price_year2: float | None
Agriculture Risk Coverage annual benchmark price of the second historical year in the window.

arc_annual_benchmark_price_year3: float | None
Agriculture Risk Coverage annual benchmark price of the third historical year in the window.

arc_annual_benchmark_price_year4: float | None
Agriculture Risk Coverage annual benchmark price of the fourth historical year in the window.

arc_annual_benchmark_price_year5: float | None
Agriculture Risk Coverage annual benchmark price of the fifth historical year in the window.

arc_annual_benchmark_price_5year_range: str | None
Range of years spanned by the ARC five-year benchmark window, as published, e.g. '2008-2012'.

arc_co_benchmark_price: float | None
Agriculture Risk Coverage county-option benchmark price.

arc_co_price_model_forecast: float | None
Agriculture Risk Coverage county-option price, model forecast.

arc_co_price_wasde_forecast: float | None
Agriculture Risk Coverage county-option price, WASDE forecast.

arc_ic_price_model_forecast: float | None
Agriculture Risk Coverage individual-coverage price, model forecast.

arc_ic_price_wasde_forecast: float | None
Agriculture Risk Coverage individual-coverage price, WASDE forecast.

actual_mya_price: float | None
Actual realized marketing-year average price, once known.

price_unit: str
Unit of the price columns, as published, e.g. 'U.S. dollars per bushel' or 'U.S. dollars per pound'.