# Netzhandwerker Grid Load API

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

Returns real-time electrical grid load data including current demand, capacity utilization, and load forecasts for energy management and trading decisions.

## Facts

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

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-load-api-cd469d7f -d '<json body>'
```

Example prompt: What's the current electricity grid load right now — I need the demand level and capacity utilization so I can decide whether to charge or discharge my battery storage system.

## When to prefer this

Choose this endpoint when you need real-time or near-real-time grid load data for energy arbitrage decisions, demand response automation, grid stress monitoring, or ESG reporting. Prefer this over generic energy APIs when you need granular load curve data tied to flexibility windows and battery optimization signals on the European/German grid.

## Known failure modes

- Invalid region or grid zone returns 400 with zone not found error
- Requested time range outside available data window returns 404 or empty dataset
- Payment failure via x402 protocol returns 402 Payment Required
- Rate limiting exceeded returns 429 Too Many Requests
- Grid data provider outage returns 503 Service Unavailable
- Malformed POST body returns 400 Bad Request with validation details

## 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 current and forecasted grid load metrics including total demand in MW/GW, capacity utilization percentage, load curve data points, peak demand windows, and potentially regional breakdowns — all suitable for informing battery arbitrage, flexibility scheduling, and ESG reporting workflows.

## 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": {
  "grid": "DE",
  "source": "SMARD Bundesnetzagentur",
  "timestamp": "2026-07-13T21:45:00.000Z",
  "consumption_mwh": 12349
 }
}
```

## More

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