# Netzhandwerker Energy Research Hub – Quick Query

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

Answers natural-language energy queries with live electricity prices, carbon intensity, grid load, renewable share, flexibility windows, battery arbitrage signals, and ESG data.

## Facts

- Endpoint: POST https://energy.netzhandwerker.de/research/quick
- Price: $0.003/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-quick-query-0b485513
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_OnGeVpnNtw-T9p7vtKSuM

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-quick-query-0b485513 -d '<json body>'
```

Example prompt: What are the current electricity prices and carbon intensity right now, and tell me if there are any battery arbitrage or flexibility windows I should know about in the German energy market?

## When to prefer this

Use this endpoint when an agent needs real-time or near-real-time European electricity market intelligence — especially for carbon-aware scheduling, battery storage arbitrage, demand flexibility optimization, or ESG reporting — and prefers a natural language interface over structured parameter APIs.

## Known failure modes

- Missing required 'query' field returns a 400 validation error
- Ambiguous or unsupported query topics may return empty or partial results
- Payment failure (x402) blocks access if USDC balance is insufficient
- External data source unavailability may cause stale or incomplete data
- Rate limiting may occur under high query volume

## 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 structured energy intelligence data including live electricity prices, carbon intensity readings, grid load levels, renewable energy share percentage, identified flexibility windows, battery arbitrage opportunities, trading signals, and ESG-relevant metrics — all derived from the submitted natural language query.

## 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": {
  "query": "Summarize the German electricity market for the next 24 hours.",
  "source": "EPEX (aWATTar)",
  "timestamp": "2026-07-13T22:51:16.972Z",
  "current_price": {
   "end": "2026-07-13T23:00:00.000Z",
   "start": "2026-07-13T22:00:00.000Z",
   "price_ct_kwh": "13.96",
   "price_eur_mwh": 139.64
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/netzhandwerker-energy-research-hub-quick-query-0b485513/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)