# BRAINIAC Agriculture Intelligence — Commodity Price Spread Analyzer

> BRAINIAC Agriculture Intelligence — Commodity Price Spread Analyzer is a paid API for AI agents from www.brainiac.software, paid per call via x402, $0.03/call, status unknown (last checked 2026-11-11).

Analyzes price spreads between two commodity price observations (spot, futures, basis, etc.) and returns the spread, spread percentage, and contextual findings for agricultural commodities.

## Facts

- Endpoint: POST https://www.brainiac.software/api/v1/agriculture-intelligence/commodity-price-spread-analyze?utm_source=zero.xyz
- Price: $0.03/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-11
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/brainiac-agriculture-intelligence-commodity-price-spread-analyzer-b6a870b0
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_u_mm8ZuHN_c4GNWgEu06o

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability brainiac-agriculture-intelligence-commodity-price-spread-analyzer-b6a870b0 -d '<json body>'
```

Example prompt: 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.

## When to prefer this

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.

## Known failure modes

- 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

## How this service works

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.

## Output

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.

## Request schema (JSON Schema)

```json
{
 "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
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "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
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/brainiac-agriculture-intelligence-commodity-price-spread-analyzer-b6a870b0/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from www.brainiac.software](https://www.zero.xyz/host/www.brainiac.software/llms.txt)
