{"uid":"cap_L1W6-l8zx2f07wnhfAD1Z","slug":"usda-nass-crop-production-grain-stocks-api-bd7524cf","name":"USDA NASS Crop Production & Grain Stocks API","description":"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.","url":"https://payai.agentstools.dev/agri/production","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","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"}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.02","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.02/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_mH4U4T2JTaS8xjoRq70v_","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns US crop production, yield, acreage, and grain stocks data from USDA NASS QuickStats for a given commodity, with optional state and year filtering, including year-over-year change.","exampleAgentPrompt":"What were US soybean production figures for Illinois in 2022, and how did that compare to the prior year? Pull from USDA NASS data.","exampleUseCases":[{"title":"Commodity price forecasting for grain traders","prompt":"Pull the last five years of corn yield data for the top producing states and show me year-over-year changes. I need to identify yield trends before the next harvest report drops."},{"title":"Agricultural risk assessment for lenders","prompt":"Get me wheat acreage and production data for Oklahoma, Kansas, and Texas going back three years so I can evaluate loan risk for our farming customers in that region."},{"title":"Crop insurance analysis and claims validation","prompt":"I need the USDA NASS production and yield figures for soybeans nationally for the last two years, broken down by state if possible, to help validate a customer's crop loss claim."}],"resultDescription":"A normalized, cited time series of the requested metric (production, yield, acreage, or stocks) for the specified commodity and optional state, including the year-over-year change, sourced from USDA NASS QuickStats.","failureModes":["Invalid or unsupported commodity returns an error — only corn, soybeans, wheat, and cotton are supported","Year out of range (before 2000 or after 2100) returns a validation error","Invalid 2-letter state code returns an error or no data","Data not yet available for the requested year may return empty or latest available data","Network or upstream USDA NASS API unavailability may cause failures"],"whenToPreferThis":"Use this endpoint when you need authoritative US agricultural production, yield, acreage, or grain stocks data for corn, soybeans, wheat, or cotton — sourced directly from USDA NASS QuickStats. Prefer this over general economic data APIs when the query is specifically about US crop commodities, especially when state-level breakdowns or year-over-year comparisons are needed.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T01:02:40.444Z","isFirstParty":false}