{"uid":"cap_ek7nKwQFx5Wi7uY-AaZuJ","slug":"usda-wasde-crop-supply-demand-reports-12e2e5d5","name":"USDA WASDE Crop Supply & Demand Reports","description":"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.","url":"https://api.tradeenergy-api.workers.dev/api/energy/usda-wasde-crop-reports?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"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"}}}}},"responseSchema":{"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"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.002","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.002/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_aOuctiCFHLEPpVqM8ZNL9","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.002","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"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.","exampleAgentPrompt":"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.","exampleUseCases":[{"title":"Tracking US corn ending stocks","prompt":"What does the latest USDA WASDE report say about corn ending stocks in the United States? I want the current figures including production and domestic use."},{"title":"Monitoring global soybean supply estimates","prompt":"Get me the USDA WASDE supply and demand data for Soybeans at the World level from the October 2024 report — I need production and ending stocks figures."},{"title":"Comparing wheat outlook for trading research","prompt":"Can you fetch the USDA WASDE numbers for Wheat in the United States from the most recent monthly report? I'm tracking changes in production and export estimates."}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-29T00:34:26.211Z","isFirstParty":false,"canonicalSlug":"usda-wasde-crop-supply-demand-reports-12e2e5d5"}