# Netzhandwerker Dispatch Plan API

> Netzhandwerker Dispatch Plan API 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-14).

Schedules a deadline-bound compute, DePIN, battery, or power-trading workload into an optimal German or European power window, returning exact timing, EUR cost/savings, uncertainty, and decision trace.

## Facts

- Endpoint: POST https://energy.netzhandwerker.de/v3/dispatch-plan
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/netzhandwerker-dispatch-plan-api-02d162f7
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Vr0YXRW5fJPZEnV1tFCvj

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-dispatch-plan-api-02d162f7 -d '<json body>'
```

Example prompt: I need to run a 50 kW GPU compute job in Germany that must finish by tomorrow at 6am — can you find the cheapest power window for it, including the expected EUR cost, savings, and how confident you are in the forecast?

## When to prefer this

Choose this endpoint when you need an actionable, deadline-bound dispatch schedule for energy-flexible workloads (compute, DePIN, battery, power trading) specifically within the German or broader European electricity market, and you need an explicit EUR cost/savings estimate with uncertainty and a decision trace. Prefer this over generic energy price lookup endpoints when you need a full scheduling recommendation rather than raw price data.

## Known failure modes

- Deadline too tight — no feasible window exists within the constraint
- Grid zone not supported — location outside German/EU coverage
- Insufficient flexibility — workload cannot be shifted given duration vs deadline
- Stale market data — freshness timestamp indicates data too old for reliable forecast
- Invalid power requirement — kW value out of accepted range
- Payment failure — x402 micropayment not confirmed

## How this service works

Find actionable German and European power windows. Buy exact dispatch timing, expected EUR savings, uncertainty, freshness and expiry with USDC on Base.

## Output

Returns a structured dispatch plan including: the exact recommended start and end time window, expected EUR cost for the workload, expected EUR savings versus baseline, uncertainty/confidence score, data freshness timestamp, plan expiry time, and a full decision trace explaining why the window was chosen.

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "action": "schedule",
  "confidence": 0.95,
  "expires_at": "2026-07-30T10:15:00.000Z",
  "risk_flags": [],
  "uncertainty": {
   "type": "deterministic_day_ahead_market_data",
   "forecast_signal": "experimental_not_used_for_schedule",
   "price_range_eur_mwh": [
    82.4,
    82.4
   ]
  },
  "schedule_end": "2026-07-31T03:00:00.000Z",
  "model_version": "dispatch-deterministic-3.0.0",
  "decision_trace": [
   "constraints_validated",
   "candidate_windows_ranked",
   "lowest_cost_feasible_window_selected"
  ],
  "schedule_start": "2026-07-31T01:00:00.000Z",
  "payment_receipt": {
   "network": "eip155:8453",
   "protocol": "x402",
   "idempotent_replay": false
  },
  "baseline_cost_eur": 5.5,
  "expected_cost_eur": 4.12,
  "source_timestamps": {
   "fetched_at": "2026-07-30T09:45:00.000Z",
   "last_available": "2026-07-31T22:00:00.000Z",
   "first_available": "2026-07-30T10:00:00.000Z",
   "observed_through": "2026-07-31T22:00:00.000Z"
  },
  "source_attribution": {
   "licence": "CC BY 4.0",
   "attribution": "ENTSO-E Transparency Platform",
   "licence_scope": "A44 day-ahead prices; DE-LU; preflight"
  },
  "expected_savings_eur": 1.38,
  "expected_carbon_effect": "unknown"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/netzhandwerker-dispatch-plan-api-02d162f7/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)