# Netzhandwerker Renewable Share API

> Netzhandwerker Renewable Share 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-15).

Returns the current and forecasted renewable energy share of the electricity grid for a given region or time window.

## Facts

- Endpoint: POST https://energy.netzhandwerker.de/renewable/share
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/netzhandwerker-renewable-share-api-407b5add
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_BXzI0FfXcEIuqJLXiSmoa

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-renewable-share-api-407b5add -d '<json body>'
```

Example prompt: What's the current renewable energy share on the German electricity grid right now — and how does it break down between wind, solar, and hydro?

## When to prefer this

Use this endpoint when you need real-time or near-real-time renewable energy share data for electricity grid decision-making, ESG reporting, demand flexibility scheduling, or green energy consumption optimization. Prefer this over general energy APIs when you specifically need the renewable/clean fraction of the grid mix rather than raw price or carbon intensity data.

## Known failure modes

- Unsupported or unrecognized grid zone/region returns a 400 or 404 error
- Upstream grid data feed unavailable causes a 503 or timeout
- Invalid request body format returns a 422 validation error
- Payment not included or insufficient triggers a 402 Payment Required response
- Rate limit exceeded returns a 429 Too Many Requests error

## 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 the current renewable share of the electricity grid as a percentage, broken down by renewable source type (wind, solar, hydro, etc.), along with the timestamp and grid zone identifier. May include short-term forecast data for renewable share trends.

## 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": {
  "source": "Fraunhofer ISE",
  "total_mw": 35323,
  "fossil_mw": 15203.4,
  "timestamp": "2026-07-13T22:51:15.822Z",
  "breakdown_mw": {
   "Solar": 0,
   "Waste": 1448.6,
   "Others": 136.6,
   "Biomass": 3592.5,
   "Fossil gas": 4133.3,
   "Fossil oil": 377.6,
   "Geothermal": 13.4,
   "Wind onshore": 9073,
   "Wind offshore": 3560.3,
   "Fossil hard coal": 2815.4,
   "Hydro Run-of-River": 1243,
   "Hydro pumped storage": 550.5,
   "Hydro water reservoir": 39.2,
   "Fossil coal-derived gas": 462.5,
   "Fossil brown coal / lignite": 7877.1
  },
  "renewable_mw": 17468.8,
  "renewable_share_pct": "49.5"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/netzhandwerker-renewable-share-api-407b5add/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)