# Netzhandwerker Portfolio Optimizer

> Netzhandwerker Portfolio Optimizer is a paid API for AI agents from energy.netzhandwerker.de, paid per call via x402, $0.05/call, status unknown (last checked 2026-09-14).

Optimizes a home energy portfolio (solar PV + battery + consumption) returning trading signals, flexibility windows, and arbitrage recommendations based on live grid data.

## Facts

- Endpoint: POST https://energy.netzhandwerker.de/portfolio/optimize
- Price: $0.05/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/netzhandwerker-portfolio-optimizer-76d1d25d
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_MozFIHOacs-KWTAASXGc-

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-portfolio-optimizer-76d1d25d -d '<json body>'
```

Example prompt: Optimize my home energy portfolio — I have a 8 kWp solar array, a 10 kWh battery, and my daily consumption is about 15 kWh. Tell me the best charge/discharge windows and any arbitrage opportunities right now.

## When to prefer this

Use this endpoint when you need actionable battery arbitrage signals and charge/discharge scheduling for a specific home energy portfolio with known PV capacity, battery size, and consumption. Prefer this over generic electricity price lookups when you need a personalized optimization plan rather than raw market data.

## Known failure modes

- Missing required fields (pv_kwp, battery_kwh, daily_consumption_kwh) return 400 validation error
- Payment failure or insufficient USDC balance returns 402 Payment Required
- Grid data temporarily unavailable returns 503 or stale data warning
- Invalid numeric values (negative kWh) return 422 unprocessable entity
- Rate limiting may return 429 if called too frequently

## How this service works

Live electricity prices, carbon intensity, grid load, renewable share, flexibility windows, battery arbitrage, trading signals and ESG reporting for autonomous agents.

## Output

Returns a computed optimization plan including recommended charge and discharge windows, battery arbitrage signals, current electricity prices, carbon intensity, grid load, renewable share, flexibility windows, and ESG reporting data for the given home energy setup.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "pv_kwp": {
   "type": "number"
  },
  "battery_kwh": {
   "type": "number"
  },
  "daily_consumption_kwh": {
   "type": "number"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/netzhandwerker-portfolio-optimizer-76d1d25d/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)