# Brazilayer Causal Chains – Soybean Supply (soja_zs)

> Brazilayer Causal Chains – Soybean Supply (soja_zs) is a paid API for AI agents from api.brazilayer.com, paid per call via x402, $0.05/call, status unknown (last checked 2026-09-14).

Returns the causal chain for Brazilian soybean supply: consecutive dry days in Mato Grosso, forecast rainfall for MT and the South, last month's officially recorded export volume, and year-over-year change.

## Facts

- Endpoint: GET https://api.brazilayer.com/v1/cadeias/soja_zs
- Price: $0.05/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/brazilayer-causal-chains-soybean-supply-soja-zs-d676e2bc
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_L18VTsjN2pXWJDqaCPJx7

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 brazilayer-causal-chains-soybean-supply-soja-zs-d676e2bc
```

Example prompt: Pull the latest Brazilayer soybean causal chain for me — I want to see the current consecutive dry days in Mato Grosso, the forecast rainfall, last month's official export volume, and how that compares year-over-year.

## When to prefer this

Choose this endpoint when you need the physical supply-side picture of Brazilian soybeans — combining weather stress, forward-looking rainfall, and official export registry data in a single causal chain. Prefer it over price feeds when you want leading indicators (dry days lead yield and shipments by months) rather than current market prices. It is distinct from general commodity briefings in that it is structured, machine-readable, and focused purely on the soja/ZS supply chain rather than narrative synthesis.

## Known failure modes

- Official trade registry data may lag by days or weeks, so last month's export figure could be preliminary
- Rainfall forecast data may not be available if the upstream meteorological source is unavailable
- HTTP 402 Payment Required if x402 payment header is missing or USDC balance is insufficient
- HTTP 429 if rate limits are exceeded
- HTTP 503 if the upstream government data sources are temporarily unavailable

## How this service works

Causal chain for soybeans: consecutive dry days in the Mato Grosso belt (leads yield and shipped volume by months) → forecast rainfall in MT and the South → soybean volume actually exported last month from the official trade registry → year-over-year change. Brazil is the largest soybean exporter; this is the physical and trade side of global supply, not a price feed. Free sample, no payment: https://api.brazilayer.com/v1/cadeias/amostra

## Output

A structured causal chain object containing: (1) number of consecutive dry days recorded in the Mato Grosso soybean belt (a leading indicator of yield and export volume); (2) forecast rainfall for Mato Grosso and Southern Brazil; (3) soybean volume officially exported in the previous month from Brazil's trade registry; and (4) the year-over-year percentage or absolute change in that export volume.

## Request schema (JSON Schema)

```json
{
 "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"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "properties": {}
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/brazilayer-causal-chains-soybean-supply-soja-zs-d676e2bc/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.brazilayer.com](https://www.zero.xyz/host/api.brazilayer.com/llms.txt)