# Netzhandwerker Energy Research Hub – Trading Bundle

> Netzhandwerker Energy Research Hub – Trading Bundle is a paid API for AI agents from energy.netzhandwerker.de, paid per call via x402, $0.02/call, status unknown (last checked 2026-09-15).

Returns live electricity prices, carbon intensity, grid load, renewable share, flexibility windows, battery arbitrage signals, trading signals, and ESG reporting in a single bundled response for autonomous energy agents.

## Facts

- Endpoint: POST https://energy.netzhandwerker.de/bundle/trading
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/netzhandwerker-energy-research-hub-trading-bundle-45a92b84
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_8-x8ILHs71b9WrTxIM3nz

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-energy-research-hub-trading-bundle-45a92b84 -d '<json body>'
```

Example prompt: Pull the full trading bundle from Netzhandwerker right now — I need live electricity prices, carbon intensity, current grid load, renewable share, any active flexibility windows, and battery arbitrage signals so I can decide whether to dispatch my storage assets.

## When to prefer this

Use this endpoint when you need a comprehensive, multi-signal energy market snapshot in one call — especially for autonomous agents managing battery storage dispatch, energy trading decisions, or ESG compliance reporting. Prefer this over single-signal endpoints when you need trading signals, carbon intensity, and pricing data together without multiple round-trips.

## Known failure modes

- Invalid or missing 'query' field returns a 400 validation error
- Payment not included or insufficient USDC triggers a 402 Payment Required response
- Unsupported source in 'sources' array returns an error or is silently ignored
- Upstream energy data provider outage may return stale or partial data
- Rate limiting may apply if too many requests are made in quick succession

## 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 bundled JSON response containing real-time electricity spot prices, carbon intensity metrics, current grid load levels, renewable energy share percentages, identified flexibility/demand-response windows, battery arbitrage opportunity signals, energy trading signals, and ESG reporting data — all aggregated in a single call.

## 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",
     "required": [
      "query"
     ],
     "properties": {
      "query": {
       "type": "string",
       "minLength": 1
      },
      "sources": {
       "type": "array",
       "items": {
        "type": "string"
       }
      }
     },
     "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": {
  "ok": true,
  "result": {
   "bundle": "trading-premium",
   "summary": "Eight-source live trading analysis with key metrics, market insights and raw evidence.",
   "key_metrics": [
    {
     "unit": "ct/kWh",
     "label": "EPEX spot price",
     "value": "15.91"
    }
   ],
   "market_insights": [
    "High daily volatility creates battery arbitrage potential."
   ],
   "data_sources_used": [
    "awattar_de",
    "fraunhofer_ise",
    "smard",
    "entsoe_day_ahead"
   ],
   "raw_data_included": true
  },
  "endpoint": "/bundle/trading"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/netzhandwerker-energy-research-hub-trading-bundle-45a92b84/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)