usda_psd_get_latest_release
List the countries and market years a commodity's newest PSD release revised, and poll for changes since a stored release month to see whether updates exist.
Instructions
Which countries and market years PSD's newest release of a commodity revised.
One request to PSDData_GetDataReleaseInfo, which lists the last release of every
country and market year (7,754 records for wheat); the records of the newest
release_year and release_month are kept, unchanged and in upstream's order.
For wheat as recorded on 2026-10-23 that was release 2026-10, 146 records: 123
countries for market year 2026 and a few revisions of earlier years.
meta.vintage names the release ("2026-10") in the form meta.vintage of
get_data takes, so a stored vintage older than it means the listed countries and
market years have changed since. To poll, pass your stored vintage as since: the
answer is the newest release's records when that release is later than since,
and an empty list when it is not, with meta.vintage still naming the newest
release, so an empty list says nothing newer exists. A commodity without any release
gives an empty list and meta.vintage None; meta.published_at stays empty,
since PSD gives no day. A release that adds a market year and revises earlier ones
lists many records: the wheat list recorded on 2026-10-23 had 146 records of 2026-10
and 130 more still carrying 2026-09, so the September answer held between 130 and 276
rows. get_release_dates(commodity_code, market_year=..., country_code=..., since=...) returns any part of the list.
Args:
commodity_code: PSD commodity code, seven digits, e.g. "0410000" (Wheat),
"0440000" (Corn), "2222000" (Oilseed, Soybean).
since: A release month "YYYY-MM", e.g. "2026-09", typically the
meta.vintage you stored last time: the newest release's records come back
only when that release is later (strictly after), else an empty list.
None always returns the newest release's records.
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>"
},
"name": "usda_psd_get_latest_release"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| since | No | ||
| commodity_code | Yes |