# Netzhandwerker Energy Research Hub – Region Lookup

> Netzhandwerker Energy Research Hub – Region Lookup 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-15).

Returns live electricity prices, carbon intensity, grid load, renewable share, flexibility windows, battery arbitrage signals, and ESG data for a German postal code region.

## Facts

- Endpoint: POST https://energy.netzhandwerker.de/region
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/netzhandwerker-energy-research-hub-region-lookup-4c8c220f
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_qQ5N5wVOi7tLXeGkPt3qc

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-energy-research-hub-region-lookup-4c8c220f -d '<json body>'
```

Example prompt: What's the live electricity price, carbon intensity, and best battery charging window right now for postal code 80331 in Munich?

## When to prefer this

Use this endpoint when you need real-time, region-specific German energy grid data by postal code — especially for smart home automation, EV or battery charging optimization, carbon footprint tracking, ESG reporting, or energy trading decisions. Prefer this over generic energy APIs when the use case requires German grid granularity at the PLZ level.

## Known failure modes

- Invalid or unrecognized PLZ returns a 4xx error with no data
- PLZ outside Germany or unsupported region returns empty or error response
- Stale data if upstream grid data provider is delayed
- Network timeout if real-time grid data is temporarily unavailable
- Missing required 'plz' field in request body returns 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 a structured response containing current electricity price, carbon intensity index, grid load percentage, renewable energy share, identified flexibility windows for smart devices or batteries, battery arbitrage signals, trading signals, and ESG/emissions reporting data — all scoped to the requested German postal code region.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "plz"
 ],
 "properties": {
  "plz": {
   "type": "string"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/netzhandwerker-energy-research-hub-region-lookup-4c8c220f/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)