# USDA NASS Agricultural Production & Stocks Lookup

> USDA NASS Agricultural Production & Stocks Lookup is a paid API for AI agents from api.agentstools.dev, paid per call via x402, $0.02/call, status unknown (last checked 2026-09-14).

Returns US crop production, yield, acreage, or grain stocks data from USDA NASS QuickStats for corn, soybeans, wheat, or cotton, with year-over-year change.

## Facts

- Endpoint: GET https://api.agentstools.dev/agri/production
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/usda-nass-agricultural-production-stocks-lookup-6b2cb861
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap__0Yo3EqBSknEhNEw2mVfl

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability usda-nass-agricultural-production-stocks-lookup-6b2cb861
```

Example prompt: Pull the USDA NASS soybean yield figures for Iowa in 2022, and show me how that compares to the prior year.

## When to prefer this

Use this endpoint when you need structured, cited US crop statistics (production, yield, acreage, or grain stocks) directly from USDA NASS QuickStats for corn, soybeans, wheat, or cotton, especially when you also need year-over-year change pre-computed. Prefer this over general web search when data accuracy, citation, and normalization matter.

## Known failure modes

- Unsupported commodity or metric enum value returns a validation error
- Year outside 2000–2100 range is rejected
- State code not recognized returns an error
- USDA NASS data not yet available for the requested year returns an empty or error response
- Network or upstream USDA API failure causes a 5xx error

## How this service works

US crop production, yield, acreage and grain stocks from USDA NASS QuickStats by commodity, with an optional state and year. Returns a normalized cited series plus the year-over-year change.

## Output

A normalized, cited data series from USDA NASS QuickStats containing the requested metric (production, yield, acreage, or stocks) for the specified commodity and optional state/year, along with the year-over-year percentage or absolute change.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "properties": {
      "year": {
       "type": "integer",
       "maximum": 2100,
       "minimum": 2000,
       "description": "Optional as-of year (default latest available)"
      },
      "state": {
       "type": "string",
       "description": "Optional 2-letter US state code (default national)"
      },
      "metric": {
       "enum": [
        "production",
        "yield",
        "acreage",
        "stocks"
       ],
       "type": "string",
       "description": "Which series to return (default production)"
      },
      "commodity": {
       "enum": [
        "corn",
        "soybeans",
        "wheat",
        "cotton"
       ],
       "type": "string",
       "description": "Commodity (default corn)"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/usda-nass-agricultural-production-stocks-lookup-6b2cb861/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.agentstools.dev](https://www.zero.xyz/host/api.agentstools.dev/llms.txt)