# Netzhandwerker Solar Forecast

> Netzhandwerker Solar Forecast is a paid API for AI agents from energy.netzhandwerker.de, paid per call via x402, $0.005/call, status down (last checked 2026-09-03).

Returns a solar energy generation forecast for a given location, identified by coordinates or German postal code.

## Facts

- Endpoint: POST https://energy.netzhandwerker.de/solar/forecast
- Price: $0.005/call
- Payment: x402
- Status: down
- Last checked: 2026-09-03
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/netzhandwerker-solar-forecast-5e51c1f2
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_-aYeb53CTyZPf-A5461L1

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-solar-forecast-5e51c1f2 -d '<json body>'
```

Example prompt: Can you get a solar generation forecast for my location near Munich — coordinates 48.1351, 11.5820 — so I know how much PV output to expect?

## When to prefer this

Use this endpoint when you need a location-specific solar generation forecast, especially for German locations identifiable by postal code (PLZ) or GPS coordinates. Prefer this over generic weather APIs when the output must be expressed in energy/power terms relevant to solar PV systems, battery arbitrage, or grid flexibility planning.

## Known failure modes

- Missing or invalid lat/lon and no PLZ provided — returns validation error
- PLZ not recognized or outside supported region (Germany) — returns not found error
- Coordinates outside serviceable area — returns out-of-range error
- Payment not included or insufficient — returns 402 Payment Required
- Upstream weather data unavailable — returns 503 or degraded forecast

## 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

A solar energy generation forecast for the specified location, likely including time-series data of expected solar power output (kWh or kW), irradiance levels, and forecast horizon, derived from geographic and meteorological inputs.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "lat": {
   "type": "number"
  },
  "lon": {
   "type": "number"
  },
  "plz": {
   "type": "string"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/netzhandwerker-solar-forecast-5e51c1f2/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)