Estimate crop yields API

Estimate total yield from caller-supplied hectares and expected/historical yield-per-hectare rates, with optional weather stress factors.

The Estimate crop yields operation is part of the Agriculture & Commodity Intelligence API on BRAINIAC.software. Estimate total yield from caller-supplied hectares and expected/historical yield-per-hectare rates, with optional weather stress factors. It is exposed as POST /api/v1/agriculture-intelligence/crop-yield-estimate and priced at $0.04 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, Normalize commodity price series, Analyze commodity price spreads. Open the group documentation for the full request schema, field notes, and response examples before integrating.

POST$0.04 USDC
/api/v1/agriculture-intelligence/crop-yield-estimate

Example request

curl -i -X POST "https://www.brainiac.software/api/v1/agriculture-intelligence/crop-yield-estimate" \
  -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"
    }
  ],
  "yields": [
    {
      "id": "Y1",
      "fieldId": "NORTH-40",
      "crop": "corn",
      "hectares": 40,
      "expectedYieldPerHa": 11.2,
      "weatherStressFactor": 0.9,
      "unit": "tonne",
      "source": "Caller-supplied agronomy"
    }
  ]
}
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