# Netzhandwerker Price Alert Subscription

> Netzhandwerker Price Alert Subscription is a paid API for AI agents from energy.netzhandwerker.de, paid per call via x402, $0.1/call, status unknown (last checked 2026-09-15).

Subscribes a webhook URL to receive alerts when electricity prices or carbon intensity cross user-defined thresholds

## Facts

- Endpoint: POST https://energy.netzhandwerker.de/subscribe/price-alert
- Price: $0.1/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/netzhandwerker-price-alert-subscription-ae5e5706
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Bys4yevLgGfprUWS8zY8k

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-price-alert-subscription-ae5e5706 -d '<json body>'
```

Example prompt: Set up a price alert on Netzhandwerker so that my webhook at https://myserver.com/energy-hook gets called whenever the electricity price drops below 5 ct/kWh — direction should be 'below'.

## When to prefer this

Use this endpoint when you need event-driven, asynchronous notifications about electricity price or carbon intensity crossing thresholds, rather than polling for current values. Ideal for automating battery charging, demand-response workflows, or ESG reporting triggers that need to react to grid conditions in real time.

## Known failure modes

- Missing webhook_url returns 400 Bad Request
- Invalid webhook URL format causes subscription failure
- Conflicting or duplicate threshold subscriptions may be rejected
- Threshold values out of realistic range may return validation error
- Webhook URL unreachable at time of trigger results in failed delivery (silent)

## 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

A subscription is created that will POST to the specified webhook URL whenever electricity price or carbon intensity crosses the defined threshold in the specified direction. The agent receives a confirmation of the alert subscription setup.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "webhook_url"
 ],
 "properties": {
  "direction": {
   "type": "string"
  },
  "webhook_url": {
   "type": "string"
  },
  "threshold_g_kwh": {
   "type": "number"
  },
  "threshold_ct_kwh": {
   "type": "number"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/netzhandwerker-price-alert-subscription-ae5e5706/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)