Cash Grain Bids and Basis
cash.bidsA country elevator's cash bid for physical grain, from USDA AMS daily cash grain bid reports, searched across every state report at once — which AMS itself cannot do, because MARS is report-centric with no commodity-wide search. Returns basis in CENTS per bushel against a named futures month, price in DOLLARS per bushel, location, grade, elevator class, freight and delivery. THIS IS NOT a futures settlement and NOT the NASS season-average price received that price.latest returns for ZC/ZW/ZS; all three are correct and all three differ. Values are ranges where the report published a range. Latest published print only — there is no stored history, so this cannot tell you whether basis is strengthening; read each row's basis_change, which is the agency's own answer. Wheat must name its class: CBOT soft red winter, KCBT hard red winter and MGE hard red spring traded 35 cents apart on the same page. Paid.
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": "<commodity>"
},
"name": "cash.bids"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Maximum rows. | |
| month | No | Futures month code ("Z") or contract ("2026-12") the basis is quoted against. | |
| state | No | Two-letter state code, e.g. IA. | |
| commodity | Yes | Which grain. Required. | |
| include_stale | No | Include reports that have not published recently. Excluded and named by default. | |
| elevator_class | No | Narrow to one kind of buyer. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| bids | Yes | Cash bid rows, widest basis first | |
| notes | Yes | ||
| commodity | Yes | ||
| instrument | No | Catalog instrument where one quotes this class; null is a real answer | |
| reports_searched | Yes | ||
| stale_reports_excluded | No |