{"uid":"cap_A5T7UKcrKbZ5uvEFnNgIz","slug":"netzhandwerker-energy-decision-api-a40d8c6c","name":"Netzhandwerker Energy Decision API","description":"One x402 call returns the action, best time window, expected EUR value, confidence and expiry for German and European electricity decisions. USDC on Base, no API key or account.","url":"https://energy.netzhandwerker.de/energy/decision","method":"POST","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method","bodyType","body"],"properties":{"body":{"type":"object","properties":{"goal":{"enum":["minimize_cost","minimize_carbon","balanced","maximize_self_consumption","trading_signal"],"type":"string","default":"balanced"},"device":{"enum":["ev","battery","heat_pump","flexible_load","generic"],"type":"string","default":"generic"},"deadline":{"type":"string"},"location":{"type":"string","default":"Germany"},"constraints":{"type":"object","properties":{"min_soc":{"type":"number"},"target_soc":{"type":"number"},"max_power_kw":{"type":"number"},"must_finish_by":{"type":"string"}},"additionalProperties":false},"duration_hours":{"type":"integer","default":4,"maximum":24,"minimum":1},"policy_profile":{"enum":["balanced","utility","precision","recall"],"type":"string","description":"Optional override. Trading defaults to precision; flexible devices default to utility."}},"additionalProperties":false},"type":{"type":"string","const":"http"},"method":{"enum":["POST","PUT","PATCH"],"type":"string"},"bodyType":{"enum":["json","form-data","text"],"type":"string"}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["ok","endpoint","result"],"properties":{"ok":{"type":"boolean"},"result":{"type":"object","required":["schema_version","decision_id","action","confidence","expires_at","risk_flags"],"properties":{"action":{"type":"string"},"confidence":{"type":"number"},"expires_at":{"type":["string","null"]},"risk_flags":{"type":"array","items":{"type":"string"}},"decision_id":{"type":"string"},"schema_version":{"type":"string"},"estimated_value":{"type":"object"},"recommended_window":{"type":["object","null"]}},"additionalProperties":true},"endpoint":{"type":"string"}},"additionalProperties":true}}}}},"responseSchema":{"type":"json","example":{"ok":true,"result":{"action":"charge_later","confidence":0.74,"expires_at":"2026-07-12T13:00:00.000Z","risk_flags":[],"decision_id":"dec_example_001","schema_version":"energy_decision_v1","estimated_value":{"currency":"EUR","expected_saving":1.82},"recommended_window":{"end":"2026-07-12T17:00:00.000Z","start":"2026-07-12T13:00:00.000Z"}},"endpoint":"/energy/decision"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"registry","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_q4Sa90j73SYjU8dWeOm28","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns an AI-optimized energy action recommendation — including live electricity prices, carbon intensity, grid flexibility windows, battery arbitrage signals, and ESG data — given a device, goal, location, and deadline.","exampleAgentPrompt":"I want to charge my Tesla in Berlin tonight — what's the best 2-hour window in the next 8 hours to minimize both cost and carbon emissions, and are there any grid flexibility constraints I should know about?","exampleUseCases":[{"title":"Industrial facility load shifting scheduling","prompt":"Our factory in Munich has 500 kW of flexible load that can run anytime tomorrow — find me the optimal 4-hour window that gives us the cheapest electricity and the best renewable energy mix, and tell me how much we could save versus running it now."},{"title":"Home battery arbitrage trading","prompt":"I have a 10 kWh home battery in Stuttgart that's currently charged — should I discharge it onto the grid right now, or should I wait for a better price signal in the next few hours? Also let me know if there's a grid flexibility request that could help me earn extra from the arbitrage."},{"title":"Laundry and heating optimization","prompt":"I need to run my washing machine and heat my apartment tomorrow in Cologne — can you find me a single time window where electricity is cheapest and the grid has the highest share of renewables, and tell me how much carbon I'd save by waiting for that window instead of doing it right now?"}],"resultDescription":"A structured decision response containing the recommended action or optimal time window for the specified device and goal, backed by live electricity price data, carbon intensity scores, current grid load, renewable energy share, identified flexibility windows, battery arbitrage signals, and ESG metrics for the specified location and time horizon.","failureModes":["Unsupported location returns empty or null grid data","Deadline in the past causes invalid scheduling response","Unknown device type may result in generic rather than device-specific recommendations","Missing required 'goal' field causes a 400 bad request","Location outside covered grid zones returns no data or error","Constraints object with conflicting rules may produce suboptimal or null recommendations"],"whenToPreferThis":"Choose this endpoint when you need a holistic, AI-ready energy action decision that combines live market prices, carbon intensity, grid state, and flexibility signals into a single actionable recommendation. Prefer this over pure price APIs when you also need carbon/ESG context, battery arbitrage guidance, or device-specific scheduling optimization.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T12:42:36.530Z","isFirstParty":false}