# USDA WASDE Crop Supply & Demand Reports

> USDA WASDE Crop Supply & Demand Reports is a paid API for AI agents from api.tradeenergy-api.workers.dev, paid per call via x402, $0.002/call, status unknown (last checked 2026-10-29).

Fetches USDA WASDE monthly report figures for a specific commodity and region, returning supply/demand attributes like Production and Ending Stocks with values and units.

## Facts

- Endpoint: GET https://api.tradeenergy-api.workers.dev/api/energy/usda-wasde-crop-reports?utm_source=zero.xyz
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-29
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/usda-wasde-crop-supply-demand-reports-12e2e5d5
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_ek7nKwQFx5Wi7uY-AaZuJ

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-wasde-crop-supply-demand-reports-12e2e5d5
```

Example prompt: Pull the latest USDA WASDE report figures for Wheat in the United States — I need to see all the supply and demand attributes like production, domestic use, and ending stocks.

## When to prefer this

Choose this endpoint when you need official USDA WASDE monthly crop supply and demand statistics for a specific commodity (Corn, Wheat, Soybeans, Cotton) and region, especially when you need structured attribute-level data (Production, Ending Stocks, Domestic Use) rather than raw CSV files. Prefer this over scraping the USDA website directly since it parses the official CSV and returns clean JSON. It's best suited for one commodity/region lookup per call rather than bulk data ingestion.

## Known failure modes

- Report not yet published for the requested month — falls back to the previous month
- Invalid commodity or region name that doesn't match CSV column values returns empty or unexpected rows
- Network latency from downloading ~1 MB CSV on each call may cause occasional timeouts
- Requesting a very old month for which no CSV exists may return an error or empty result
- Malformed YYYY-MM date format in the month parameter causes a bad request error

## How this service works

USDA WASDE (World Agricultural Supply and Demand Estimates) figures for one commodity and region from the official monthly report-data CSV: attribute (e.g. Production, Ending Stocks), market year, value and unit. Defaults to the latest month available; the CSV is about 1 MB, so each call downloads one month.

## Output

Returns a JSON object with an array of rows, each containing an attribute name (e.g. Production, Ending Stocks, Domestic Use), market year, numeric value, unit (e.g. Million Bushels), report date, and estimate flag. Also includes the queried month, region, commodity, source CSV URL, and the timestamp when data was fetched.

## 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"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [],
     "properties": {
      "month": {
       "type": "string",
       "description": "Report month YYYY-MM (default: this month, falling back to last month)"
      },
      "region": {
       "type": "string",
       "description": "Region name as in the CSV, e.g. United States, World (default United States)"
      },
      "commodity": {
       "type": "string",
       "description": "Commodity name as in the CSV, e.g. Corn, Wheat, Soybean, Cotton (default Corn)"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "rows": [
   {
    "unit": "Years",
    "value": 18,
    "attribute": "Domestic Use",
    "marketYear": "",
    "reportDate": "October 2026",
    "estimateFlag": ""
   },
   {
    "unit": "Million Bushels",
    "value": 217,
    "attribute": "Domestic Use",
    "marketYear": "",
    "reportDate": "October 2026",
    "estimateFlag": ""
   }
  ],
  "month": "2026-10",
  "region": "United States",
  "source": "https://www.usda.gov/sites/default/files/documents/oce-wasde-report-data-2026-10.csv",
  "checkedAt": "2026-10-23T09:38:24.138Z",
  "commodity": "Corn"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/usda-wasde-crop-supply-demand-reports-12e2e5d5/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.tradeenergy-api.workers.dev](https://www.zero.xyz/host/api.tradeenergy-api.workers.dev/llms.txt)