Build agricultural market risk report API

Aggregate weather exposure, calendar, yield, price, spread, fertilizer, input-cost, grain-quality, and insurance-evidence sections from caller-supplied agricultural records.

The Build agricultural market risk report operation is part of the Agriculture & Commodity Intelligence API on BRAINIAC.software. Aggregate weather exposure, calendar, yield, price, spread, fertilizer, input-cost, grain-quality, and insurance-evidence sections from caller-supplied agricultural records. It is exposed as POST /api/v1/agriculture-intelligence/market-risk-report and priced at $0.08 USDC on Base. Payment uses the x402 exact scheme: an unpaid call returns HTTP 402 with payment requirements; after paying the exact USDC amount, retry the same request with a payment-signature header and Idempotency-Key. No account and no API key are required. Data sources for this product: Caller-supplied fields, weather, calendars, yields, prices, input costs, grain lots/specs, and insurance evidence Open-Meteo when openMeteo is requested World Bank Open Data when worldBank is requested Limitations: 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. Grain and insurance checks use supplied specs/checklists only. Coverage is not confirmed. Market-risk reports aggregate only sections for which records were supplied or optionally fetched. Outputs are compliance prechecks, drafts, or data lookups for human review. They are not official determinations, legal advice, identity confirmation, or certified filings. Related operations in this group include Analyze crop weather exposure, Validate crop calendars, Estimate crop yields, Normalize commodity price series. Open the group documentation for the full request schema, field notes, and response examples before integrating.

POST$0.08 USDC
/api/v1/agriculture-intelligence/market-risk-report

Example request

curl -i -X POST "https://www.brainiac.software/api/v1/agriculture-intelligence/market-risk-report" \
  -H 'content-type: application/json' \
  -H 'Idempotency-Key: <fresh-64-character-random-hex-key>' \
  --data-binary @- <<'JSON'
{
  "asOf": "2026-11-04T21:00:00.000Z",
  "fields": [
    {
      "id": "F1",
      "fieldId": "NORTH-40",
      "crop": "corn",
      "hectares": 40,
      "source": "Caller-supplied"
    }
  ],
  "weather": [
    {
      "fieldId": "NORTH-40",
      "at": "2026-06-01",
      "temperatureC": 22,
      "precipitationMm": 5,
      "source": "Caller-supplied"
    },
    {
      "fieldId": "NORTH-40",
      "at": "2026-06-02",
      "temperatureC": -1,
      "precipitationMm": 0,
      "frost": true,
      "source": "Caller-supplied"
    }
  ],
  "calendars": [
    {
      "crop": "corn",
      "stage": "planting",
      "windowStart": "2026-04-15",
      "windowEnd": "2026-05-20",
      "eventAt": "2026-05-01",
      "source": "Caller-supplied"
    }
  ],
  "yields": [
    {
      "fieldId": "NORTH-40",
      "crop": "corn",
      "hectares": 40,
      "expectedYieldPerHa": 11.2,
      "weatherStressFactor": 0.9,
      "unit": "tonne",
      "source": "Caller-supplied"
    }
  ],
  "prices": [
    {
      "commodity": "corn",
      "at": "2026-11-01",
      "price": 4.55,
      "unit": "USD/bu",
      "side": "spot",
      "source": "Caller-supplied"
    },
    {
      "commodity": "corn",
      "at": "2026-11-01",
      "price": 4.8,
      "unit": "USD/bu",
      "side": "futures",
      "source": "Caller-supplied"
    }
  ],
  "inputCosts": [
    {
      "category": "fertilizer",
      "product": "urea",
      "ratePerHa": 200,
      "pricePerUnit": 0.5,
      "unit": "kg",
      "side": "prior",
      "source": "Caller-supplied"
    },
    {
      "category": "fertilizer",
      "product": "urea",
      "ratePerHa": 200,
      "pricePerUnit": 0.55,
      "unit": "kg",
      "side": "current",
      "hectares": 40,
      "source": "Caller-supplied"
    }
  ],
  "grainSpecs": [
    {
      "commodity": "wheat",
      "maxMoisturePct": 13.5,
      "minProteinPct": 11,
      "source": "Caller-supplied"
    }
  ],
  "grainLots": [
    {
      "lotId": "LOT-1",
      "commodity": "wheat",
      "moisturePct": 12.8,
      "proteinPct": 12.1,
      "source": "Caller-supplied"
    }
  ],
  "requiredEvidence": [
    "Acreage report",
    "Notice of loss"
  ],
  "evidenceItems": [
    {
      "label": "Acreage report",
      "present": true,
      "source": "Caller-supplied"
    }
  ]
}
JSON

An unpaid probe returns HTTP 402 with x402 payment requirements. After paying the exact USDC amount on Base, retry the identical request with a payment-signature header.

FAQ

  • Do I need an API key? No. Pay the listed USDC amount with x402.
  • What network? Base (eip155:8453), USDC.
  • Is this an official determination? No. Results are for human review against the cited sources.

Related APIs

Agriculture & Commodity Intelligence APIFull docsHow it works