# Netzhandwerker Flexibility Window

> Netzhandwerker Flexibility Window 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-15).

Identifies optimal flexibility windows for energy load shifting, battery arbitrage, and demand response based on real-time grid conditions

## Facts

- Endpoint: POST https://energy.netzhandwerker.de/flexibility/window
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/netzhandwerker-flexibility-window-9e598faf
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_8GvipRJIKCH4e8tOrJk_v

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-flexibility-window-9e598faf -d '<json body>'
```

Example prompt: Find me the best flexibility windows for tomorrow in Germany — I want to know when to charge my 100 kWh battery and when to discharge it back to the grid for maximum arbitrage profit.

## When to prefer this

Use this endpoint when you need to schedule energy asset operations — battery charge/discharge, EV charging, industrial load shifting — around real-time and forecast grid flexibility signals. Prefer this over generic price lookup endpoints when you need actionable scheduling windows rather than raw price series, especially for battery arbitrage or demand response participation.

## Known failure modes

- No flexibility windows found for the requested time range — grid conditions are flat
- Invalid or unsupported region returns 400 with supported regions list
- Requested time window too far in future beyond forecast horizon returns partial results
- Missing required parameters such as capacity or region returns 422 validation error
- Service unavailable during grid data feed outage returns 503

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

Returns a list of identified flexibility windows including start/end timestamps, expected price differential, recommended action (charge/discharge/shift), renewable share during each window, and carbon intensity — enabling autonomous scheduling of energy assets.

## 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": {
  "hint": "Niedrige Preise korrelieren oft mit hoher EE-Einspeisung",
  "source": "EPEX + Corrently Analyse",
  "timestamp": "2026-07-13T22:51:13.311Z",
  "cheapest_hours": [
   {
    "hour": 13,
    "score": -5.18,
    "start": "2026-07-14T11:00:00.000Z",
    "price_ct_kwh": 5.18
   },
   {
    "hour": 14,
    "score": -5.77,
    "start": "2026-07-14T12:00:00.000Z",
    "price_ct_kwh": 5.77
   },
   {
    "hour": 12,
    "score": -6.4,
    "start": "2026-07-14T10:00:00.000Z",
    "price_ct_kwh": 6.4
   }
  ],
  "recommendation": "Beste Lade-/Heiz-Zeitfenster der nächsten 24h basierend auf Spotpreisen und GrünstromIndex",
  "most_expensive_hours": [
   {
    "hour": 20,
    "score": -18.25,
    "start": "2026-07-14T18:00:00.000Z",
    "price_ct_kwh": 18.25
   },
   {
    "hour": 21,
    "score": -17.53,
    "start": "2026-07-14T19:00:00.000Z",
    "price_ct_kwh": 17.53
   },
   {
    "hour": 22,
    "score": -16.88,
    "start": "2026-07-14T20:00:00.000Z",
    "price_ct_kwh": 16.88
   }
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/netzhandwerker-flexibility-window-9e598faf/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)