Netzhandwerker Energy Research Hub

{"name":"Netzhandwerker Energy Research Hub MCP Discovery","protocol":"Model Context Protocol","version":"2024-11-05","endpoint":"https://energy.netzhandwerker.de/mcp","docs":"https://energy.netzhandwerker.de/docs","openapi":"https://energy.netzhandwerker.de/openapi.json","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"]},"submit_need":{"method":"POST","url":"https://energy.netzhandwerker.de/demand/submit"},"demand_capture":{"honest_notice":"This endpoint is not available yet. You can request it.","purpose":"Submit an endpoint, data, decision or format request. This is a demand sensor, not a guarantee of implementation.","protocol":"x402","endpoint":"/demand/submit","method":"POST","submit_need":{"method":"POST","url":"https://energy.netzhandwerker.de/demand/submit"},"content_type":"application/json","fields":{"need":{"type":"string","description":"What endpoint, data, decision or signal does your agent want?"},"desired_endpoint":{"type":"string","description":"Preferred endpoint path, if known."},"desired_format":{"type":"string","enum":["json","mcp","openapi","csv","webhook"]},"max_budget_usdc":{"type":"number","description":"Maximum budget per call or request in USDC."},"recurring":{"type":"boolean"},"frequency":{"type":"string","enum":["one_time","hourly","daily","weekly","realtime"]},"required_freshness":{"type":"string"},"use_case":{"type":"string"},"agent_name":{"type":"string"},"agent_url":{"type":"string"},"wallet_type":{"type":"string"},"payment_network":{"type":"string"},"webhook_url":{"type":"string","description":"Optional. Stored, not called automatically."}},"hint_priority":"Optional 0.001 USDC payment lists your request as priority_demand.","optional_priority_price_usdc":0.001,"no_raw_payment_material_logged":true,"available_now":[{"method":"GET","path":"/","payment_required":false,"price_usd":"0","category":"Human and bot overview","summary":"Startseite mit serverseitigen Live-Werten"},{"method":"GET","path":"/health","payment_required":false,"price_usd":"0","category":"Discovery","summary":"Health Check"},{"method":"GET","path":"/discovery-status","payment_required":false,"price_usd":"0","category":"Discovery","summary":"Agent Discovery Status"},{"method":"GET","path":"/agent-starter.json","payment_required":false,"price_usd":"0","category":"Discovery","summary":"Agent Starter Pack"},{"method":"GET","path":"/directory-listing.json","payment_required":false,"price_usd":"0","category":"Discovery","summary":"Directory Listing Pack"},{"method":"GET","path":"/docs","payment_required":false,"price_usd":"0","category":"Discovery","summary":"Dokumentation"},{"method":"GET","path":"/openapi.json","payment_required":false,"price_usd":"0","category":"Discovery","summary":"OpenAPI 3.1 Spezifikation"},{"method":"GET","path":"/llms.txt","payment_required":false,"price_usd":"0","category":"Discovery","summary":"LLM Kurzkontext"},{"method":"GET","path":"/llms-full.txt","payment_required":false,"price_usd":"0","category":"Discovery","summary":"LLM Vollkontext"},{"method":"GET","path":"/robots.txt","payment_required":false,"price_usd":"0","category":"Discovery","summary":"Robots Datei"},{"method":"GET","path":"/sitemap.xml","payment_required":false,"price_usd":"0","category":"Discovery","summary":"Sitemap"},{"method":"GET","path":"/.well-known/ai-plugin.json","payment_required":false,"price_usd":"0","category":"Bot Discovery","summary":"AI Plugin Manifest"},{"method":"GET","path":"/.well-known/mcp.json","payment_required":false,"price_usd":"0","category":"Bot Discovery","summary":"MCP Discovery"},{"method":"GET","path":"/.well-known/agent.json","payment_required":false,"price_usd":"0","category":"Bot Discovery","summary":"Agent Manifest"},{"method":"GET","path":"/.well-known/x402.json","payment_required":false,"price_usd":"0","category":"Bot Discovery","summary":"x402 Manifest"},{"method":"GET","path":"/articles","payment_required":false,"price_usd":"0","category":"Free data","summary":"Artikel-Katalog"},{"method":"GET","path":"/capabilities","payment_required":false,"price_usd":"0","category":"Discovery","summary":"Capabilities"},{"method":"GET","path":"/agent","payment_required":false,"price_usd":"0","category":"Bot Discovery","summary":"Agent Discovery"},{"method":"GET","path":"/pricing","payment_required":false,"price_usd":"0","category":"Bot Discovery","summary":"Pricing"},{"method":"GET","path":"/trust","payment_required":false,"price_usd":"0","category":"Trust","summary":"Trust Page"},{"method":"GET","path":"/status","payment_required":false,"price_usd":"0","category":"Trust","summary":"Status"},{"method":"GET","path":"/sources","payment_required":false,"price_usd":"0","category":"Trust","summary":"Sources"},{"method":"GET","path":"/wallet-bot/needs-info","payment_required":false,"price_usd":"0","category":"Wallet Bot Feedback","summary":"Wallet Bot Needs Info"},{"method":"POST","path":"/wallet-bot/needs","payment_required":false,"price_usd":"0","category":"Wallet Bot Feedback","summary":"Submit Wallet Bot Need"},{"method":"GET","path":"/demand/submit","payment_required":true,"price_usd":"0.001","category":"Demand Intent Filter","summary":"Demand Intent Discovery"},{"method":"POST","path":"/demand/submit","payment_required":true,"price_usd":"0.001","category":"Demand Intent Filter","summary":"Submit endpoint demand"},{"method":"GET","path":"/for-ai-agents","payment_required":false,"price_usd":"0","category":"Bot Landingpages","summary":"For AI Agents"},{"method":"GET","path":"/for-mcp-clients","payment_required":false,"price_usd":"0","category":"Bot Landingpages","summary":"For MCP Clients"},{"method":"GET","path":"/for-x402-bots","payment_required":false,"price_usd":"0","category":"Bot Landingpages","summary":"For x402 Bots"},{"method":"GET","path":"/for-ev-charging-agents","payment_required":false,"price_usd":"0","category":"Bot Landingpages","summary":"For EV Charging Agents"},{"method":"GET","path":"/for-esg-reporting-agents","payment_required":false,"price_usd":"0","category":"Bot Landingpages","summary":"For ESG Reporting Agents"},{"method":"GET","path":"/for-energy-trading-agents","payment_required":false,"price_usd":"0","category":"Bot Landingpages","summary":"For Energy Trading Agents"},{"method":"GET","path":"/sample/research","payment_required":false,"price_usd":"0","category":"Free data","summary":"Research Sample"},{"method":"GET","path":"/sample/articles","payment_required":false,"price_usd":"0","category":"Free data","summary":"Artikel-Snippet"},{"method":"GET","path":"/mcp","payment_required":false,"price_usd":"0","category":"MCP","summary":"MCP Discovery"},{"method":"POST","path":"/mcp","payment_required":false,"price_usd":"0","category":"MCP","summary":"MCP JSON-RPC Endpoint"},{"method":"GET","path":"/agent-manifest","payment_required":false,"price_usd":"0","category":"Bot Discovery","summary":"Agent Manifest"},{"method":"GET","path":"/metrics","payment_required":false,"price_usd":"0","category":"Observability","summary":"Prometheus Metrics"},{"method":"GET","path":"/signals/track-record","payment_required":false,"price_usd":"0","category":"Trust","summary":"Track Record"},{"method":"GET","path":"/tasks/{id}/result","payment_required":false,"price_usd":"0","category":"Async Tasks","summary":"Task Ergebnis"},{"method":"GET","path":"/netzhandwerker-radar","payment_required":false,"price_usd":"0","category":"Protected dashboard","summary":"Bot-Radar Dashboard"},{"method":"GET","path":"/research","payment_required":true,"price_usd":"0.05","category":"Payment Discovery","summary":"Research Payment Requirements"},{"method":"GET","path":"/articles/{id}","payment_required":true,"price_usd":"0.01","category":"Payment Discovery","summary":"Article Payment Requirements"},{"method":"GET","path":"/tasks","payment_required":true,"price_usd":"0.10","category":"Payment Discovery","summary":"Task Payment Requirements"},{"method":"POST","path":"/research","payment_required":true,"price_usd":"0.05","category":"Research","summary":"Energy Research"},{"method":"GET","path":"/demo/paid-sample","payment_required":true,"price_usd":"0.001","category":"Optimization Signals","summary":"x402 Paid Sample"},{"method":"GET","path":"/energy/decision","payment_required":false,"price_usd":"0","category":"Optimization Signals","summary":"Energy Decision Discovery"},{"method":"POST","path":"/energy/decision","payment_required":true,"price_usd":"0.01","category":"Optimization Signals","summary":"Energy Decision"},{"method":"POST","path":"/research/quick","payment_required":true,"price_usd":"0.003","category":"Research","summary":"Quick Research"},{"method":"POST","path":"/research/deep","payment_required":true,"price_usd":"0.05","category":"Research","summary":"Deep Research"},{"method":"POST","path":"/articles/{id}","payment_required":true,"price_usd":"0.01","category":"Premium content","summary":"Premium Artikel"},{"method":"POST","path":"/tasks","payment_required":true,"price_usd":"0.10","category":"Async Tasks","summary":"Async Bounty Task"},{"method":"POST","path":"/price/spot","payment_required":true,"price_usd":"0.001","category":"Live Energy Data API","summary":"Spotpreis jetzt"},{"method":"POST","path":"/price/forecast","payment_required":true,"price_usd":"0.005","category":"Live Energy Data API","summary":"24h Preis-Forecast"},{"method":"POST","path":"/carbon/now","payment_required":true,"price_usd":"0.001","category":"Live Energy Data API","summary":"CO2-Intensität jetzt"},{"method":"POST","path":"/grid/load","payment_required":true,"price_usd":"0.001","category":"Live Energy Data API","summary":"Netzlast"},{"method":"POST","path":"/renewable/share","payment_required":true,"price_usd":"0.001","category":"Live Energy Data API","summary":"Erneuerbare Anteil"},{"method":"POST","path":"/flexibility/window","payment_required":true,"price_usd":"0.01","category":"Optimization","summary":"Flexibility Window"},{"method":"POST","path":"/arbitrage/battery","payment_required":true,"price_usd":"0.01","category":"Optimization","summary":"Battery Arbitrage"},{"method":"POST","path":"/signals/buy-sell","payment_required":true,"price_usd":"0.02","category":"Trading","summary":"Buy/Sell Signal"},{"method":"POST","path":"/bundle/ev-charging","payment_required":true,"price_usd":"0.005","category":"Bundles","summary":"EV Charging Bundle"},{"method":"POST","path":"/bundle/heating","payment_required":true,"price_usd":"0.005","category":"Bundles","summary":"Heating Bundle"},{"method":"POST","path":"/bundle/trading","payment_required":true,"price_usd":"0.02","category":"Bundles","summary":"Trading Bundle"},{"method":"POST","path":"/bundle/esg-reporting","payment_required":true,"price_usd":"0.02","category":"Bundles","summary":"ESG Reporting Bundle"},{"method":"POST","path":"/history/prices","payment_required":true,"price_usd":"0.05","category":"History","summary":"Historische Preise"},{"method":"POST","path":"/history/prices/stats","payment_required":true,"price_usd":"0.01","category":"History","summary":"Preisstatistik"},{"method":"POST","path":"/solar/forecast","payment_required":true,"price_usd":"0.005","category":"Regional","summary":"Solar Forecast"},{"method":"POST","path":"/wind/forecast","payment_required":true,"price_usd":"0.005","category":"Regional","summary":"Wind Forecast"},{"method":"POST","path":"/subscribe/price-alert","payment_required":true,"price_usd":"0.10","category":"Subscriptions","summary":"Price Alert Subscription"},{"method":"POST","path":"/subscribe/co2-low","payment_required":true,"price_usd":"0.10","category":"Subscriptions","summary":"CO2 Low Subscription"},{"method":"POST","path":"/optimizer/cheapest-window","payment_required":true,"price_usd":"0.005","category":"Optimization","summary":"Cheapest Window"},{"method":"POST","path":"/price/negative-forecast","payment_required":true,"price_usd":"0.005","category":"Trading","summary":"Negative Price Forecast"},{"method":"POST","path":"/summary/today","payment_required":true,"price_usd":"0.01","category":"Agent Decisions","summary":"Daily Summary"},{"method":"POST","path":"/grid/congestion","payment_required":true,"price_usd":"0.01","category":"Grid","summary":"Grid Congestion"},{"method":"POST","path":"/region","payment_required":true,"price_usd":"0.005","category":"Regional","summary":"Regionale Energiedaten"},{"method":"POST","path":"/mining/profitability","payment_required":true,"price_usd":"0.02","category":"Specialized","summary":"BTC Mining Profitability"},{"method":"POST","path":"/portfolio/optimize","payment_required":true,"price_usd":"0.05","category":"Optimization","summary":"Portfolio Optimize"},{"method":"POST","path":"/score/grid-health","payment_required":true,"price_usd":"0.01","category":"Grid","summary":"Grid Health Score"},{"method":"POST","path":"/events/grid","payment_required":true,"price_usd":"0.005","category":"Grid","summary":"Grid Events"}]},"tools_count":45,"tools":[{"name":"submit_data_request","description":"Submit a missing endpoint, data, format or budget signal. No payment is required; optional 0.001 USDC x402 payment marks it as priority_demand.","input_schema":{"type":"object","required":["need"],"properties":{"need":{"type":"string","description":"What endpoint, data, decision or signal does your agent want?"},"desired_endpoint":{"type":"string","description":"Preferred endpoint path, if known."},"desired_format":{"type":"string","enum":["json","mcp","openapi","csv","webhook"]},"max_budget_usdc":{"type":"number","description":"Maximum budget per call or request in USDC."},"recurring":{"type":"boolean"},"frequency":{"type":"string","enum":["one_time","hourly","daily","weekly","realtime"]},"required_freshness":{"type":"string"},"use_case":{"type":"string"},"agent_name":{"type":"string"},"agent_url":{"type":"string"},"wallet_type":{"type":"string"},"payment_network":{"type":"string"},"webhook_url":{"type":"string","description":"Optional. Stored, not called automatically."}},"additionalProperties":false},"endpoint":"/demand/submit","method":"POST","price":"optional 0.001 USDC","payment_required":false,"payment":null},{"name":"list_energy_endpoints","description":"List all Energy Research Hub endpoints grouped into Live Energy Data, Optimization Signals and Research & Intelligence.","input_schema":{"type":"object","properties":{},"additionalProperties":true},"endpoint":"/mcp","method":"POST","price":"frei","payment_required":false,"payment":null},{"name":"get_payment_info","description":"Return x402 payment configuration for Base Mainnet USDC.","input_schema":{"type":"object","properties":{},"additionalProperties":true},"endpoint":"/mcp","method":"POST","price":"frei","payment_required":false,"payment":null},{"name":"pricing_lookup","description":"Return the machine-readable price list for all paid energy products.","input_schema":{"type":"object","properties":{},"additionalProperties":true},"endpoint":"/pricing","method":"GET","price":"frei","payment_required":false,"payment":null},{"name":"get_wallet_bot_needs_info","description":"Explain how wallet-enabled agents can tell the hub what they want to buy.","input_schema":{"type":"object","properties":{},"additionalProperties":true},"endpoint":"/wallet-bot/needs-info","method":"GET","price":"frei","payment_required":false,"payment":null},{"name":"submit_wallet_bot_need","description":"Submit a wallet-enabled agent demand signal: needed data, missing endpoint, format, freshness and budget.","input_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},"endpoint":"/wallet-bot/needs","method":"POST","price":"frei","payment_required":false,"payment":null},{"name":"call_demand_submit","description":"[Demand Intent Filter] Machine-readable discovery fallback for demand submissions. Optional x402 payment can mark a request as priority_demand.","input_schema":{"type":"object","required":["need"],"properties":{"need":{"type":"string","description":"What endpoint, data, decision or signal does your agent want?"},"desired_endpoint":{"type":"string","description":"Preferred endpoint path, if known."},"desired_format":{"type":"string","enum":["json","mcp","openapi","csv","webhook"]},"max_budget_usdc":{"type":"number","description":"Maximum budget per call or request in USDC."},"recurring":{"type":"boolean"},"frequency":{"type":"string","enum":["one_time","hourly","daily","weekly","realtime"]},"required_freshness":{"type":"string"},"use_case":{"type":"string"},"agent_name":{"type":"string"},"agent_url":{"type":"string"},"wallet_type":{"type":"string"},"payment_network":{"type":"string"},"webhook_url":{"type":"string","description":"Optional. Stored, not called automatically."}},"additionalProperties":false},"endpoint":"/demand/submit","method":"GET","price":"0.001 USDC","payment_required":true,"payment":{"protocol":"x402","scheme":"exact","asset":"USDC","asset_address":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","amount_usdc":"0.001","amount_units":"1000","recipient":"0x2880EdfFF13100677Bf97A3CBdF3Bc34771C4E5E","network":"Base Mainnet","network_id":"eip155:8453","chain_id":8453}},{"name":"call_demand_submit","description":"[Demand Intent Filter] Two-stage intent filter for agents to submit a data or endpoint request. Without payment it is stored as unverified_demand; optional verified 0.001 USDC lists it as priority_demand.","input_schema":{"type":"object","required":["need"],"properties":{"need":{"type":"string","description":"What endpoint, data, decision or signal does your agent want?"},"desired_endpoint":{"type":"string","description":"Preferred endpoint path, if known."},"desired_format":{"type":"string","enum":["json","mcp","openapi","csv","webhook"]},"max_budget_usdc":{"type":"number","description":"Maximum budget per call or request in USDC."},"recurring":{"type":"boolean"},"frequency":{"type":"string","enum":["one_time","hourly","daily","weekly","realtime"]},"required_freshness":{"type":"string"},"use_case":{"type":"string"},"agent_name":{"type":"string"},"agent_url":{"type":"string"},"wallet_type":{"type":"string"},"payment_network":{"type":"string"},"webhook_url":{"type":"string","description":"Optional. Stored, not called automatically."}},"additionalProperties":false},"endpoint":"/demand/submit","method":"POST","price":"0.001 USDC","payment_required":true,"payment":{"protocol":"x402","scheme":"exact","asset":"USDC","asset_address":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","amount_usdc":"0.001","amount_units":"1000","recipient":"0x2880EdfFF13100677Bf97A3CBdF3Bc34771C4E5E","network":"Base Mainnet","network_id":"eip155:8453","chain_id":8453}},{"name":"call_research","description":"[Research & Intelligence] GET-Fallback mit maschinenlesbarer 402-Antwort für POST /research.","input_schema":{"type":"object","properties":{},"additionalProperties":true},"endpoint":"/research","method":"GET","price":"0.05 USDC","payment_required":true,"payment":{"protocol":"x402","scheme":"exact","asset":"USDC","asset_address":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","amount_usdc":"0.05","amount_units":"50000","recipient":"0x2880EdfFF13100677Bf97A3CBdF3Bc34771C4E5E","network":"Base Mainnet","network_id":"eip155:8453","chain_id":8453}},{"name":"call_articles_id","description":"[Research & Intelligence] GET-Fallback mit maschinenlesbarer 402-Antwort für POST /articles/{id}.","input_schema":{"type":"object","properties":{},"additionalProperties":true},"endpoint":"/articles/{id}","method":"GET","price":"0.01 USDC","payment_required":true,"payment":{"protocol":"x402","scheme":"exact","asset":"USDC","asset_address":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","amount_usdc":"0.01","amount_units":"10000","recipient":"0x2880EdfFF13100677Bf97A3CBdF3Bc34771C4E5E","network":"Base Mainnet","network_id":"eip155:8453","chain_id":8453}},{"name":"call_tasks","description":"[Research & Intelligence] GET-Fallback mit maschinenlesbarer 402-Antwort für POST /tasks.","input_schema":{"type":"object","properties":{},"additionalProperties":true},"endpoint":"/tasks","method":"GET","price":"ab 0.10 USDC","payment_required":true,"payment":{"protocol":"x402","scheme":"exact","asset":"USDC","asset_address":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","amount_usdc":"0.10","amount_units":"100000","recipient":"0x2880EdfFF13100677Bf97A3CBdF3Bc34771C4E5E","network":"Base Mainnet","network_id":"eip155:8453","chain_id":8453}},{"name":"energy_research","description":"[Research & Intelligence] Aggregierte Energie-Recherche für DE/EU aus Live-Datenquellen.","input_schema":{"type":"object","required":["query"],"properties":{"query":{"type":"string","minLength":1},"sources":{"type":"array","items":{"type":"string"}}}},"endpoint":"/research","method":"POST","price":"0.05 USDC","payment_required":true,"payment":{"protocol":"x402","scheme":"exact","asset":"USDC","asset_address":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","amount_usdc":"0.05","amount_units":"50000","recipient":"0x2880EdfFF13100677Bf97A3CBdF3Bc34771C4E5E","network":"Base Mainnet","network_id":"eip155:8453","chain_id":8453}},{"name":"paid_sample","description":"[Optimization Signals] Machine-readable discovery for the x402 sample endpoint. The actual access flow is gated by x402 payment.","input_schema":{"type":"object","properties":{},"additionalProperties":true},"endpoint":"/demo/paid-sample","method":"GET","price":"0.001 USDC","payment_required":true,"payment":{"protocol":"x402","scheme":"exact","asset":"USDC","asset_address":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","amount_usdc":"0.001","amount_units":"1000","recipient":"0x2880EdfFF13100677Bf97A3CBdF3Bc34771C4E5E","network":"Base Mainnet","network_id":"eip155:8453","chain_id":8453}},{"name":"energy_decision","description":"[Optimization Signals] Central premium decision endpoint. Use it if you want one paid answer instead of combining multiple raw data and signal endpoints.","input_schema":{"type":"object","properties":{"goal":{"type":"string","enum":["minimize_cost","minimize_carbon","balanced","maximize_self_consumption","trading_signal"],"default":"balanced"},"device":{"type":"string","enum":["ev","battery","heat_pump","flexible_load","generic"],"default":"generic"},"location":{"type":"string","default":"Germany"},"duration_hours":{"type":"integer","minimum":1,"maximum":24,"default":4},"deadline":{"type":"string","format":"date-time"},"constraints":{"type":"object","properties":{"min_soc":{"type":"number"},"target_soc":{"type":"number"},"max_power_kw":{"type":"number"},"must_finish_by":{"type":"string","format":"date-time"}}}}},"endpoint":"/energy/decision","method":"POST","price":"0.01 USDC","payment_required":true,"payment":{"protocol":"x402","scheme":"exact","asset":"USDC","asset_address":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","amount_usdc":"0.01","amount_units":"10000","recipient":"0x2880EdfFF13100677Bf97A3CBdF3Bc34771C4E5E","network":"Base Mainnet","network_id":"eip155:8453","chain_id":8453}},{"name":"energy_research_quick","description":"[Research & Intelligence] Kompakte Research-Antwort mit Live-Kennzahlen.","input_schema":{"type":"object","required":["query"],"properties":{"query":{"type":"string","minLength":1},"sources":{"type":"array","items":{"type":"string"}}}},"endpoint":"/research/quick","method":"POST","price":"0.003 USDC","payment_required":true,"payment":{"protocol":"x402","scheme":"exact","asset":"USDC","asset_address":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","amount_usdc":"0.003","amount_units":"3000","recipient":"0x2880EdfFF13100677Bf97A3CBdF3Bc34771C4E5E","network":"Base Mainnet","network_id":"eip155:8453","chain_id":8453}},{"name":"energy_research_deep","description":"[Research & Intelligence] Tiefe Research-Antwort mit Premium-Quellen und LLM-Synthese.","input_schema":{"type":"object","required":["query"],"properties":{"query":{"type":"string","minLength":1},"sources":{"type":"array","items":{"type":"string"}}}},"endpoint":"/research/deep","method":"POST","price":"0.05 USDC","payment_required":true,"payment":{"protocol":"x402","scheme":"exact","asset":"USDC","asset_address":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","amount_usdc":"0.05","amount_units":"50000","recipient":"0x2880EdfFF13100677Bf97A3CBdF3Bc34771C4E5E","network":"Base Mainnet","network_id":"eip155:8453","chain_id":8453}},{"name":"call_articles_id","description":"[Research & Intelligence] Volltext eines Energie-Fachartikels.","input_schema":{"type":"object","properties":{},"additionalProperties":true},"endpoint":"/articles/{id}","method":"POST","price":"0.01 USDC","payment_required":true,"payment":{"protocol":"x402","scheme":"exact","asset":"USDC","asset_address":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","amount_usdc":"0.01","amount_units":"10000","recipient":"0x2880EdfFF13100677Bf97A3CBdF3Bc34771C4E5E","network":"Base Mainnet","network_id":"eip155:8453","chain_id":8453}},{"name":"call_tasks","description":"[Research & Intelligence] Asynchroner Deep-Dive Task mit Mindest-Bounty.","input_schema":{"type":"object","required":["task_description","bounty"],"properties":{"task_description":{"type":"string"},"bounty":{"type":"string","description":"Launch minimum 0.10 USDC (normal minimum 1.00 USDC), maximum 100.00 USDC."}}},"endpoint":"/tasks","method":"POST","price":"ab 0.10 USDC","payment_required":true,"payment":{"protocol":"x402","scheme":"exact","asset":"USDC","asset_address":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","amount_usdc":"0.10","amount_units":"100000","recipient":"0x2880EdfFF13100677Bf97A3CBdF3Bc34771C4E5E","network":"Base Mainnet","network_id":"eip155:8453","chain_id":8453}},{"name":"get_current_german_spot_electricity_price","description":"[Live Energy Data] Aktueller EPEX Spot-Strompreis für Deutschland.","input_schema":{"type":"object","properties":{},"additionalProperties":true},"endpoint":"/price/spot","method":"POST","price":"0.001 USDC","payment_required":true,"payment":{"protocol":"x402","scheme":"exact","asset":"USDC","asset_address":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","amount_usdc":"0.001","amount_units":"1000","recipient":"0x2880EdfFF13100677Bf97A3CBdF3Bc34771C4E5E","network":"Base Mainnet","network_id":"eip155:8453","chain_id":8453}},{"name":"get_price_forecast","description":"[Live Energy Data] EPEX Day-Ahead Preise mit Min/Max/Spread.","input_schema":{"type":"object","properties":{},"additionalProperties":true},"endpoint":"/price/forecast","method":"POST","price":"0.005 USDC","payment_required":true,"payment":{"protocol":"x402","scheme":"exact","asset":"USDC","asset_address":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","amount_usdc":"0.005","amount_units":"5000","recipient":"0x2880EdfFF13100677Bf97A3CBdF3Bc34771C4E5E","network":"Base Mainnet","network_id":"eip155:8453","chain_id":8453}},{"name":"get_co2_intensity_now","description":"[Live Energy Data] Aktuelle CO2-Intensität des deutschen Strommix.","input_schema":{"type":"object","properties":{},"additionalProperties":true},"endpoint":"/carbon/now","method":"POST","price":"0.001 USDC","payment_required":true,"payment":{"protocol":"x402","scheme":"exact","asset":"USDC","asset_address":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","amount_usdc":"0.001","amount_units":"1000","recipient":"0x2880EdfFF13100677Bf97A3CBdF3Bc34771C4E5E","network":"Base Mainnet","network_id":"eip155:8453","chain_id":8453}},{"name":"get_grid_load","description":"[Live Energy Data] Aktuelle Netzlast aus SMARD.","input_schema":{"type":"object","properties":{},"additionalProperties":true},"endpoint":"/grid/load","method":"POST","price":"0.001 USDC","payment_required":true,"payment":{"protocol":"x402","scheme":"exact","asset":"USDC","asset_address":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","amount_usdc":"0.001","amount_units":"1000","recipient":"0x2880EdfFF13100677Bf97A3CBdF3Bc34771C4E5E","network":"Base Mainnet","network_id":"eip155:8453","chain_id":8453}},{"name":"get_renewable_share","description":"[Live Energy Data] Live-Anteil erneuerbarer Energien am deutschen Strommix.","input_schema":{"type":"object","properties":{},"additionalProperties":true},"endpoint":"/renewable/share","method":"POST","price":"0.001 USDC","payment_required":true,"payment":{"protocol":"x402","scheme":"exact","asset":"USDC","asset_address":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","amount_usdc":"0.001","amount_units":"1000","recipient":"0x2880EdfFF13100677Bf97A3CBdF3Bc34771C4E5E","network":"Base Mainnet","network_id":"eip155:8453","chain_id":8453}},{"name":"find_flexibility_window","description":"[Optimization Signals] Günstigste Zeitfenster für flexible Verbraucher.","input_schema":{"type":"object","properties":{},"additionalProperties":true},"endpoint":"/flexibility/window","method":"POST","price":"0.01 USDC","payment_required":true,"payment":{"protocol":"x402","scheme":"exact","asset":"USDC","asset_address":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","amount_usdc":"0.01","amount_units":"10000","recipient":"0x2880EdfFF13100677Bf97A3CBdF3Bc34771C4E5E","network":"Base Mainnet","network_id":"eip155:8453","chain_id":8453}},{"name":"get_battery_arbitrage_strategy","description":"[Optimization Signals] Strategie für Batteriespeicher-Arbitrage mit ROI-Betrachtung.","input_schema":{"type":"object","properties":{"capacity_kwh":{"type":"number"},"efficiency":{"type":"number"}}},"endpoint":"/arbitrage/battery","method":"POST","price":"0.01 USDC","payment_required":true,"payment":{"protocol":"x402","scheme":"exact","asset":"USDC","asset_address":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","amount_usdc":"0.01","amount_units":"10000","recipient":"0x2880EdfFF13100677Bf97A3CBdF3Bc34771C4E5E","network":"Base Mainnet","network_id":"eip155:8453","chain_id":8453}},{"name":"get_energy_trading_signal","description":"[Optimization Signals] Trading-Signal aus Preis, RSI, Trend, EE-Druck und Fossil-Anteil.","input_schema":{"type":"object","properties":{},"additionalProperties":true},"endpoint":"/signals/buy-sell","method":"POST","price":"0.02 USDC","payment_required":true,"payment":{"protocol":"x402","scheme":"exact","asset":"USDC","asset_address":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","amount_usdc":"0.02","amount_units":"20000","recipient":"0x2880EdfFF13100677Bf97A3CBdF3Bc34771C4E5E","network":"Base Mainnet","network_id":"eip155:8453","chain_id":8453}},{"name":"find_cheapest_ev_charging_window","description":"[Optimization Signals] Preis, CO2 und Ladefenster für Elektroauto-Ladung.","input_schema":{"type":"object","properties":{},"additionalProperties":true},"endpoint":"/bundle/ev-charging","method":"POST","price":"0.005 USDC","payment_required":true,"payment":{"protocol":"x402","scheme":"exact","asset":"USDC","asset_address":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","amount_usdc":"0.005","amount_units":"5000","recipient":"0x2880EdfFF13100677Bf97A3CBdF3Bc34771C4E5E","network":"Base Mainnet","network_id":"eip155:8453","chain_id":8453}},{"name":"call_bundle_heating","description":"[Optimization Signals] Preis, Wetter und EE-Anteil für Wärmepumpen-Optimierung.","input_schema":{"type":"object","properties":{},"additionalProperties":true},"endpoint":"/bundle/heating","method":"POST","price":"0.005 USDC","payment_required":true,"payment":{"protocol":"x402","scheme":"exact","asset":"USDC","asset_address":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","amount_usdc":"0.005","amount_units":"5000","recipient":"0x2880EdfFF13100677Bf97A3CBdF3Bc34771C4E5E","network":"Base Mainnet","network_id":"eip155:8453","chain_id":8453}},{"name":"call_bundle_trading","description":"[Research & Intelligence] Kombinierte Markt- und Trading-Daten.","input_schema":{"type":"object","required":["query"],"properties":{"query":{"type":"string","minLength":1},"sources":{"type":"array","items":{"type":"string"}}}},"endpoint":"/bundle/trading","method":"POST","price":"0.02 USDC","payment_required":true,"payment":{"protocol":"x402","scheme":"exact","asset":"USDC","asset_address":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","amount_usdc":"0.02","amount_units":"20000","recipient":"0x2880EdfFF13100677Bf97A3CBdF3Bc34771C4E5E","network":"Base Mainnet","network_id":"eip155:8453","chain_id":8453}},{"name":"get_esg_energy_report","description":"[Research & Intelligence] CO2, EE-Anteil und Quellenhinweise für ESG-Reporting.","input_schema":{"type":"object","properties":{},"additionalProperties":true},"endpoint":"/bundle/esg-reporting","method":"POST","price":"0.02 USDC","payment_required":true,"payment":{"protocol":"x402","scheme":"exact","asset":"USDC","asset_address":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","amount_usdc":"0.02","amount_units":"20000","recipient":"0x2880EdfFF13100677Bf97A3CBdF3Bc34771C4E5E","network":"Base Mainnet","network_id":"eip155:8453","chain_id":8453}},{"name":"call_history_prices","description":"[Research & Intelligence] Stundendaten für EPEX-Preise nach Periode.","input_schema":{"type":"object","required":["period"],"properties":{"period":{"type":"string","examples":["last-7d","last-30d","2025-Q4","2024-01"]}}},"endpoint":"/history/prices","method":"POST","price":"0.05 USDC","payment_required":true,"payment":{"protocol":"x402","scheme":"exact","asset":"USDC","asset_address":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","amount_usdc":"0.05","amount_units":"50000","recipient":"0x2880EdfFF13100677Bf97A3CBdF3Bc34771C4E5E","network":"Base Mainnet","network_id":"eip155:8453","chain_id":8453}},{"name":"call_history_prices_stats","description":"[Research & Intelligence] Statistik für eine historische Preisperiode.","input_schema":{"type":"object","required":["period"],"properties":{"period":{"type":"string","examples":["last-7d","last-30d","2025-Q4","2024-01"]}}},"endpoint":"/history/prices/stats","method":"POST","price":"0.01 USDC","payment_required":true,"payment":{"protocol":"x402","scheme":"exact","asset":"USDC","asset_address":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","amount_usdc":"0.01","amount_units":"10000","recipient":"0x2880EdfFF13100677Bf97A3CBdF3Bc34771C4E5E","network":"Base Mainnet","network_id":"eip155:8453","chain_id":8453}},{"name":"call_solar_forecast","description":"[Optimization Signals] Solarstrahlung und Bewölkung für Region oder PLZ.","input_schema":{"type":"object","properties":{"plz":{"type":"string"},"lat":{"type":"number"},"lon":{"type":"number"}}},"endpoint":"/solar/forecast","method":"POST","price":"0.005 USDC","payment_required":true,"payment":{"protocol":"x402","scheme":"exact","asset":"USDC","asset_address":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","amount_usdc":"0.005","amount_units":"5000","recipient":"0x2880EdfFF13100677Bf97A3CBdF3Bc34771C4E5E","network":"Base Mainnet","network_id":"eip155:8453","chain_id":8453}},{"name":"call_wind_forecast","description":"[Optimization Signals] Winddaten für Region oder PLZ.","input_schema":{"type":"object","properties":{"plz":{"type":"string"},"lat":{"type":"number"},"lon":{"type":"number"}}},"endpoint":"/wind/forecast","method":"POST","price":"0.005 USDC","payment_required":true,"payment":{"protocol":"x402","scheme":"exact","asset":"USDC","asset_address":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","amount_usdc":"0.005","amount_units":"5000","recipient":"0x2880EdfFF13100677Bf97A3CBdF3Bc34771C4E5E","network":"Base Mainnet","network_id":"eip155:8453","chain_id":8453}},{"name":"call_subscribe_price_alert","description":"[Subscriptions] Webhook-Subscription für Strompreis-Thresholds.","input_schema":{"type":"object","required":["webhook_url"],"properties":{"webhook_url":{"type":"string","format":"uri"},"threshold_ct_kwh":{"type":"number"},"threshold_g_kwh":{"type":"number"},"direction":{"type":"string","enum":["above","below"]}}},"endpoint":"/subscribe/price-alert","method":"POST","price":"0.10 USDC","payment_required":true,"payment":{"protocol":"x402","scheme":"exact","asset":"USDC","asset_address":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","amount_usdc":"0.10","amount_units":"100000","recipient":"0x2880EdfFF13100677Bf97A3CBdF3Bc34771C4E5E","network":"Base Mainnet","network_id":"eip155:8453","chain_id":8453}},{"name":"call_subscribe_co2_low","description":"[Subscriptions] Webhook-Subscription für niedrige CO2-Intensität.","input_schema":{"type":"object","required":["webhook_url"],"properties":{"webhook_url":{"type":"string","format":"uri"},"threshold_ct_kwh":{"type":"number"},"threshold_g_kwh":{"type":"number"},"direction":{"type":"string","enum":["above","below"]}}},"endpoint":"/subscribe/co2-low","method":"POST","price":"0.10 USDC","payment_required":true,"payment":{"protocol":"x402","scheme":"exact","asset":"USDC","asset_address":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","amount_usdc":"0.10","amount_units":"100000","recipient":"0x2880EdfFF13100677Bf97A3CBdF3Bc34771C4E5E","network":"Base Mainnet","network_id":"eip155:8453","chain_id":8453}},{"name":"find_cheapest_window","description":"[Optimization Signals] Günstigstes zusammenhängendes Zeitfenster für EV, Batterie oder Wärmepumpe.","input_schema":{"type":"object","properties":{"duration_hours":{"type":"integer","default":2}}},"endpoint":"/optimizer/cheapest-window","method":"POST","price":"0.005 USDC","payment_required":true,"payment":{"protocol":"x402","scheme":"exact","asset":"USDC","asset_address":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","amount_usdc":"0.005","amount_units":"5000","recipient":"0x2880EdfFF13100677Bf97A3CBdF3Bc34771C4E5E","network":"Base Mainnet","network_id":"eip155:8453","chain_id":8453}},{"name":"call_price_negative_forecast","description":"[Optimization Signals] Stunden mit negativen Strompreisen in den nächsten 24 Stunden.","input_schema":{"type":"object","properties":{},"additionalProperties":true},"endpoint":"/price/negative-forecast","method":"POST","price":"0.005 USDC","payment_required":true,"payment":{"protocol":"x402","scheme":"exact","asset":"USDC","asset_address":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","amount_usdc":"0.005","amount_units":"5000","recipient":"0x2880EdfFF13100677Bf97A3CBdF3Bc34771C4E5E","network":"Base Mainnet","network_id":"eip155:8453","chain_id":8453}},{"name":"get_today_energy_summary","description":"[Optimization Signals] Token-effiziente Tageszusammenfassung mit konkreter Handlungsempfehlung.","input_schema":{"type":"object","properties":{},"additionalProperties":true},"endpoint":"/summary/today","method":"POST","price":"0.01 USDC","payment_required":true,"payment":{"protocol":"x402","scheme":"exact","asset":"USDC","asset_address":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","amount_usdc":"0.01","amount_units":"10000","recipient":"0x2880EdfFF13100677Bf97A3CBdF3Bc34771C4E5E","network":"Base Mainnet","network_id":"eip155:8453","chain_id":8453}},{"name":"call_grid_congestion","description":"[Optimization Signals] Netzengpass- und Redispatch-Risiko.","input_schema":{"type":"object","properties":{},"additionalProperties":true},"endpoint":"/grid/congestion","method":"POST","price":"0.01 USDC","payment_required":true,"payment":{"protocol":"x402","scheme":"exact","asset":"USDC","asset_address":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","amount_usdc":"0.01","amount_units":"10000","recipient":"0x2880EdfFF13100677Bf97A3CBdF3Bc34771C4E5E","network":"Base Mainnet","network_id":"eip155:8453","chain_id":8453}},{"name":"call_region","description":"[Optimization Signals] Preis, CO2, Grünstrom und Wetter für eine PLZ-Region.","input_schema":{"type":"object","required":["plz"],"properties":{"plz":{"type":"string","pattern":"^[0-9]{5}$"}}},"endpoint":"/region","method":"POST","price":"0.005 USDC","payment_required":true,"payment":{"protocol":"x402","scheme":"exact","asset":"USDC","asset_address":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","amount_usdc":"0.005","amount_units":"5000","recipient":"0x2880EdfFF13100677Bf97A3CBdF3Bc34771C4E5E","network":"Base Mainnet","network_id":"eip155:8453","chain_id":8453}},{"name":"call_mining_profitability","description":"[Optimization Signals] Profitabilität für ASIC-Mining mit aktuellem Strompreis.","input_schema":{"type":"object","properties":{"asic_model":{"type":"string"},"electricity_price_ct_kwh":{"type":"number"}}},"endpoint":"/mining/profitability","method":"POST","price":"0.02 USDC","payment_required":true,"payment":{"protocol":"x402","scheme":"exact","asset":"USDC","asset_address":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","amount_usdc":"0.02","amount_units":"20000","recipient":"0x2880EdfFF13100677Bf97A3CBdF3Bc34771C4E5E","network":"Base Mainnet","network_id":"eip155:8453","chain_id":8453}},{"name":"call_portfolio_optimize","description":"[Optimization Signals] 24h Fahrplan für Batterie, PV und Verbrauch.","input_schema":{"type":"object","properties":{"battery_kwh":{"type":"number"},"pv_kwp":{"type":"number"},"daily_consumption_kwh":{"type":"number"}}},"endpoint":"/portfolio/optimize","method":"POST","price":"0.05 USDC","payment_required":true,"payment":{"protocol":"x402","scheme":"exact","asset":"USDC","asset_address":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","amount_usdc":"0.05","amount_units":"50000","recipient":"0x2880EdfFF13100677Bf97A3CBdF3Bc34771C4E5E","network":"Base Mainnet","network_id":"eip155:8453","chain_id":8453}},{"name":"get_grid_health_score","description":"[Optimization Signals] Score 0-100 für Netzgesundheit aus EE-Anteil, Preis, Wetter und Nachfrage.","input_schema":{"type":"object","properties":{},"additionalProperties":true},"endpoint":"/score/grid-health","method":"POST","price":"0.01 USDC","payment_required":true,"payment":{"protocol":"x402","scheme":"exact","asset":"USDC","asset_address":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","amount_usdc":"0.01","amount_units":"10000","recipient":"0x2880EdfFF13100677Bf97A3CBdF3Bc34771C4E5E","network":"Base Mainnet","network_id":"eip155:8453","chain_id":8453}},{"name":"get_grid_events","description":"[Optimization Signals] Ereignisfeed für Dunkelflaute, Sturm, negative Preise und Rekorde.","input_schema":{"type":"object","properties":{},"additionalProperties":true},"endpoint":"/events/grid","method":"POST","price":"0.005 USDC","payment_required":true,"payment":{"protocol":"x402","scheme":"exact","asset":"USDC","asset_address":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","amount_usdc":"0.005","amount_units":"5000","recipient":"0x2880EdfFF13100677Bf97A3CBdF3Bc34771C4E5E","network":"Base Mainnet","network_id":"eip155:8453","chain_id":8453}}]}