# Brazilayer Commodity Signals – Brazil Hydro Energy (EAR) by Subsystem

> Brazilayer Commodity Signals – Brazil Hydro Energy (EAR) by Subsystem is a paid API for AI agents from api.brazilayer.com, paid per call via x402, $0.002/call, status unknown (last checked 2026-09-13).

Returns daily stored hydro energy (EAR) levels for each Brazilian grid subsystem from ONS, including a 7-day delta, as a compact energy-risk gauge.

## Facts

- Endpoint: GET https://api.brazilayer.com/v1/commodities/hidrologia
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/brazilayer-commodity-signals-brazil-hydro-energy-ear-by-subsystem-c62b13e8
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_rPWZN3R2LM8idd6u_6bi-

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-commodity-signals-brazil-hydro-energy-ear-by-subsystem-c62b13e8
```

Example prompt: Pull today's Brazil stored hydro energy (EAR) levels by grid subsystem from the official ONS data, and show me the 7-day delta so I can assess the current energy-risk signal.

## When to prefer this

Choose this endpoint when you need a real-time, official, granular read on Brazil's hydroelectric reservoir levels by subsystem — particularly for energy price risk, industrial cost modeling (aluminum, steel), or commodity narratives tied to Brazilian drought conditions. It is preferable to general macro endpoints when the specific signal needed is hydro storage, not broader market data. Ideal for agents monitoring Brazil energy fundamentals daily.

## Known failure modes

- ONS data source unavailable or delayed — stale or missing daily update
- Network timeout or API downtime resulting in a 5xx error
- Unparseable response if upstream ONS data format changes
- Payment not processed (x402 protocol failure) — no data returned
- Rate limiting if called in rapid succession

## How this service works

Brazil stored hydro energy (EAR) by grid subsystem, daily from the official grid operator (ONS), with 7-day delta. Brazil is hydro-dependent: reservoir levels drive power prices, aluminum/industrial costs and drought narratives. A compact energy-risk gauge for one of the world largest grids. Free sample, no payment: https://api.brazilayer.com/v1/commodities/amostra

## Output

Returns daily stored hydro energy (EAR) values broken down by Brazilian grid subsystem (e.g., Southeast/Center-West, South, Northeast, North), sourced from the official ONS grid operator, along with a 7-day rolling delta indicating the directional trend in reservoir levels — functioning as a compact, actionable energy-risk gauge.

## 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-commodity-signals-brazil-hydro-energy-ear-by-subsystem-c62b13e8/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)