{"name":"Netzhandwerker Energy Research Hub","operator":"Die Netzhandwerker","description":"Paid energy intelligence API for AI agents, MCP clients and x402 bots.","purpose":"live electricity prices, carbon intensity, grid load, renewable share, flexibility windows, battery arbitrage, trading signals, ESG reporting","best_for":["German electricity prices","CO2 grid intensity","renewable energy share","EV charging decisions","battery arbitrage","energy market research","ESG reporting"],"products":[{"name":"Live Energy Data","description":"Raw data endpoints answer what is happening: prices, forecast, carbon intensity, grid load and renewable share.","endpoints":["/price/spot","/price/forecast","/carbon/now","/grid/load","/renewable/share"]},{"name":"Optimization Signals","description":"Decision endpoints answer what an agent should do next: EV charging, heat pump control, flexibility windows, battery arbitrage and trading signals.","endpoints":["/energy/decision","/optimizer/cheapest-window","/bundle/ev-charging","/bundle/heating","/flexibility/window","/arbitrage/battery","/signals/buy-sell","/summary/today"]},{"name":"Research & Intelligence","description":"Research and intelligence endpoints produce market summaries, ESG reporting, track records and deeper energy research.","endpoints":["/research/quick","/research","/research/deep","/bundle/esg-reporting","/bundle/trading","/signals/track-record","/articles/{id}","/tasks"]}],"free_endpoints":["/","/health","/docs","/openapi.json","/llms.txt","/llms-full.txt","/robots.txt","/sitemap.xml","/.well-known/ai-plugin.json","/.well-known/mcp.json","/.well-known/agent.json","/.well-known/x402.json","/articles","/capabilities","/agent","/pricing","/trust","/status","/sources","/wallet-bot/needs-info","/wallet-bot/needs","/for-ai-agents","/for-mcp-clients","/for-x402-bots","/for-ev-charging-agents","/for-esg-reporting-agents","/for-energy-trading-agents","/sample/research","/sample/articles","/mcp","/mcp","/agent-manifest","/metrics","/signals/track-record","/tasks/{id}/result","/netzhandwerker-radar","/energy/decision"],"paid_endpoints":[{"path":"/research","method":"GET","product_group":"Research & Intelligence","price":"0.05","currency":"USD","payment":"x402","network":"base","asset":"USDC","description":"GET-Fallback mit maschinenlesbarer 402-Antwort fuer POST /research."},{"path":"/articles/{id}","method":"GET","product_group":"Research & Intelligence","price":"0.02","currency":"USD","payment":"x402","network":"base","asset":"USDC","description":"GET-Fallback mit maschinenlesbarer 402-Antwort fuer POST /articles/{id}."},{"path":"/tasks","method":"GET","product_group":"Research & Intelligence","price":"1.00","currency":"USD","payment":"x402","network":"base","asset":"USDC","description":"GET-Fallback mit maschinenlesbarer 402-Antwort fuer POST /tasks."},{"path":"/research","method":"POST","product_group":"Research & Intelligence","price":"0.05","currency":"USD","payment":"x402","network":"base","asset":"USDC","description":"Aggregierte Energie-Recherche fuer DE/EU aus Live-Datenquellen."},{"path":"/demo/paid-sample","method":"GET","product_group":"Optimization Signals","price":"0.001","currency":"USD","payment":"x402","network":"base","asset":"USDC","description":"Machine-readable discovery for the x402 sample endpoint. The actual access flow is gated by x402 payment."},{"path":"/energy/decision","method":"POST","product_group":"Optimization Signals","price":"0.25","currency":"USD","payment":"x402","network":"base","asset":"USDC","description":"Central premium decision endpoint. Use it if you want one paid answer instead of combining multiple raw data and signal endpoints."},{"path":"/research/quick","method":"POST","product_group":"Research & Intelligence","price":"0.01","currency":"USD","payment":"x402","network":"base","asset":"USDC","description":"Kompakte Research-Antwort mit Live-Kennzahlen."},{"path":"/research/deep","method":"POST","product_group":"Research & Intelligence","price":"0.50","currency":"USD","payment":"x402","network":"base","asset":"USDC","description":"Tiefe Research-Antwort mit Premium-Quellen und LLM-Synthese."},{"path":"/articles/{id}","method":"POST","product_group":"Research & Intelligence","price":"0.02","currency":"USD","payment":"x402","network":"base","asset":"USDC","description":"Volltext eines Energie-Fachartikels."},{"path":"/tasks","method":"POST","product_group":"Research & Intelligence","price":"1.00","currency":"USD","payment":"x402","network":"base","asset":"USDC","description":"Asynchroner Deep-Dive Task mit Mindest-Bounty."},{"path":"/price/spot","method":"POST","product_group":"Live Energy Data","price":"0.01","currency":"USD","payment":"x402","network":"base","asset":"USDC","description":"Aktueller EPEX Spot-Strompreis fuer Deutschland."},{"path":"/price/forecast","method":"POST","product_group":"Live Energy Data","price":"0.02","currency":"USD","payment":"x402","network":"base","asset":"USDC","description":"EPEX Day-Ahead Preise mit Min/Max/Spread."},{"path":"/carbon/now","method":"POST","product_group":"Live Energy Data","price":"0.01","currency":"USD","payment":"x402","network":"base","asset":"USDC","description":"Aktuelle CO2-Intensitaet des deutschen Strommix."},{"path":"/grid/load","method":"POST","product_group":"Live Energy Data","price":"0.02","currency":"USD","payment":"x402","network":"base","asset":"USDC","description":"Aktuelle Netzlast aus SMARD."},{"path":"/renewable/share","method":"POST","product_group":"Live Energy Data","price":"0.02","currency":"USD","payment":"x402","network":"base","asset":"USDC","description":"Live-Anteil erneuerbarer Energien am deutschen Strommix."},{"path":"/flexibility/window","method":"POST","product_group":"Optimization Signals","price":"0.03","currency":"USD","payment":"x402","network":"base","asset":"USDC","description":"Guensigste Zeitfenster fuer flexible Verbraucher."},{"path":"/arbitrage/battery","method":"POST","product_group":"Optimization Signals","price":"0.10","currency":"USD","payment":"x402","network":"base","asset":"USDC","description":"Strategie fuer Batteriespeicher-Arbitrage mit ROI-Betrachtung."},{"path":"/signals/buy-sell","method":"POST","product_group":"Optimization Signals","price":"0.20","currency":"USD","payment":"x402","network":"base","asset":"USDC","description":"Trading-Signal aus Preis, RSI, Trend, EE-Druck und Fossil-Anteil."},{"path":"/bundle/ev-charging","method":"POST","product_group":"Optimization Signals","price":"0.05","currency":"USD","payment":"x402","network":"base","asset":"USDC","description":"Preis, CO2 und Ladefenster fuer Elektroauto-Ladung."},{"path":"/bundle/heating","method":"POST","product_group":"Optimization Signals","price":"0.05","currency":"USD","payment":"x402","network":"base","asset":"USDC","description":"Preis, Wetter und EE-Anteil fuer Waermepumpen-Optimierung."},{"path":"/bundle/trading","method":"POST","product_group":"Research & Intelligence","price":"0.30","currency":"USD","payment":"x402","network":"base","asset":"USDC","description":"Kombinierte Markt- und Trading-Daten."},{"path":"/bundle/esg-reporting","method":"POST","product_group":"Research & Intelligence","price":"0.40","currency":"USD","payment":"x402","network":"base","asset":"USDC","description":"CO2, EE-Anteil und Quellenhinweise fuer ESG-Reporting."},{"path":"/history/prices","method":"POST","product_group":"Research & Intelligence","price":"0.50","currency":"USD","payment":"x402","network":"base","asset":"USDC","description":"Stundendaten fuer EPEX-Preise nach Periode."},{"path":"/history/prices/stats","method":"POST","product_group":"Research & Intelligence","price":"0.20","currency":"USD","payment":"x402","network":"base","asset":"USDC","description":"Statistik fuer eine historische Preisperiode."},{"path":"/solar/forecast","method":"POST","product_group":"Optimization Signals","price":"0.05","currency":"USD","payment":"x402","network":"base","asset":"USDC","description":"Solarstrahlung und Bewoelkung fuer Region oder PLZ."},{"path":"/wind/forecast","method":"POST","product_group":"Optimization Signals","price":"0.03","currency":"USD","payment":"x402","network":"base","asset":"USDC","description":"Winddaten fuer Region oder PLZ."},{"path":"/subscribe/price-alert","method":"POST","product_group":"Subscriptions","price":"5.00","currency":"USD","payment":"x402","network":"base","asset":"USDC","description":"Webhook-Subscription fuer Strompreis-Thresholds."},{"path":"/subscribe/co2-low","method":"POST","product_group":"Subscriptions","price":"3.00","currency":"USD","payment":"x402","network":"base","asset":"USDC","description":"Webhook-Subscription fuer niedrige CO2-Intensitaet."},{"path":"/optimizer/cheapest-window","method":"POST","product_group":"Optimization Signals","price":"0.10","currency":"USD","payment":"x402","network":"base","asset":"USDC","description":"Billigstes zusammenhaengendes Zeitfenster fuer EV, Batterie oder Waermepumpe."},{"path":"/price/negative-forecast","method":"POST","product_group":"Optimization Signals","price":"0.05","currency":"USD","payment":"x402","network":"base","asset":"USDC","description":"Stunden mit negativen Strompreisen in den naechsten 24 Stunden."},{"path":"/summary/today","method":"POST","product_group":"Optimization Signals","price":"0.10","currency":"USD","payment":"x402","network":"base","asset":"USDC","description":"Token-effiziente Tageszusammenfassung mit konkreter Handlungsempfehlung."},{"path":"/grid/congestion","method":"POST","product_group":"Optimization Signals","price":"0.15","currency":"USD","payment":"x402","network":"base","asset":"USDC","description":"Netzengpass- und Redispatch-Risiko."},{"path":"/region","method":"POST","product_group":"Optimization Signals","price":"0.05","currency":"USD","payment":"x402","network":"base","asset":"USDC","description":"Preis, CO2, Gruenstrom und Wetter fuer eine PLZ-Region."},{"path":"/mining/profitability","method":"POST","product_group":"Optimization Signals","price":"0.10","currency":"USD","payment":"x402","network":"base","asset":"USDC","description":"Profitabilitaet fuer ASIC-Mining mit aktuellem Strompreis."},{"path":"/portfolio/optimize","method":"POST","product_group":"Optimization Signals","price":"0.50","currency":"USD","payment":"x402","network":"base","asset":"USDC","description":"24h Fahrplan fuer Batterie, PV und Verbrauch."},{"path":"/score/grid-health","method":"POST","product_group":"Optimization Signals","price":"0.05","currency":"USD","payment":"x402","network":"base","asset":"USDC","description":"Score 0-100 fuer Netzgesundheit aus EE-Anteil, Preis, Wetter und Nachfrage."},{"path":"/events/grid","method":"POST","product_group":"Optimization Signals","price":"0.05","currency":"USD","payment":"x402","network":"base","asset":"USDC","description":"Ereignisfeed fuer Dunkelflaute, Sturm, negative Preise und Rekorde."}],"payment":{"protocol":"x402","network":"Base Mainnet","network_id":"eip155:8453","chain_id":8453,"asset":"USDC","asset_address":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","recipient":"0x2880EdfFF13100677Bf97A3CBdF3Bc34771C4E5E"},"links":{"docs":"https://energy.netzhandwerker.de/docs","openapi":"https://energy.netzhandwerker.de/openapi.json","mcp":"https://energy.netzhandwerker.de/mcp","pricing":"https://energy.netzhandwerker.de/pricing","trust":"https://energy.netzhandwerker.de/trust","sources":"https://energy.netzhandwerker.de/sources","paid_sample":"https://energy.netzhandwerker.de/demo/paid-sample","energy_decision":"https://energy.netzhandwerker.de/energy/decision","wallet_bot_needs_info":"https://energy.netzhandwerker.de/wallet-bot/needs-info","submit_wallet_bot_need":"https://energy.netzhandwerker.de/wallet-bot/needs"},"wallet_bot_need_request":{"question":"What does your wallet-enabled agent need from this energy API?","submit":{"method":"POST","endpoint":"/wallet-bot/needs","content_type":"application/json"},"examples":["I need live EPEX prices for Germany every hour.","I need a battery arbitrage schedule.","I need CO2-low charging windows.","I need Redispatch risk by region.","I need webhook alerts for negative prices."],"optional_fields":["wallet_type","payment_network","max_budget_usdc","desired_output_format","recurring_need"]},"contact":"info@netzhandwerker.de","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","llms":"https://energy.netzhandwerker.de/llms.txt","llms_full":"https://energy.netzhandwerker.de/llms-full.txt","pricing":{"currency":"USDC","lowest_paid_endpoints":[{"method":"POST","path":"/price/spot","price":"0.01 USDC"},{"method":"POST","path":"/carbon/now","price":"0.01 USDC"},{"method":"POST","path":"/renewable/share","price":"0.02 USDC"}]},"endpoints":[{"method":"GET","path":"/","category":"Human and bot overview","product_group":"Human and bot overview","description":"Bot-taugliche HTML-Uebersicht mit Live-Kennzahlen, Preisen, Payment und Agent-Zugriff.","price":"frei","price_usd":"0","currency":"USD","payment_required":false,"response_example":"<html>Energy Research Hub overview</html>","errors":{"400":"Invalid request","404":"Not found","429":"Rate limit exceeded","500":"Internal server error"}},{"method":"GET","path":"/health","category":"Discovery","product_group":"Discovery","description":"Status, Version, Uptime, Port, x402-Konfiguration und relevante Links ohne Secrets.","price":"frei","price_usd":"0","currency":"USD","payment_required":false,"response_example":{"status":"ok","service":"energy-research-hub","version":"1.6.0","network":"Base Mainnet"},"errors":{"400":"Invalid request","404":"Not found","429":"Rate limit exceeded","500":"Internal server error"}},{"method":"GET","path":"/docs","category":"Discovery","product_group":"Discovery","description":"HTML-Dokumentation aus derselben Endpunktliste wie OpenAPI und MCP.","price":"frei","price_usd":"0","currency":"USD","payment_required":false,"response_example":"<html>API docs</html>","errors":{"400":"Invalid request","404":"Not found","429":"Rate limit exceeded","500":"Internal server error"}},{"method":"GET","path":"/openapi.json","category":"Discovery","product_group":"Discovery","description":"Maschinenlesbare OpenAPI-Spezifikation fuer alle dokumentierten Public Routes.","price":"frei","price_usd":"0","currency":"USD","payment_required":false,"response_example":{"openapi":"3.1.0","info":{"title":"Netzhandwerker Energy Research Hub"}},"errors":{"400":"Invalid request","404":"Not found","429":"Rate limit exceeded","500":"Internal server error"}},{"method":"GET","path":"/llms.txt","category":"Discovery","product_group":"Discovery","description":"Kompakte Textdatei fuer Bots, Crawler und Agenten.","price":"frei","price_usd":"0","currency":"USD","payment_required":false,"response_example":"Name: Netzhandwerker Energy Research Hub","errors":{"400":"Invalid request","404":"Not found","429":"Rate limit exceeded","500":"Internal server error"}},{"method":"GET","path":"/llms-full.txt","category":"Discovery","product_group":"Discovery","description":"Ausfuehrliche Textdatei mit Zweck, Endpunkten, Preisen und Payment-Hinweisen.","price":"frei","price_usd":"0","currency":"USD","payment_required":false,"response_example":"Endpoints: ...","errors":{"400":"Invalid request","404":"Not found","429":"Rate limit exceeded","500":"Internal server error"}},{"method":"GET","path":"/robots.txt","category":"Discovery","product_group":"Discovery","description":"Crawler-Hinweise mit Sitemap- und LLM-Dateiverweisen.","price":"frei","price_usd":"0","currency":"USD","payment_required":false,"response_example":"User-agent: *","errors":{"400":"Invalid request","404":"Not found","429":"Rate limit exceeded","500":"Internal server error"}},{"method":"GET","path":"/sitemap.xml","category":"Discovery","product_group":"Discovery","description":"XML-Sitemap fuer frei erreichbare GET-Routen.","price":"frei","price_usd":"0","currency":"USD","payment_required":false,"response_example":"<urlset>...</urlset>","errors":{"400":"Invalid request","404":"Not found","429":"Rate limit exceeded","500":"Internal server error"}},{"method":"GET","path":"/.well-known/ai-plugin.json","category":"Bot Discovery","product_group":"Bot Discovery","description":"Manifest fuer Plugin-Scanner mit OpenAPI-Link.","price":"frei","price_usd":"0","currency":"USD","payment_required":false,"response_example":{"schema_version":"v1","name_for_model":"netzhandwerker_energy_research_hub"},"errors":{"400":"Invalid request","404":"Not found","429":"Rate limit exceeded","500":"Internal server error"}},{"method":"GET","path":"/.well-known/mcp.json","category":"Bot Discovery","product_group":"Bot Discovery","description":"Discovery-Dokument mit MCP-Endpoint und Tool-Liste.","price":"frei","price_usd":"0","currency":"USD","payment_required":false,"response_example":{"endpoint":"https://energy.netzhandwerker.de/mcp","tools":[]},"errors":{"400":"Invalid request","404":"Not found","429":"Rate limit exceeded","500":"Internal server error"}},{"method":"GET","path":"/.well-known/agent.json","category":"Bot Discovery","product_group":"Bot Discovery","description":"Agenten-Manifest mit Zweck, Links, Preisen und Payment-Konfiguration.","price":"frei","price_usd":"0","currency":"USD","payment_required":false,"response_example":{"name":"Netzhandwerker Energy Research Hub","payment":"x402"},"errors":{"400":"Invalid request","404":"Not found","429":"Rate limit exceeded","500":"Internal server error"}},{"method":"GET","path":"/.well-known/x402.json","category":"Bot Discovery","product_group":"Bot Discovery","description":"Payment-Manifest fuer x402-Scanner.","price":"frei","price_usd":"0","currency":"USD","payment_required":false,"response_example":{"payment_target":{"network":"eip155:8453","currency":"USDC"}},"errors":{"400":"Invalid request","404":"Not found","429":"Rate limit exceeded","500":"Internal server error"}},{"method":"GET","path":"/articles","category":"Free data","product_group":"Free data","description":"Frei verfuegbarer Katalog der Premium-Artikel.","price":"frei","price_usd":"0","currency":"USD","payment_required":false,"response_example":{"articles":[{"id":"001","title":"Mieterstrom","price_usdc":"0.02"}]},"errors":{"400":"Invalid request","404":"Not found","429":"Rate limit exceeded","500":"Internal server error"}},{"method":"GET","path":"/capabilities","category":"Discovery","product_group":"Discovery","description":"Kurzuebersicht fuer API-Scanner mit Links und Kategorien.","price":"frei","price_usd":"0","currency":"USD","payment_required":false,"response_example":{"service":"Netzhandwerker Energy Research Hub","capabilities":["live_energy_data","x402_payment","mcp"]},"errors":{"400":"Invalid request","404":"Not found","429":"Rate limit exceeded","500":"Internal server error"}},{"method":"GET","path":"/agent","category":"Bot Discovery","product_group":"Bot Discovery","description":"Short machine-readable product, pricing and payment discovery for AI agents, MCP clients and x402 bots.","price":"frei","price_usd":"0","currency":"USD","payment_required":false,"response_example":{"name":"Netzhandwerker Energy Research Hub","best_for":["German electricity prices","EV charging decisions"],"products":["Live Energy Data","Optimization Signals","Research & Intelligence"]},"errors":{"400":"Invalid request","404":"Not found","429":"Rate limit exceeded","500":"Internal server error"}},{"method":"GET","path":"/pricing","category":"Bot Discovery","product_group":"Bot Discovery","description":"Machine-readable price list grouped by Live Energy Data, Optimization Signals and Research & Intelligence.","price":"frei","price_usd":"0","currency":"USD","payment_required":false,"response_example":{"currency":"USD","payment_protocol":"x402","settlement_asset":"USDC","products":[]},"errors":{"400":"Invalid request","404":"Not found","429":"Rate limit exceeded","500":"Internal server error"}},{"method":"GET","path":"/trust","category":"Trust","product_group":"Trust","description":"Operator, payment network, uptime links, API version and risk notes as HTML or JSON via Accept header.","price":"frei","price_usd":"0","currency":"USD","payment_required":false,"response_example":{"operator":"Die Netzhandwerker","chain_id":8453,"asset":"USDC"},"errors":{"400":"Invalid request","404":"Not found","429":"Rate limit exceeded","500":"Internal server error"}},{"method":"GET","path":"/status","category":"Trust","product_group":"Trust","description":"Machine-readable service status with version, uptime, endpoint count, MCP tool count and x402 state.","price":"frei","price_usd":"0","currency":"USD","payment_required":false,"response_example":{"status":"ok","version":"1.6.0","endpoint_count":0},"errors":{"400":"Invalid request","404":"Not found","429":"Rate limit exceeded","500":"Internal server error"}},{"method":"GET","path":"/sources","category":"Trust","product_group":"Trust","description":"Transparent list of data sources used by the service, including freshness and limitations.","price":"frei","price_usd":"0","currency":"USD","payment_required":false,"response_example":{"sources":[{"name":"aWATTar EPEX DE/AT","type":"live","used_for":["spot prices","price forecast","optimization windows"],"freshness":"Usually hourly/day-ahead; cached by endpoint","limitations":["External API availability","Market data may lag provider updates"]},{"name":"Fraunhofer ISE energy-charts","type":"live/cached","used_for":["renewable share","generation mix","CO2 fallback model"],"freshness":"Cached by endpoint, usually minutes to hours","limitations":["Provider schema changes possible","Some values are modelled from generation mix"]},{"name":"SMARD Bundesnetzagentur","type":"live/cached","used_for":["grid load"],"freshness":"Cached by endpoint","limitations":["Quarter-hour data availability depends on SMARD publication"]},{"name":"Corrently GruenstromIndex","type":"forecast/cached","used_for":["regional green power index","regional CO2 estimate"],"freshness":"Forecast data, cached by endpoint","limitations":["Regional approximation by ZIP"]},{"name":"Open-Meteo","type":"forecast/cached","used_for":["solar forecast","wind forecast","weather-driven optimization"],"freshness":"Forecast data, cached by endpoint","limitations":["Weather forecast uncertainty"]},{"name":"Electricity Maps","type":"live","used_for":["carbon intensity when API key is available"],"freshness":"Provider latest value","limitations":["Requires configured provider key; fallback uses internal CO2 model"]},{"name":"ENTSO-E Transparency","type":"live/forecast","used_for":["day-ahead prices and selected premium research"],"freshness":"Provider publication schedule","limitations":["Requires configured ENTSO-E key"]},{"name":"Internal model","type":"model","used_for":["energy decisions","battery arbitrage","trading signal scoring"],"freshness":"Generated per request from cached/live inputs","limitations":["Decision outputs are estimates, not guarantees"]}]},"errors":{"400":"Invalid request","404":"Not found","429":"Rate limit exceeded","500":"Internal server error"}},{"method":"GET","path":"/wallet-bot/needs-info","category":"Wallet Bot Feedback","product_group":"Wallet Bot Feedback","description":"Free discovery endpoint that invites wallet-enabled agents to declare what they want to buy.","price":"frei","price_usd":"0","currency":"USD","payment_required":false,"response_example":{"ok":true,"purpose":"Tell us what your wallet-enabled agent wants to buy.","submit_need":{"method":"POST","endpoint":"/wallet-bot/needs","content_type":"application/json","schema":{"type":"object","properties":{"agent_name":{"type":"string"},"wallet_type":{"type":"string","enum":["x402","evm","base","solana","lightning","other","unknown"]},"payment_network":{"type":"string"},"payment_asset":{"type":"string"},"need":{"type":"string","description":"What does your wallet-enabled agent want to buy?"},"requested_endpoint":{"type":"string"},"missing_endpoint":{"type":"string"},"desired_output_format":{"type":"string","enum":["json","mcp","openapi","webhook","csv","other"]},"desired_freshness":{"type":"string","enum":["live","hourly","daily","historical","unknown"]},"max_budget_usdc":{"type":"number","minimum":0},"recurring_need":{"type":"boolean"},"urgency":{"type":"string","enum":["low","normal","high"]},"callback_url":{"type":"string","description":"Stored as present/host only; never called automatically."},"notes":{"type":"string"}},"additionalProperties":false}},"wallet_bot_need_request":{"question":"What does your wallet-enabled agent need from this energy API?","submit":{"method":"POST","endpoint":"/wallet-bot/needs","content_type":"application/json"},"examples":["I need live EPEX prices for Germany every hour.","I need a battery arbitrage schedule.","I need CO2-low charging windows.","I need Redispatch risk by region.","I need webhook alerts for negative prices."],"optional_fields":["wallet_type","payment_network","max_budget_usdc","desired_output_format","recurring_need"]},"why":["We use wallet-bot needs to create better paid energy endpoints.","Tell us what data, decision, format or price your agent needs."],"examples":[{"need":"I need a 15-minute EV charging schedule for Germany before 07:00.","recommended_endpoint":"/energy/decision"},{"need":"I need Redispatch risk for NRW in the next 24h.","recommended_endpoint":"/grid/congestion"},{"need":"I need a cheaper payment test endpoint.","recommended_endpoint":"/demo/paid-sample"}]},"errors":{"400":"Invalid request","404":"Not found","429":"Rate limit exceeded","500":"Internal server error"}},{"method":"POST","path":"/wallet-bot/needs","category":"Wallet Bot Feedback","product_group":"Wallet Bot Feedback","description":"Free endpoint where wallet-enabled agents can declare needed data, formats, missing endpoints and budget.","price":"frei","price_usd":"0","currency":"USD","payment_required":false,"response_example":{"ok":true,"need_id":"need_123","recommended_existing_offer":{"endpoint":"/energy/decision","price_usdc":0.25}},"errors":{"400":"Invalid request","404":"Not found","429":"Rate limit exceeded","500":"Internal server error"}},{"method":"GET","path":"/for-ai-agents","category":"Bot Landingpages","product_group":"Bot Landingpages","description":"Server-rendered landing page for AI agents with endpoints, prices and example responses.","price":"frei","price_usd":"0","currency":"USD","payment_required":false,"response_example":"<html>For AI agents</html>","errors":{"400":"Invalid request","404":"Not found","429":"Rate limit exceeded","500":"Internal server error"}},{"method":"GET","path":"/for-mcp-clients","category":"Bot Landingpages","product_group":"Bot Landingpages","description":"Server-rendered landing page for MCP clients with setup and available tools.","price":"frei","price_usd":"0","currency":"USD","payment_required":false,"response_example":"<html>For MCP clients</html>","errors":{"400":"Invalid request","404":"Not found","429":"Rate limit exceeded","500":"Internal server error"}},{"method":"GET","path":"/for-x402-bots","category":"Bot Landingpages","product_group":"Bot Landingpages","description":"Server-rendered landing page for x402 bots with payment test and paid endpoints.","price":"frei","price_usd":"0","currency":"USD","payment_required":false,"response_example":"<html>For x402 bots</html>","errors":{"400":"Invalid request","404":"Not found","429":"Rate limit exceeded","500":"Internal server error"}},{"method":"GET","path":"/for-ev-charging-agents","category":"Bot Landingpages","product_group":"Bot Landingpages","description":"Server-rendered landing page for EV charging optimization agents.","price":"frei","price_usd":"0","currency":"USD","payment_required":false,"response_example":"<html>For EV charging agents</html>","errors":{"400":"Invalid request","404":"Not found","429":"Rate limit exceeded","500":"Internal server error"}},{"method":"GET","path":"/for-esg-reporting-agents","category":"Bot Landingpages","product_group":"Bot Landingpages","description":"Server-rendered landing page for ESG reporting agents.","price":"frei","price_usd":"0","currency":"USD","payment_required":false,"response_example":"<html>For ESG reporting agents</html>","errors":{"400":"Invalid request","404":"Not found","429":"Rate limit exceeded","500":"Internal server error"}},{"method":"GET","path":"/for-energy-trading-agents","category":"Bot Landingpages","product_group":"Bot Landingpages","description":"Server-rendered landing page for energy trading agents.","price":"frei","price_usd":"0","currency":"USD","payment_required":false,"response_example":"<html>For energy trading agents</html>","errors":{"400":"Invalid request","404":"Not found","429":"Rate limit exceeded","500":"Internal server error"}},{"method":"GET","path":"/sample/research","category":"Free data","product_group":"Free data","description":"Frei verfuegbares Beispiel fuer Research-Ausgaben.","price":"frei","price_usd":"0","currency":"USD","payment_required":false,"response_example":{"note":"Frei verfuegbares Beispiel","full_endpoint":"POST /research"},"errors":{"400":"Invalid request","404":"Not found","429":"Rate limit exceeded","500":"Internal server error"}},{"method":"GET","path":"/sample/articles","category":"Free data","product_group":"Free data","description":"Frei verfuegbares Artikel-Snippet mit Link auf den bezahlten Volltext.","price":"frei","price_usd":"0","currency":"USD","payment_required":false,"response_example":{"preview":{"id":"001","title":"Mieterstrom"},"full_endpoint":"POST /articles/{id}"},"errors":{"400":"Invalid request","404":"Not found","429":"Rate limit exceeded","500":"Internal server error"}},{"method":"GET","path":"/mcp","category":"MCP","product_group":"MCP","description":"JSON-Discovery fuer MCP-Clients mit Tool-Namen, Input-Schemas, Endpoints, Preisen und Payment-Status.","price":"frei","price_usd":"0","currency":"USD","payment_required":false,"response_example":{"protocol":"Model Context Protocol","tools_count":32},"errors":{"400":"Invalid request","404":"Not found","429":"Rate limit exceeded","500":"Internal server error"}},{"method":"POST","path":"/mcp","category":"MCP","product_group":"MCP","description":"JSON-RPC Endpoint fuer initialize, tools/list und tools/call. Paid Data Tools liefern Payment-Anweisungen.","price":"frei","price_usd":"0","currency":"USD","payment_required":false,"response_example":{"jsonrpc":"2.0","result":{"tools":[]}},"errors":{"400":"Invalid request","404":"Not found","429":"Rate limit exceeded","500":"Internal server error"}},{"method":"GET","path":"/agent-manifest","category":"Bot Discovery","product_group":"Bot Discovery","description":"Frei verfuegbares Agenten-Manifest fuer Bots und x402-Scanner.","price":"frei","price_usd":"0","currency":"USD","payment_required":false,"response_example":{"name":"Netzhandwerker Energy Research Hub","openapi":"https://energy.netzhandwerker.de/openapi.json"},"errors":{"400":"Invalid request","404":"Not found","429":"Rate limit exceeded","500":"Internal server error"}},{"method":"GET","path":"/metrics","category":"Observability","product_group":"Observability","description":"Prometheus-kompatible Metriken fuer Requests, Revenue und x402-Probes.","price":"frei","price_usd":"0","currency":"USD","payment_required":false,"response_example":"energy_hub_requests_total 123","errors":{"400":"Invalid request","404":"Not found","429":"Rate limit exceeded","500":"Internal server error"}},{"method":"GET","path":"/signals/track-record","category":"Trust","product_group":"Research & Intelligence","description":"Transparenzdaten zu Historie, Quellen, Reliability und Methodik.","price":"frei","price_usd":"0","currency":"USD","payment_required":false,"response_example":{"reliability":{"success_rate_24h":"99.2%","network":"Base Mainnet"}},"errors":{"400":"Invalid request","404":"Not found","429":"Rate limit exceeded","500":"Internal server error"}},{"method":"GET","path":"/tasks/{id}/result","category":"Async Tasks","product_group":"Async Tasks","description":"Ergebnisabruf fuer zuvor bezahlte Async-Tasks.","price":"frei","price_usd":"0","currency":"USD","payment_required":false,"response_example":{"id":"task_123","status":"completed","result":{}},"errors":{"400":"Invalid request","404":"Task not found","429":"Rate limit exceeded","500":"Internal server error"}},{"method":"GET","path":"/netzhandwerker-radar","category":"Protected dashboard","product_group":"Protected dashboard","description":"Internes Radar-Dashboard. Zugriff nur mit ENV-Passwort per Header, Basic Auth oder Query-Fallback.","price":"frei","price_usd":"0","currency":"USD","payment_required":false,"response_example":"<html>Bot-Radar</html>","errors":{"400":"Invalid request","401":"Authentication required","404":"Not found","429":"Rate limit exceeded","500":"Internal server error"}},{"method":"GET","path":"/research","category":"Payment Discovery","product_group":"Research & Intelligence","description":"GET-Fallback mit maschinenlesbarer 402-Antwort fuer POST /research.","price":"0.05 USDC","price_usd":"0.05","currency":"USD","payment_required":true,"response_example":{"error":"payment_required","endpoint":"POST /research"},"errors":{"400":"Invalid request","402":"Payment Required","404":"Not found","429":"Rate limit exceeded","500":"Internal server error"}},{"method":"GET","path":"/articles/{id}","category":"Payment Discovery","product_group":"Research & Intelligence","description":"GET-Fallback mit maschinenlesbarer 402-Antwort fuer POST /articles/{id}.","price":"0.02 USDC","price_usd":"0.02","currency":"USD","payment_required":true,"response_example":{"error":"payment_required","endpoint":"POST /articles/{id}"},"errors":{"400":"Invalid request","402":"Payment Required","404":"Not found","429":"Rate limit exceeded","500":"Internal server error"}},{"method":"GET","path":"/tasks","category":"Payment Discovery","product_group":"Research & Intelligence","description":"GET-Fallback mit maschinenlesbarer 402-Antwort fuer POST /tasks.","price":"ab 1.00 USDC","price_usd":"1.00","currency":"USD","payment_required":true,"response_example":{"error":"payment_required","endpoint":"POST /tasks"},"errors":{"400":"Invalid request","402":"Payment Required","404":"Not found","429":"Rate limit exceeded","500":"Internal server error"}},{"method":"POST","path":"/research","category":"Research","product_group":"Research & Intelligence","description":"Aggregierte Energie-Recherche fuer DE/EU aus Live-Datenquellen.","price":"0.05 USDC","price_usd":"0.05","currency":"USD","payment_required":true,"response_example":{"success":true,"summary":"...","key_metrics":[],"confidence_score":0.9},"errors":{"400":"Invalid request","402":"Payment Required","404":"Not found","429":"Rate limit exceeded","500":"Internal server error"}},{"method":"GET","path":"/demo/paid-sample","category":"Optimization Signals","product_group":"Optimization Signals","description":"Machine-readable discovery for the x402 sample endpoint. The actual access flow is gated by x402 payment.","price":"0.001 USDC","price_usd":"0.001","currency":"USD","payment_required":true,"response_example":{"ok":true,"endpoint":"/demo/paid-sample","payment_required":true,"price_usd":0.001,"asset":"USDC","network":"Base Mainnet","chain_id":8453},"errors":{"400":"Invalid request","402":"Payment Required","404":"Not found","429":"Rate limit exceeded","500":"Internal server error"}},{"method":"GET","path":"/energy/decision","category":"Optimization Signals","product_group":"Optimization Signals","description":"GET discovery for the paid decision endpoint. Returns machine-readable endpoint metadata or method guidance.","price":"frei","price_usd":"0","currency":"USD","payment_required":false,"response_example":{"ok":true,"endpoint":"/energy/decision","method":"POST","payment_required":true,"price_usd":0.25,"asset":"USDC","network":"Base Mainnet","chain_id":8453},"errors":{"400":"Invalid request","404":"Not found","429":"Rate limit exceeded","500":"Internal server error"}},{"method":"POST","path":"/energy/decision","category":"Optimization Signals","product_group":"Optimization Signals","description":"Central premium decision endpoint. Use it if you want one paid answer instead of combining multiple raw data and signal endpoints.","price":"0.25 USDC","price_usd":"0.25","currency":"USD","payment_required":true,"response_example":{"ok":true,"product":"Optimization Signals","endpoint":"/energy/decision","result":{"decision":"charge_later","recommended_window":{"start":"2026-06-18T01:00:00.000Z","end":"2026-06-18T05:00:00.000Z"},"reason":"Estimated cheapest low-carbon window in the requested period.","expected_saving_eur":0,"carbon_reduction_percent":0,"confidence":0.74,"alternatives":[]}},"errors":{"400":"Invalid request","402":"Payment Required","404":"Not found","429":"Rate limit exceeded","500":"Internal server error"}},{"method":"POST","path":"/research/quick","category":"Research","product_group":"Research & Intelligence","description":"Kompakte Research-Antwort mit Live-Kennzahlen.","price":"0.01 USDC","price_usd":"0.01","currency":"USD","payment_required":true,"response_example":{"success":true,"mode":"quick","summary":"..."},"errors":{"400":"Invalid request","402":"Payment Required","404":"Not found","429":"Rate limit exceeded","500":"Internal server error"}},{"method":"POST","path":"/research/deep","category":"Research","product_group":"Research & Intelligence","description":"Tiefe Research-Antwort mit Premium-Quellen und LLM-Synthese.","price":"0.50 USDC","price_usd":"0.50","currency":"USD","payment_required":true,"response_example":{"success":true,"mode":"deep","synthesis":"..."},"errors":{"400":"Invalid request","402":"Payment Required","404":"Not found","429":"Rate limit exceeded","500":"Internal server error"}},{"method":"POST","path":"/articles/{id}","category":"Premium content","product_group":"Research & Intelligence","description":"Volltext eines Energie-Fachartikels.","price":"0.02 USDC","price_usd":"0.02","currency":"USD","payment_required":true,"response_example":{"success":true,"type":"premium_article","article":{}},"errors":{"400":"Invalid request","402":"Payment Required","404":"Article not found","429":"Rate limit exceeded","500":"Internal server error"}},{"method":"POST","path":"/tasks","category":"Async Tasks","product_group":"Research & Intelligence","description":"Asynchroner Deep-Dive Task mit Mindest-Bounty.","price":"ab 1.00 USDC","price_usd":"1.00","currency":"USD","payment_required":true,"response_example":{"success":true,"task_id":"task_123","status":"queued"},"errors":{"400":"Invalid request","402":"Payment Required","404":"Not found","429":"Rate limit exceeded","500":"Internal server error"}},{"method":"POST","path":"/price/spot","category":"Live Energy Data API","product_group":"Live Energy Data","description":"Aktueller EPEX Spot-Strompreis fuer Deutschland.","price":"0.01 USDC","price_usd":"0.01","currency":"USD","payment_required":true,"response_example":{"current_price_ct_kwh":"8.40","source":"EPEX DE/AT (aWATTar)"},"errors":{"400":"Invalid request","402":"Payment Required","404":"Not found","429":"Rate limit exceeded","500":"Internal server error"}},{"method":"POST","path":"/price/forecast","category":"Live Energy Data API","product_group":"Live Energy Data","description":"EPEX Day-Ahead Preise mit Min/Max/Spread.","price":"0.02 USDC","price_usd":"0.02","currency":"USD","payment_required":true,"response_example":{"hours":24,"stats_eur_mwh":{"avg":"92.10","min":"40.20","max":"160.00"}},"errors":{"400":"Invalid request","402":"Payment Required","404":"Not found","429":"Rate limit exceeded","500":"Internal server error"}},{"method":"POST","path":"/carbon/now","category":"Live Energy Data API","product_group":"Live Energy Data","description":"Aktuelle CO2-Intensitaet des deutschen Strommix.","price":"0.01 USDC","price_usd":"0.01","currency":"USD","payment_required":true,"response_example":{"carbon_intensity_g_co2_kwh":310,"classification":"medium"},"errors":{"400":"Invalid request","402":"Payment Required","404":"Not found","429":"Rate limit exceeded","500":"Internal server error"}},{"method":"POST","path":"/grid/load","category":"Live Energy Data API","product_group":"Live Energy Data","description":"Aktuelle Netzlast aus SMARD.","price":"0.02 USDC","price_usd":"0.02","currency":"USD","payment_required":true,"response_example":{"latest_consumption_mwh":57120,"source":"SMARD Bundesnetzagentur"},"errors":{"400":"Invalid request","402":"Payment Required","404":"Not found","429":"Rate limit exceeded","500":"Internal server error"}},{"method":"POST","path":"/renewable/share","category":"Live Energy Data API","product_group":"Live Energy Data","description":"Live-Anteil erneuerbarer Energien am deutschen Strommix.","price":"0.02 USDC","price_usd":"0.02","currency":"USD","payment_required":true,"response_example":{"renewable_share_pct":"48.6","source":"Fraunhofer ISE"},"errors":{"400":"Invalid request","402":"Payment Required","404":"Not found","429":"Rate limit exceeded","500":"Internal server error"}},{"method":"POST","path":"/flexibility/window","category":"Optimization","product_group":"Optimization Signals","description":"Guensigste Zeitfenster fuer flexible Verbraucher.","price":"0.03 USDC","price_usd":"0.03","currency":"USD","payment_required":true,"response_example":{"best_hours":[]},"errors":{"400":"Invalid request","402":"Payment Required","404":"Not found","429":"Rate limit exceeded","500":"Internal server error"}},{"method":"POST","path":"/arbitrage/battery","category":"Optimization","product_group":"Optimization Signals","description":"Strategie fuer Batteriespeicher-Arbitrage mit ROI-Betrachtung.","price":"0.10 USDC","price_usd":"0.10","currency":"USD","payment_required":true,"response_example":{"strategy":"charge_low_discharge_high","estimated_profit_eur":1.42},"errors":{"400":"Invalid request","402":"Payment Required","404":"Not found","429":"Rate limit exceeded","500":"Internal server error"}},{"method":"POST","path":"/signals/buy-sell","category":"Trading","product_group":"Optimization Signals","description":"Trading-Signal aus Preis, RSI, Trend, EE-Druck und Fossil-Anteil.","price":"0.20 USDC","price_usd":"0.20","currency":"USD","payment_required":true,"response_example":{"signal":"buy","confidence":0.72},"errors":{"400":"Invalid request","402":"Payment Required","404":"Not found","429":"Rate limit exceeded","500":"Internal server error"}},{"method":"POST","path":"/bundle/ev-charging","category":"Bundles","product_group":"Optimization Signals","description":"Preis, CO2 und Ladefenster fuer Elektroauto-Ladung.","price":"0.05 USDC","price_usd":"0.05","currency":"USD","payment_required":true,"response_example":{"recommendation":"charge_between_02_00_and_04_00"},"errors":{"400":"Invalid request","402":"Payment Required","404":"Not found","429":"Rate limit exceeded","500":"Internal server error"}},{"method":"POST","path":"/bundle/heating","category":"Bundles","product_group":"Optimization Signals","description":"Preis, Wetter und EE-Anteil fuer Waermepumpen-Optimierung.","price":"0.05 USDC","price_usd":"0.05","currency":"USD","payment_required":true,"response_example":{"recommendation":"preheat_during_low_price_window"},"errors":{"400":"Invalid request","402":"Payment Required","404":"Not found","429":"Rate limit exceeded","500":"Internal server error"}},{"method":"POST","path":"/bundle/trading","category":"Bundles","product_group":"Research & Intelligence","description":"Kombinierte Markt- und Trading-Daten.","price":"0.30 USDC","price_usd":"0.30","currency":"USD","payment_required":true,"response_example":{"signal":"hold","components":{}},"errors":{"400":"Invalid request","402":"Payment Required","404":"Not found","429":"Rate limit exceeded","500":"Internal server error"}},{"method":"POST","path":"/bundle/esg-reporting","category":"Bundles","product_group":"Research & Intelligence","description":"CO2, EE-Anteil und Quellenhinweise fuer ESG-Reporting.","price":"0.40 USDC","price_usd":"0.40","currency":"USD","payment_required":true,"response_example":{"carbon_intensity_g_co2_kwh":310,"renewable_share_pct":48.6},"errors":{"400":"Invalid request","402":"Payment Required","404":"Not found","429":"Rate limit exceeded","500":"Internal server error"}},{"method":"POST","path":"/history/prices","category":"History","product_group":"Research & Intelligence","description":"Stundendaten fuer EPEX-Preise nach Periode.","price":"0.50 USDC","price_usd":"0.50","currency":"USD","payment_required":true,"response_example":{"period":"last-7d","rows":[]},"errors":{"400":"Invalid request","402":"Payment Required","404":"Not found","429":"Rate limit exceeded","500":"Internal server error"}},{"method":"POST","path":"/history/prices/stats","category":"History","product_group":"Research & Intelligence","description":"Statistik fuer eine historische Preisperiode.","price":"0.20 USDC","price_usd":"0.20","currency":"USD","payment_required":true,"response_example":{"avg_eur_mwh":92.1,"min_eur_mwh":40.2,"max_eur_mwh":160},"errors":{"400":"Invalid request","402":"Payment Required","404":"Not found","429":"Rate limit exceeded","500":"Internal server error"}},{"method":"POST","path":"/solar/forecast","category":"Regional","product_group":"Optimization Signals","description":"Solarstrahlung und Bewoelkung fuer Region oder PLZ.","price":"0.05 USDC","price_usd":"0.05","currency":"USD","payment_required":true,"response_example":{"avg_solar_radiation":220,"avg_cloudcover_pct":54},"errors":{"400":"Invalid request","402":"Payment Required","404":"Not found","429":"Rate limit exceeded","500":"Internal server error"}},{"method":"POST","path":"/wind/forecast","category":"Regional","product_group":"Optimization Signals","description":"Winddaten fuer Region oder PLZ.","price":"0.03 USDC","price_usd":"0.03","currency":"USD","payment_required":true,"response_example":{"avg_windspeed_ms":"5.7"},"errors":{"400":"Invalid request","402":"Payment Required","404":"Not found","429":"Rate limit exceeded","500":"Internal server error"}},{"method":"POST","path":"/subscribe/price-alert","category":"Subscriptions","product_group":"Subscriptions","description":"Webhook-Subscription fuer Strompreis-Thresholds.","price":"5.00 USDC","price_usd":"5.00","currency":"USD","payment_required":true,"response_example":{"success":true,"subscription":"price-alert"},"errors":{"400":"Invalid request","402":"Payment Required","404":"Not found","429":"Rate limit exceeded","500":"Internal server error"}},{"method":"POST","path":"/subscribe/co2-low","category":"Subscriptions","product_group":"Subscriptions","description":"Webhook-Subscription fuer niedrige CO2-Intensitaet.","price":"3.00 USDC","price_usd":"3.00","currency":"USD","payment_required":true,"response_example":{"success":true,"subscription":"co2-low"},"errors":{"400":"Invalid request","402":"Payment Required","404":"Not found","429":"Rate limit exceeded","500":"Internal server error"}},{"method":"POST","path":"/optimizer/cheapest-window","category":"Optimization","product_group":"Optimization Signals","description":"Billigstes zusammenhaengendes Zeitfenster fuer EV, Batterie oder Waermepumpe.","price":"0.10 USDC","price_usd":"0.10","currency":"USD","payment_required":true,"response_example":{"best_start":"2026-06-17T02:00:00.000Z","best_end":"2026-06-17T04:00:00.000Z","avg_price_ct_kwh":4.8},"errors":{"400":"Invalid request","402":"Payment Required","404":"Not found","429":"Rate limit exceeded","500":"Internal server error"}},{"method":"POST","path":"/price/negative-forecast","category":"Trading","product_group":"Optimization Signals","description":"Stunden mit negativen Strompreisen in den naechsten 24 Stunden.","price":"0.05 USDC","price_usd":"0.05","currency":"USD","payment_required":true,"response_example":{"negative_hours":[],"count":0},"errors":{"400":"Invalid request","402":"Payment Required","404":"Not found","429":"Rate limit exceeded","500":"Internal server error"}},{"method":"POST","path":"/summary/today","category":"Agent Decisions","product_group":"Optimization Signals","description":"Token-effiziente Tageszusammenfassung mit konkreter Handlungsempfehlung.","price":"0.10 USDC","price_usd":"0.10","currency":"USD","payment_required":true,"response_example":{"market_sentiment":"neutral","recommendation":"shift flexible load to cheapest window"},"errors":{"400":"Invalid request","402":"Payment Required","404":"Not found","429":"Rate limit exceeded","500":"Internal server error"}},{"method":"POST","path":"/grid/congestion","category":"Grid","product_group":"Optimization Signals","description":"Netzengpass- und Redispatch-Risiko.","price":"0.15 USDC","price_usd":"0.15","currency":"USD","payment_required":true,"response_example":{"risk_level":"medium","affected_regions":[]},"errors":{"400":"Invalid request","402":"Payment Required","404":"Not found","429":"Rate limit exceeded","500":"Internal server error"}},{"method":"POST","path":"/region","category":"Regional","product_group":"Optimization Signals","description":"Preis, CO2, Gruenstrom und Wetter fuer eine PLZ-Region.","price":"0.05 USDC","price_usd":"0.05","currency":"USD","payment_required":true,"response_example":{"plz":"48599","region":"Gronau","data":{}},"errors":{"400":"Invalid request","402":"Payment Required","404":"Not found","429":"Rate limit exceeded","500":"Internal server error"}},{"method":"POST","path":"/mining/profitability","category":"Specialized","product_group":"Optimization Signals","description":"Profitabilitaet fuer ASIC-Mining mit aktuellem Strompreis.","price":"0.10 USDC","price_usd":"0.10","currency":"USD","payment_required":true,"response_example":{"profitable":false,"daily_profit_eur":-2.4},"errors":{"400":"Invalid request","402":"Payment Required","404":"Not found","429":"Rate limit exceeded","500":"Internal server error"}},{"method":"POST","path":"/portfolio/optimize","category":"Optimization","product_group":"Optimization Signals","description":"24h Fahrplan fuer Batterie, PV und Verbrauch.","price":"0.50 USDC","price_usd":"0.50","currency":"USD","payment_required":true,"response_example":{"plan":[{"hour":0,"action":"charge"}],"estimated_savings_eur":3.2},"errors":{"400":"Invalid request","402":"Payment Required","404":"Not found","429":"Rate limit exceeded","500":"Internal server error"}},{"method":"POST","path":"/score/grid-health","category":"Grid","product_group":"Optimization Signals","description":"Score 0-100 fuer Netzgesundheit aus EE-Anteil, Preis, Wetter und Nachfrage.","price":"0.05 USDC","price_usd":"0.05","currency":"USD","payment_required":true,"response_example":{"score":74,"status":"good"},"errors":{"400":"Invalid request","402":"Payment Required","404":"Not found","429":"Rate limit exceeded","500":"Internal server error"}},{"method":"POST","path":"/events/grid","category":"Grid","product_group":"Optimization Signals","description":"Ereignisfeed fuer Dunkelflaute, Sturm, negative Preise und Rekorde.","price":"0.05 USDC","price_usd":"0.05","currency":"USD","payment_required":true,"response_example":{"events":[{"type":"negative_price","severity":"low"}]},"errors":{"400":"Invalid request","402":"Payment Required","404":"Not found","429":"Rate limit exceeded","500":"Internal server error"}}]}