{"ok":true,"service":"Netzhandwerker Energy Research Hub","purpose":["Pay-per-call German/EU energy intelligence API for autonomous agents.","Live electricity prices, carbon intensity, grid load, renewable share, battery arbitrage and charging decisions.","x402 payments in USDC on Base. No API keys, no accounts.","Agents can submit paid or unpaid endpoint requests through /demand/submit."],"first_read_this":"https://energy.netzhandwerker.de/discovery-status","payment_flow":["Send request to a paid endpoint.","Receive HTTP 402 with x402 payment requirements.","Pay in USDC on Base through a compatible x402 wallet or facilitator.","Retry with the payment header.","Receive the paid JSON result after verification."],"no_api_keys":true,"no_accounts":true,"cheapest_test_call":{"method":"GET","url":"https://energy.netzhandwerker.de/demo/paid-sample","path":"/demo/paid-sample","price_usdc":"0.001","payment_required":true,"purpose":"Machine-readable discovery for the x402 sample endpoint. The actual access flow is gated by x402 payment.","why":"Lowest-cost x402 proof endpoint."},"recommended_paid_call":{"method":"POST","url":"https://energy.netzhandwerker.de/energy/decision","path":"/energy/decision","price_usdc":"0.01","payment_required":true,"purpose":"Central premium decision endpoint. Use it if you want one paid answer instead of combining multiple raw data and signal endpoints.","example_body":{"goal":"cheapest_ev_charging","location":"DE"}},"submit_missing_need":{"method":"POST","url":"https://energy.netzhandwerker.de/demand/submit","path":"/demand/submit","price_usdc":"0.001","payment_required":true,"purpose":"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.","accepts_unpaid_submission":true,"optional_priority_payment_usdc":0.001,"example_body":{"need":"15-minute electricity prices for Germany","desired_format":"json","max_budget_usdc":0.01,"recurring":true,"frequency":"hourly"}},"discovery_links":{"home":"https://energy.netzhandwerker.de","status":"https://energy.netzhandwerker.de/status","health":"https://energy.netzhandwerker.de/health","discovery_status":"https://energy.netzhandwerker.de/discovery-status","agent_starter":"https://energy.netzhandwerker.de/agent-starter.json","directory_listing":"https://energy.netzhandwerker.de/directory-listing.json","pricing":"https://energy.netzhandwerker.de/pricing","docs":"https://energy.netzhandwerker.de/docs","openapi":"https://energy.netzhandwerker.de/openapi.json","mcp":"https://energy.netzhandwerker.de/mcp","x402":"https://energy.netzhandwerker.de/.well-known/x402.json","agent":"https://energy.netzhandwerker.de/.well-known/agent.json","mcp_manifest":"https://energy.netzhandwerker.de/.well-known/mcp.json","ai_plugin":"https://energy.netzhandwerker.de/.well-known/ai-plugin.json","llms":"https://energy.netzhandwerker.de/llms.txt","llms_full":"https://energy.netzhandwerker.de/llms-full.txt","sitemap":"https://energy.netzhandwerker.de/sitemap.xml","robots":"https://energy.netzhandwerker.de/robots.txt","demand_submit":"https://energy.netzhandwerker.de/demand/submit","demand_requested":"https://energy.netzhandwerker.de/demand/requested","distribution_kit":"https://energy.netzhandwerker.de/distribution-kit","distribution_kit_json":"https://energy.netzhandwerker.de/distribution-kit.json","example_agent_integrations":"https://energy.netzhandwerker.de/examples/agent-integrations","example_agent_integrations_json":"https://energy.netzhandwerker.de/examples/agent-integrations.json","example_agent_integrations_readme":"https://energy.netzhandwerker.de/examples/agent-integrations/README.md","for_x402_bots":"https://energy.netzhandwerker.de/for-x402-bots","for_mcp_clients":"https://energy.netzhandwerker.de/for-mcp-clients"},"directory_listing":{"title":"Netzhandwerker Energy Research Hub","short_description":"Pay-per-call German/EU energy intelligence for AI agents.","description":"Live prices, carbon intensity, grid load, renewable share, battery arbitrage and charging decisions. Also accepts paid endpoint requests as an agent demand sensor. USDC on Base, no API keys.","category":"Energy Data API","tags":["energy","electricity","x402","USDC","Base","MCP","OpenAPI","agents","carbon","EV charging"],"homepage_url":"https://energy.netzhandwerker.de","discovery_url":"https://energy.netzhandwerker.de/discovery-status","starter_url":"https://energy.netzhandwerker.de/agent-starter.json","x402_manifest_url":"https://energy.netzhandwerker.de/.well-known/x402.json","agent_manifest_url":"https://energy.netzhandwerker.de/.well-known/agent.json","openapi_url":"https://energy.netzhandwerker.de/openapi.json","mcp_url":"https://energy.netzhandwerker.de/mcp","llms_url":"https://energy.netzhandwerker.de/llms.txt","cheapest_test_call":{"method":"GET","url":"https://energy.netzhandwerker.de/demo/paid-sample","path":"/demo/paid-sample","price_usdc":"0.001","payment_required":true,"purpose":"Machine-readable discovery for the x402 sample endpoint. The actual access flow is gated by x402 payment."},"recommended_paid_call":{"method":"POST","url":"https://energy.netzhandwerker.de/energy/decision","path":"/energy/decision","price_usdc":"0.01","payment_required":true,"purpose":"Central premium decision endpoint. Use it if you want one paid answer instead of combining multiple raw data and signal endpoints."},"demand_submit_call":{"method":"POST","url":"https://energy.netzhandwerker.de/demand/submit","path":"/demand/submit","price_usdc":"0.001","payment_required":true,"purpose":"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."},"payment":{"protocol":"x402","network":"Base Mainnet","network_id":"eip155:8453","chain_id":8453,"asset":"USDC","no_api_keys":true,"no_accounts":true}}}