usda_psd_get_world_data
Retrieve world-total USDA PSD supply and distribution forecasts for one commodity and market year, returning per-attribute values with units and PSD release vintage.
Instructions
PSD supply and distribution forecasts for one commodity and market year, world total.
One record per attribute, aggregated by PSD over every applicable country
(country_code "00"). attribute_id and unit_id are PSD's integer ids,
which enums.AttributeId and enums.UnitId name; value is in that unit.
meta.vintage is the PSD release that last revised the figures, as upstream names
it ("2026-10"), the latest release of any country for this commodity and market
year (in the whole answers recorded on 2026-10-23, commit 07b88ad);
meta.published_at stays empty, since PSD gives no day. The code and the
year are checked before any call; a market year without data raises
NotFoundError.
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.
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_world_data"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| market_year | Yes | ||
| commodity_code | Yes |