{"uid":"cap_u_mm8ZuHN_c4GNWgEu06o","slug":"brainiac-agriculture-intelligence-commodity-price-spread-analyzer-b6a870b0","name":"BRAINIAC Agriculture Intelligence — Commodity Price Spread Analyzer","description":"Pay-per-call APIs for AI agents: OFAC sanctions screening, compliance checks, token security, and Base chain data via x402. No account. Fixed USDC price. MCP-ready.","url":"https://www.brainiac.software/api/v1/agriculture-intelligence/commodity-price-spread-analyze?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"csv":{"type":"string","maxLength":200000},"asOf":{"type":"string","maxLength":40},"file":{"type":"object","required":["fileBase64"],"properties":{"role":{"type":"string","maxLength":80},"filename":{"type":"string","maxLength":180,"minLength":1},"mediaType":{"enum":["text/plain","text/csv","application/json","application/octet-stream"],"type":"string"},"fileBase64":{"type":"string","maxLength":12000000,"minLength":1}},"additionalProperties":false},"json":{"type":"string","maxLength":200000},"text":{"type":"string","maxLength":200000},"files":{"type":"array","items":{"type":"object","required":["fileBase64"],"properties":{"role":{"type":"string","maxLength":80},"filename":{"type":"string","maxLength":180,"minLength":1},"mediaType":{"enum":["text/plain","text/csv","application/json","application/octet-stream"],"type":"string"},"fileBase64":{"type":"string","maxLength":12000000,"minLength":1}},"additionalProperties":false},"maxItems":20},"fields":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"crop":{"type":"string","maxLength":80},"region":{"type":"string","maxLength":120},"source":{"type":"string","maxLength":200},"fieldId":{"type":"string","maxLength":80},"variety":{"type":"string","maxLength":120},"hectares":{"type":"number","maximum":1000000,"minimum":0},"plantedAt":{"type":"string","maxLength":40},"latitudeDeg":{"type":"number","maximum":90,"minimum":-90},"longitudeDeg":{"type":"number","maximum":180,"minimum":-180},"expectedHarvestAt":{"type":"string","maxLength":40}},"additionalProperties":false},"maxItems":2000},"prices":{"type":"array","items":{"type":"object","properties":{"at":{"type":"string","maxLength":40},"id":{"type":"string","maxLength":80},"side":{"enum":["spot","futures","basis","left","right","a","b"],"type":"string"},"unit":{"type":"string","maxLength":40},"price":{"type":"number","maximum":1000000000,"minimum":0},"market":{"type":"string","maxLength":80},"source":{"type":"string","maxLength":200},"symbol":{"type":"string","maxLength":40},"currency":{"type":"string","maxLength":12},"commodity":{"type":"string","maxLength":80}},"additionalProperties":false},"maxItems":10000},"yields":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"crop":{"type":"string","maxLength":80},"unit":{"type":"string","maxLength":40},"source":{"type":"string","maxLength":200},"fieldId":{"type":"string","maxLength":80},"hectares":{"type":"number","maximum":1000000,"minimum":0},"expectedYieldPerHa":{"type":"number","maximum":1000000,"minimum":0},"weatherStressFactor":{"type":"number","maximum":5,"minimum":0},"historicalYieldPerHa":{"type":"number","maximum":1000000,"minimum":0}},"additionalProperties":false},"maxItems":2000},"weather":{"type":"array","items":{"type":"object","properties":{"at":{"type":"string","maxLength":40},"id":{"type":"string","maxLength":80},"crop":{"type":"string","maxLength":80},"frost":{"type":"boolean"},"source":{"type":"string","maxLength":200},"fieldId":{"type":"string","maxLength":80},"periodEnd":{"type":"string","maxLength":40},"droughtDays":{"type":"number","maximum":3650,"minimum":0},"humidityPct":{"type":"number","maximum":100,"minimum":0},"periodStart":{"type":"string","maxLength":40},"windSpeedMs":{"type":"number","maximum":200,"minimum":0},"temperatureC":{"type":"number","maximum":80,"minimum":-80},"precipitationMm":{"type":"number","maximum":2000,"minimum":0}},"additionalProperties":false},"maxItems":5000},"calendars":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"crop":{"type":"string","maxLength":80},"stage":{"type":"string","maxLength":80},"region":{"type":"string","maxLength":120},"source":{"type":"string","maxLength":200},"eventAt":{"type":"string","maxLength":40},"windowEnd":{"type":"string","maxLength":40},"windowStart":{"type":"string","maxLength":40}},"additionalProperties":false},"maxItems":2000},"grainLots":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"grade":{"type":"string","maxLength":40},"lotId":{"type":"string","maxLength":80},"source":{"type":"string","maxLength":200},"commodity":{"type":"string","maxLength":80},"damagePct":{"type":"number","maximum":100,"minimum":0},"proteinPct":{"type":"number","maximum":100,"minimum":0},"testWeight":{"type":"number","maximum":1000,"minimum":0},"moisturePct":{"type":"number","maximum":100,"minimum":0},"foreignMaterialPct":{"type":"number","maximum":100,"minimum":0}},"additionalProperties":false},"maxItems":2000},"openMeteo":{"type":"object","required":["latitudeDeg","longitudeDeg"],"properties":{"crop":{"type":"string","maxLength":80},"days":{"type":"integer","maximum":16,"minimum":1},"start":{"type":"string","maxLength":40},"fieldId":{"type":"string","maxLength":80},"latitudeDeg":{"type":"number","maximum":90,"minimum":-90},"longitudeDeg":{"type":"number","maximum":180,"minimum":-180}},"additionalProperties":false},"worldBank":{"type":"object","required":["country","indicator"],"properties":{"country":{"type":"string","maxLength":3,"minLength":2},"perPage":{"type":"integer","maximum":100,"minimum":1},"commodity":{"type":"string","maxLength":80},"indicator":{"type":"string","maxLength":80,"minLength":2}},"additionalProperties":false},"grainSpecs":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"source":{"type":"string","maxLength":200},"commodity":{"type":"string","maxLength":80},"maxDamagePct":{"type":"number","maximum":100,"minimum":0},"minProteinPct":{"type":"number","maximum":100,"minimum":0},"minTestWeight":{"type":"number","maximum":1000,"minimum":0},"requiredGrade":{"type":"string","maxLength":40},"maxMoisturePct":{"type":"number","maximum":100,"minimum":0},"maxForeignMaterialPct":{"type":"number","maximum":100,"minimum":0}},"additionalProperties":false},"maxItems":500},"inputCosts":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"name":{"type":"string","maxLength":120},"side":{"enum":["left","right","a","b","prior","current"],"type":"string"},"unit":{"type":"string","maxLength":40},"source":{"type":"string","maxLength":200},"product":{"type":"string","maxLength":120},"category":{"enum":["fertilizer","seed","chemical","fuel","labor","other"],"type":"string"},"currency":{"type":"string","maxLength":12},"hectares":{"type":"number","maximum":1000000,"minimum":0},"nutrient":{"type":"string","maxLength":40},"ratePerHa":{"type":"number","maximum":1000000,"minimum":0},"pricePerUnit":{"type":"number","maximum":1000000,"minimum":0}},"additionalProperties":false},"maxItems":5000},"excessRainMm":{"type":"number","maximum":2000,"minimum":1},"evidenceItems":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"crop":{"type":"string","maxLength":80},"label":{"type":"string","maxLength":200},"source":{"type":"string","maxLength":200},"fieldId":{"type":"string","maxLength":80},"present":{"type":"boolean"}},"additionalProperties":false},"maxItems":500},"frostThresholdC":{"type":"number","maximum":10,"minimum":-40},"requiredEvidence":{"type":"array","items":{"type":"string","maxLength":200},"maxItems":100},"droughtThresholdDays":{"type":"number","maximum":365,"minimum":1}}},"responseSchema":{"type":"json","example":{"items":[{"unit":"USD/bu","leftAt":"2026-11-01","leftId":"P1","source":"Caller-supplied; Caller-supplied","spread":0.25,"rightAt":"2026-11-01","rightId":"P2","currency":"USD","leftSide":"spot","commodity":"corn","leftPrice":4.55,"rightSide":"futures","spreadPct":5.3476,"rightPrice":4.8,"spreadPctSupplied":true,"paidCommodityFeedUsed":false}],"status":"analyzed","findings":[],"checkedAt":"2026-11-04T21:00:00.000Z","limitations":["Agricultural fields, weather, calendars, yields, commodity prices, input costs, grain lots/specs, and insurance evidence are copied only from labeled fields supplied by the caller, or from key-free Open-Meteo / World Bank Open Data when explicitly requested.","No paid commodity feed or authenticated agricultural platform is used and no API key is required.","Missing values are not invented. Yield and cost calculations use only supplied quantities, rates, prices, and optional stress factors.","Crop calendars are validated against caller-supplied windows only—not regulatory planting mandates.","Market-risk reports aggregate only sections for which records were supplied or optionally fetched."],"spreadCount":1,"apiKeyRequired":false,"openMeteoFetched":false,"paidProviderUsed":false,"worldBankFetched":false,"paidCommodityFeedUsed":false}},"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_khUIv6EWG4z67lMMp-ybr","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":"Analyzes price spreads between two commodity price observations (spot, futures, basis, etc.) and returns the spread, spread percentage, and contextual findings for agricultural commodities.","exampleAgentPrompt":"Analyze the price spread between corn spot at $4.55/bu and corn futures at $4.80/bu, both as of November 1 2026 — give me the spread in USD and the percentage, using USD/bu as the unit.","exampleUseCases":[{"title":"Grain hedging spread check","prompt":"I have corn spot priced at $4.55 per bushel and December futures at $4.80 per bushel as of today — can you calculate the spread and spread percentage so I can decide whether to hedge?"},{"title":"Soybean basis risk report","prompt":"Compare my soybean cash price of $12.10/bu against the nearby futures price of $12.45/bu as of March 15 2026, and tell me the basis spread and what percentage that represents."},{"title":"Multi-crop spread analysis from CSV","prompt":"I've got a CSV with both spot and futures prices for wheat, corn, and soybeans across several dates in Q4 2025 — can you run a spread analysis on each pair and summarize the findings?"}],"resultDescription":"Returns a JSON object with an 'items' array where each entry contains the computed spread (absolute and percentage), left and right price values, their sides (spot/futures/basis/etc.), commodity name, unit, currency, source description, and timestamps. Also includes a top-level status, checkedAt timestamp, spreadCount, findings array, and a limitations list clarifying that only caller-supplied data or free public sources (Open-Meteo, World Bank) are used — no paid commodity feeds.","failureModes":["Missing required price pair fields result in no items returned or null spread values","Invalid or non-numeric price values may cause computation to fail or return zero spread","Unsupported 'side' enum values outside the allowed set will be rejected by schema validation","Very large CSV/JSON inputs exceeding 200,000 character limit will be rejected","If asOf date format is invalid, timestamp parsing may fail","Ambiguous commodity names may result in generic or unrecognized commodity labels in output"],"whenToPreferThis":"Use this endpoint when you need to compute price spreads and basis differentials between two commodity price observations (spot vs. futures, cash vs. exchange, etc.) without requiring API keys or paid data subscriptions. Ideal for agents operating in agricultural finance, grain trading, or agribusiness contexts where the user supplies their own price data. Prefer over general financial APIs when working specifically with agricultural commodities and when the x402 pay-per-call model (no account needed, $0.03 USDC on Base) is acceptable.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-11T15:01:44.278Z","isFirstParty":false,"canonicalSlug":"brainiac-agriculture-intelligence-commodity-price-spread-analyzer-b6a870b0"}