usda_psd_get_data
Retrieve USDA PSD supply and distribution forecasts for a commodity and market year, optionally filtered by country, to compare production, trade, consumption, and stocks.
Instructions
PSD supply and distribution forecasts for one commodity and market year, by country.
One record per country and attribute (area, production, imports, exports,
consumption, stocks, ...): attribute_id and unit_id are PSD's integer ids,
which enums.AttributeId and enums.UnitId name; value is in that unit.
Codes and the year are checked against the packaged lists before any call; an
unknown code raises InvalidRequestError naming the closest ones. Each record's
calendar_year and month are the PSD release that last revised it: for one
country all records share one release, for every country they differ by country.
meta.vintage is the latest of them as upstream names it ("2026-07");
meta.published_at stays empty, since PSD gives no day. An empty list means PSD
has no records for that combination; a market year without data raises
NotFoundError. Every country is up to about 1,900 rows (1,875 for corn in 2023).
Args:
commodity_code: PSD commodity code, seven digits, e.g. "0410000" (Wheat),
"0440000" (Corn), "2222000" (Oilseed, Soybean).
market_year: PSD market year, e.g. 2023; data goes back to 1960 for most
commodities.
country_code: PSD country code (not ISO), e.g. "US" (United States), "BR"
(Brazil), "E4" (European Union). Omit it (None) for every country:
one record per country and attribute. For the world total use
get_world_data.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"commodity_code": "<commodity_code>",
"market_year": "<market_year>"
},
"name": "usda_psd_get_data"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| market_year | Yes | ||
| country_code | No | ||
| commodity_code | Yes |