{"uid":"cap_p_UJB3os7eoLrJ8eur2W9","slug":"usda-agricultural-signal-fusion-spot-price-percentile-yoy-context-60d0f99c","name":"USDA Agricultural Signal Fusion — Spot Price, Percentile & YoY Context","description":"USDA NASS production and grain-stocks signal for a commodity: the QuickStats production and stocks series computed into context - production and stocks year-over-year change and history percentiles. When a USDA Market News key is configured it also folds in the spot/auction price and its change; without one it returns the NASS side and notes the gap.","url":"https://payai.agentstools.dev/agri/signal","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":{"commodity":{"enum":["corn","soybeans","wheat"],"type":"string","description":"Commodity to fuse (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.03","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.03/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.03","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.03","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_y-MKhTLzyxmEDVLwDnaUq","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.03","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Combines USDA Market News spot price with NASS production and stocks data into a fused signal including spot change, price percentile over history, and year-over-year production/stocks context for corn, soybeans, or wheat.","exampleAgentPrompt":"Can you pull the fused agricultural signal for soybeans — I want to see the current spot price, where it sits historically as a percentile, and the year-over-year production and stocks context?","exampleUseCases":[{"title":"Identify tight grain markets for procurement","prompt":"Pull the fused signal for corn and wheat right now — I need to see if prices are elevated historically and whether production or stocks are down year-over-year, so I can adjust our buying strategy."},{"title":"Monitor commodity price volatility trends","prompt":"Can you get me the latest signals for soybeans and corn? I want to know the recent spot price changes and where those prices fall in their historical ranges — helps me understand if we're in unusual volatility."},{"title":"Assess supply-constrained commodities","prompt":"Check the fused agricultural signal for all three grains and flag any where stocks or production dropped significantly year-over-year while prices moved up. That'll tell me which markets might have supply pressure."}],"resultDescription":"Returns a computed signal object for the requested commodity including: the current USDA Market News spot price, the recent spot price change, the price percentile relative to full available price history, and year-over-year percentage changes in NASS production and grain stocks — all fused into a single response.","failureModes":["Unsupported commodity value returns a validation error (only corn, soybeans, wheat accepted)","USDA upstream data unavailable or stale returns an error or partial signal","Missing or malformed query parameter defaults to corn without error","Rate limiting or payment failure returns 402 Payment Required"],"whenToPreferThis":"Use this endpoint when you need a holistic, pre-computed agricultural market signal for a major US grain commodity that combines price level, price trend, historical price percentile, and supply/production context in a single call. Prefer this over separate NASS crop production or raw spot price lookups when you need cross-source fusion rather than raw data.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T01:02:24.141Z","isFirstParty":false}