# Netzhandwerker Grid Congestion API

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

Returns real-time grid congestion data including bottlenecks, overload zones, and transmission constraints for energy management and trading decisions.

## Facts

- Endpoint: POST https://energy.netzhandwerker.de/grid/congestion
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/netzhandwerker-grid-congestion-api-ca43099a
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_7HEMTbvRZmlJ3mtNFZd0t

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-congestion-api-ca43099a -d '<json body>'
```

Example prompt: Check the current grid congestion status in Germany for the next 4 hours — I need to know if there are any transmission bottlenecks or overload zones I should factor into my battery charging schedule.

## When to prefer this

Use this endpoint when you need real-time or near-term grid congestion intelligence for operational decisions such as battery arbitrage scheduling, EV charging optimization, demand response activation, or energy trading signal generation. Prefer this over generic energy price feeds when the decision depends specifically on grid capacity constraints and transmission bottlenecks rather than just spot prices.

## Known failure modes

- Invalid or unsupported grid region returns 400 error
- Request outside available forecast horizon returns empty or partial data
- Payment not attached or insufficient USDC balance returns 402 Payment Required
- Upstream grid data feed unavailable causes 503 or stale data response
- Malformed request body returns 422 validation error

## 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 structured congestion data including active bottleneck zones, congestion severity levels, affected grid regions, transmission constraint windows, and flexibility opportunities — enabling downstream decisions on battery dispatch, demand shifting, or energy trading.

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/netzhandwerker-grid-congestion-api-ca43099a/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)