# Netzhandwerker Electricity Price Forecast

> Netzhandwerker Electricity Price Forecast 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 a forward-looking electricity price forecast including expected grid prices, renewable share trends, and flexibility windows for a specified time horizon.

## Facts

- Endpoint: POST https://energy.netzhandwerker.de/price/forecast
- 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-electricity-price-forecast-06b8bfe4
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_t2FerEGfx0cxNJHf7pnPc

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-electricity-price-forecast-06b8bfe4 -d '<json body>'
```

Example prompt: Give me an electricity price forecast for the German grid zone for the next 24 hours at 15-minute resolution, so I can plan when to charge the battery and identify the cheapest flexibility windows.

## When to prefer this

Choose this endpoint when you need forward-looking electricity price predictions rather than current spot prices — ideal for scheduling battery charge/discharge cycles, optimizing EV charging times, planning industrial load shifting, or generating trading signals based on expected price movements. Prefer this over real-time price endpoints when decisions require lookahead planning.

## Known failure modes

- Unsupported grid zone or market area returns 400 with zone validation error
- Requested forecast horizon exceeds maximum supported window returns 422
- Payment not attached or insufficient USDC balance returns 402 Payment Required
- Forecast model temporarily unavailable returns 503
- Invalid resolution interval returns 400 with supported intervals list
- Rate limit exceeded returns 429 with retry-after header

## How this service works

One x402 call returns the action, best time window, expected EUR value, confidence and expiry for German and European electricity decisions. USDC on Base, no API key or account.

## Output

A time-series of forecasted electricity prices (€/MWh) for the requested horizon and resolution, along with predicted renewable share percentages, identified low-cost flexibility windows, and battery arbitrage opportunity timestamps suitable for automated trading or scheduling decisions.

## 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"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "hours": 24,
  "hourly": [
   {
    "end": "2026-07-13T23:00:00.000Z",
    "start": "2026-07-13T22:00:00.000Z",
    "price_ct_kwh": "13.96",
    "price_eur_mwh": 139.64
   },
   {
    "end": "2026-07-14T00:00:00.000Z",
    "start": "2026-07-13T23:00:00.000Z",
    "price_ct_kwh": "13.39",
    "price_eur_mwh": 133.89
   },
   {
    "end": "2026-07-14T01:00:00.000Z",
    "start": "2026-07-14T00:00:00.000Z",
    "price_ct_kwh": "12.73",
    "price_eur_mwh": 127.35
   },
   {
    "end": "2026-07-14T02:00:00.000Z",
    "start": "2026-07-14T01:00:00.000Z",
    "price_ct_kwh": "12.72",
    "price_eur_mwh": 127.22
   },
   {
    "end": "2026-07-14T03:00:00.000Z",
    "start": "2026-07-14T02:00:00.000Z",
    "price_ct_kwh": "12.77",
    "price_eur_mwh": 127.65
   },
   {
    "end": "2026-07-14T04:00:00.000Z",
    "start": "2026-07-14T03:00:00.000Z",
    "price_ct_kwh": "13.50",
    "price_eur_mwh": 135.02
   },
   {
    "end": "2026-07-14T05:00:00.000Z",
    "start": "2026-07-14T04:00:00.000Z",
    "price_ct_kwh": "14.58",
    "price_eur_mwh": 145.81
   },
   {
    "end": "2026-07-14T06:00:00.000Z",
    "start": "2026-07-14T05:00:00.000Z",
    "price_ct_kwh": "15.23",
    "price_eur_mwh": 152.27
   },
   {
    "end": "2026-07-14T07:00:00.000Z",
    "start": "2026-07-14T06:00:00.000Z",
    "price_ct_kwh": "13.57",
    "price_eur_mwh": 135.67
   },
   {
    "end": "2026-07-14T08:00:00.000Z",
    "start": "2026-07-14T07:00:00.000Z",
    "price_ct_kwh": "12.19",
    "price_eur_mwh": 121.89
   },
   {
    "end": "2026-07-14T09:00:00.000Z",
    "start": "2026-07-14T08:00:00.000Z",
    "price_ct_kwh": "10.75",
    "price_eur_mwh": 107.48
   },
   {
    "end": "2026-07-14T10:00:00.000Z",
    "start": "2026-07-14T09:00:00.000Z",
    "price_ct_kwh": "9.17",
    "price_eur_mwh": 91.69
   },
   {
    "end": "2026-07-14T11:00:00.000Z",
    "start": "2026-07-14T10:00:00.000Z",
    "price_ct_kwh": "6.40",
    "price_eur_mwh": 64.04
   },
   {
    "end": "2026-07-14T12:00:00.000Z",
    "start": "2026-07-14T11:00:00.000Z",
    "price_ct_kwh": "5.18",
    "price_eur_mwh": 51.83
   },
   {
    "end": "2026-07-14T13:00:00.000Z",
    "start": "2026-07-14T12:00:00.000Z",
    "price_ct_kwh": "5.77",
    "price_eur_mwh": 57.73
   },
   {
    "end": "2026-07-14T14:00:00.000Z",
    "start": "2026-07-14T13:00:00.000Z",
    "price_ct_kwh": "7.00",
    "price_eur_mwh": 70
   },
   {
    "end": "2026-07-14T15:00:00.000Z",
    "start": "2026-07-14T14:00:00.000Z"
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/netzhandwerker-electricity-price-forecast-06b8bfe4/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)
