# Netzhandwerker Grid Events Stream

> Netzhandwerker Grid Events Stream is a paid API for AI agents from energy.netzhandwerker.de, paid per call via x402, $0.005/call, status unknown (last checked 2026-09-13).

Streams real-time grid events including electricity prices, carbon intensity, renewable share, flexibility windows, and battery arbitrage signals for a given energy market region.

## Facts

- Endpoint: POST https://energy.netzhandwerker.de/events/grid
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/netzhandwerker-grid-events-stream-d4b60ea7
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_846mKHfxDClmxLSlybLz1

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 netzhandwerker-grid-events-stream-d4b60ea7 -d '<json body>'
```

Example prompt: What are the current grid events for the German energy market — give me live electricity prices, carbon intensity, renewable share, and any battery arbitrage or flexibility windows active right now.

## When to prefer this

Use this endpoint when an AI agent needs real-time grid-level intelligence for energy optimization decisions — such as scheduling battery charge/discharge cycles, timing high-load operations for low-carbon or low-cost windows, generating ESG reports, or executing energy trading strategies. Prefer this over static pricing APIs when live signal freshness and multi-dimensional grid data (price + carbon + renewables + flexibility) are all required simultaneously.

## Known failure modes

- Invalid or unsupported grid region returns 400 with region validation error
- Payment not received or insufficient USDC balance returns 402 Payment Required
- Upstream grid data provider unavailable returns 503 with retry guidance
- Malformed event filter parameters return 422 with field-level validation errors
- Rate limit exceeded returns 429 with backoff instructions

## How this service works

Live electricity prices, carbon intensity, grid load, renewable share, flexibility windows, battery arbitrage, trading signals and ESG reporting for autonomous agents.

## Output

Returns a stream of grid events for the requested market region, including spot electricity prices, carbon intensity values, current grid load percentage, renewable energy share, identified flexibility windows for demand response, battery arbitrage opportunity signals, energy trading signals, and ESG reporting metrics.

## 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",
    "bodyType",
    "body"
   ],
   "properties": {
    "body": {
     "type": "object",
     "properties": {},
     "additionalProperties": false
    },
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "POST",
      "PUT",
      "PATCH"
     ],
     "type": "string"
    },
    "bodyType": {
     "enum": [
      "json",
      "form-data",
      "text"
     ],
     "type": "string"
    }
   },
   "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/netzhandwerker-grid-events-stream-d4b60ea7/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from energy.netzhandwerker.de](https://www.zero.xyz/host/energy.netzhandwerker.de/llms.txt)