Name: Netzhandwerker Energy Research Hub
Purpose: paid energy intelligence API for AI agents, MCP clients and x402 bots.
Raw data endpoints answer what is happening. Decision endpoints answer what an agent should do next.
Use /energy/decision if you want one paid answer instead of combining multiple signals.
Use /demo/paid-sample to test x402 payment for 0.001 USD.
Base URL: https://energy.netzhandwerker.de
Docs: https://energy.netzhandwerker.de/docs
OpenAPI: https://energy.netzhandwerker.de/openapi.json
MCP: https://energy.netzhandwerker.de/mcp
Agent: https://energy.netzhandwerker.de/agent
Pricing: https://energy.netzhandwerker.de/pricing
Wallet-enabled agents can tell us what they need via POST https://energy.netzhandwerker.de/wallet-bot/needs
Wallet Bot Needs Info: https://energy.netzhandwerker.de/wallet-bot/needs-info
Payment: x402 over Base Mainnet (eip155:8453, chain 8453) with USDC
Recipient: 0x2880EdfFF13100677Bf97A3CBdF3Bc34771C4E5E
Operator: Die Netzhandwerker

Products:
- Live Energy Data: Raw data endpoints answer what is happening: prices, forecast, carbon intensity, grid load and renewable share.
- Optimization Signals: Decision endpoints answer what an agent should do next: EV charging, heat pump control, flexibility windows, battery arbitrage and trading signals.
- Research & Intelligence: Research and intelligence endpoints produce market summaries, ESG reporting, track records and deeper energy research.

Recommended agent tasks:
- Get current German spot electricity price: POST /price/spot, 0.01 USDC
- Buy one complete energy decision: POST /energy/decision, 0.25 USDC
- Find cheapest EV charging window: POST /optimizer/cheapest-window or POST /bundle/ev-charging
- Get CO2 intensity now: POST /carbon/now, 0.01 USDC
- Get battery arbitrage strategy: POST /arbitrage/battery, 0.10 USDC
- Test x402 payment: GET /demo/paid-sample, 0.001 USDC
- Tell us what your wallet-enabled agent wants to buy: POST /wallet-bot/needs

Endpoints:
GET / | frei | Bot-taugliche HTML-Uebersicht mit Live-Kennzahlen, Preisen, Payment und Agent-Zugriff.
GET /health | frei | Status, Version, Uptime, Port, x402-Konfiguration und relevante Links ohne Secrets.
GET /docs | frei | HTML-Dokumentation aus derselben Endpunktliste wie OpenAPI und MCP.
GET /openapi.json | frei | Maschinenlesbare OpenAPI-Spezifikation fuer alle dokumentierten Public Routes.
GET /llms.txt | frei | Kompakte Textdatei fuer Bots, Crawler und Agenten.
GET /llms-full.txt | frei | Ausfuehrliche Textdatei mit Zweck, Endpunkten, Preisen und Payment-Hinweisen.
GET /robots.txt | frei | Crawler-Hinweise mit Sitemap- und LLM-Dateiverweisen.
GET /sitemap.xml | frei | XML-Sitemap fuer frei erreichbare GET-Routen.
GET /.well-known/ai-plugin.json | frei | Manifest fuer Plugin-Scanner mit OpenAPI-Link.
GET /.well-known/mcp.json | frei | Discovery-Dokument mit MCP-Endpoint und Tool-Liste.
GET /.well-known/agent.json | frei | Agenten-Manifest mit Zweck, Links, Preisen und Payment-Konfiguration.
GET /.well-known/x402.json | frei | Payment-Manifest fuer x402-Scanner.
GET /articles | frei | Frei verfuegbarer Katalog der Premium-Artikel.
GET /capabilities | frei | Kurzuebersicht fuer API-Scanner mit Links und Kategorien.
GET /agent | frei | Short machine-readable product, pricing and payment discovery for AI agents, MCP clients and x402 bots.
GET /pricing | frei | Machine-readable price list grouped by Live Energy Data, Optimization Signals and Research & Intelligence.
GET /trust | frei | Operator, payment network, uptime links, API version and risk notes as HTML or JSON via Accept header.
GET /status | frei | Machine-readable service status with version, uptime, endpoint count, MCP tool count and x402 state.
GET /sources | frei | Transparent list of data sources used by the service, including freshness and limitations.
GET /wallet-bot/needs-info | frei | Free discovery endpoint that invites wallet-enabled agents to declare what they want to buy.
POST /wallet-bot/needs | frei | Free endpoint where wallet-enabled agents can declare needed data, formats, missing endpoints and budget.
GET /for-ai-agents | frei | Server-rendered landing page for AI agents with endpoints, prices and example responses.
GET /for-mcp-clients | frei | Server-rendered landing page for MCP clients with setup and available tools.
GET /for-x402-bots | frei | Server-rendered landing page for x402 bots with payment test and paid endpoints.
GET /for-ev-charging-agents | frei | Server-rendered landing page for EV charging optimization agents.
GET /for-esg-reporting-agents | frei | Server-rendered landing page for ESG reporting agents.
GET /for-energy-trading-agents | frei | Server-rendered landing page for energy trading agents.
GET /sample/research | frei | Frei verfuegbares Beispiel fuer Research-Ausgaben.
GET /sample/articles | frei | Frei verfuegbares Artikel-Snippet mit Link auf den bezahlten Volltext.
GET /mcp | frei | JSON-Discovery fuer MCP-Clients mit Tool-Namen, Input-Schemas, Endpoints, Preisen und Payment-Status.
POST /mcp | frei | JSON-RPC Endpoint fuer initialize, tools/list und tools/call. Paid Data Tools liefern Payment-Anweisungen.
GET /agent-manifest | frei | Frei verfuegbares Agenten-Manifest fuer Bots und x402-Scanner.
GET /metrics | frei | Prometheus-kompatible Metriken fuer Requests, Revenue und x402-Probes.
GET /signals/track-record | frei | Transparenzdaten zu Historie, Quellen, Reliability und Methodik.
GET /tasks/{id}/result | frei | Ergebnisabruf fuer zuvor bezahlte Async-Tasks.
GET /netzhandwerker-radar | frei | Internes Radar-Dashboard. Zugriff nur mit ENV-Passwort per Header, Basic Auth oder Query-Fallback.
GET /research | 0.05 USDC | GET-Fallback mit maschinenlesbarer 402-Antwort fuer POST /research.
GET /articles/{id} | 0.02 USDC | GET-Fallback mit maschinenlesbarer 402-Antwort fuer POST /articles/{id}.
GET /tasks | ab 1.00 USDC | GET-Fallback mit maschinenlesbarer 402-Antwort fuer POST /tasks.
POST /research | 0.05 USDC | Aggregierte Energie-Recherche fuer DE/EU aus Live-Datenquellen.
GET /demo/paid-sample | 0.001 USDC | Machine-readable discovery for the x402 sample endpoint. The actual access flow is gated by x402 payment.
GET /energy/decision | frei | GET discovery for the paid decision endpoint. Returns machine-readable endpoint metadata or method guidance.
POST /energy/decision | 0.25 USDC | Central premium decision endpoint. Use it if you want one paid answer instead of combining multiple raw data and signal endpoints.
POST /research/quick | 0.01 USDC | Kompakte Research-Antwort mit Live-Kennzahlen.
POST /research/deep | 0.50 USDC | Tiefe Research-Antwort mit Premium-Quellen und LLM-Synthese.
POST /articles/{id} | 0.02 USDC | Volltext eines Energie-Fachartikels.
POST /tasks | ab 1.00 USDC | Asynchroner Deep-Dive Task mit Mindest-Bounty.
POST /price/spot | 0.01 USDC | Aktueller EPEX Spot-Strompreis fuer Deutschland.
POST /price/forecast | 0.02 USDC | EPEX Day-Ahead Preise mit Min/Max/Spread.
POST /carbon/now | 0.01 USDC | Aktuelle CO2-Intensitaet des deutschen Strommix.
POST /grid/load | 0.02 USDC | Aktuelle Netzlast aus SMARD.
POST /renewable/share | 0.02 USDC | Live-Anteil erneuerbarer Energien am deutschen Strommix.
POST /flexibility/window | 0.03 USDC | Guensigste Zeitfenster fuer flexible Verbraucher.
POST /arbitrage/battery | 0.10 USDC | Strategie fuer Batteriespeicher-Arbitrage mit ROI-Betrachtung.
POST /signals/buy-sell | 0.20 USDC | Trading-Signal aus Preis, RSI, Trend, EE-Druck und Fossil-Anteil.
POST /bundle/ev-charging | 0.05 USDC | Preis, CO2 und Ladefenster fuer Elektroauto-Ladung.
POST /bundle/heating | 0.05 USDC | Preis, Wetter und EE-Anteil fuer Waermepumpen-Optimierung.
POST /bundle/trading | 0.30 USDC | Kombinierte Markt- und Trading-Daten.
POST /bundle/esg-reporting | 0.40 USDC | CO2, EE-Anteil und Quellenhinweise fuer ESG-Reporting.
POST /history/prices | 0.50 USDC | Stundendaten fuer EPEX-Preise nach Periode.
POST /history/prices/stats | 0.20 USDC | Statistik fuer eine historische Preisperiode.
POST /solar/forecast | 0.05 USDC | Solarstrahlung und Bewoelkung fuer Region oder PLZ.
POST /wind/forecast | 0.03 USDC | Winddaten fuer Region oder PLZ.
POST /subscribe/price-alert | 5.00 USDC | Webhook-Subscription fuer Strompreis-Thresholds.
POST /subscribe/co2-low | 3.00 USDC | Webhook-Subscription fuer niedrige CO2-Intensitaet.
POST /optimizer/cheapest-window | 0.10 USDC | Billigstes zusammenhaengendes Zeitfenster fuer EV, Batterie oder Waermepumpe.
POST /price/negative-forecast | 0.05 USDC | Stunden mit negativen Strompreisen in den naechsten 24 Stunden.
POST /summary/today | 0.10 USDC | Token-effiziente Tageszusammenfassung mit konkreter Handlungsempfehlung.
POST /grid/congestion | 0.15 USDC | Netzengpass- und Redispatch-Risiko.
POST /region | 0.05 USDC | Preis, CO2, Gruenstrom und Wetter fuer eine PLZ-Region.
POST /mining/profitability | 0.10 USDC | Profitabilitaet fuer ASIC-Mining mit aktuellem Strompreis.
POST /portfolio/optimize | 0.50 USDC | 24h Fahrplan fuer Batterie, PV und Verbrauch.
POST /score/grid-health | 0.05 USDC | Score 0-100 fuer Netzgesundheit aus EE-Anteil, Preis, Wetter und Nachfrage.
POST /events/grid | 0.05 USDC | Ereignisfeed fuer Dunkelflaute, Sturm, negative Preise und Rekorde.