{"uid":"cap_a8FHGGczKWgscv6A1ipjf","slug":"netzhandwerker-cheapest-window-optimizer-e2e46089","name":"Netzhandwerker Cheapest Window Optimizer","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/optimizer/cheapest-window","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":{"duration_hours":{"type":"integer","default":2,"maximum":24,"minimum":1}},"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"}}}}},"responseSchema":{"type":"json","example":{"action":"charge_during_window","source":"Cheapest Window Optimizer","window":[{"end":"2026-07-14T12:00:00.000Z","price":5.18,"start":"2026-07-14T11:00:00.000Z"},{"end":"2026-07-14T13:00:00.000Z","price":5.77,"start":"2026-07-14T12:00:00.000Z"}],"best_end":"2026-07-14T13:00:00.000Z","timestamp":"2026-07-13T22:51:21.971Z","best_start":"2026-07-14T11:00:00.000Z","day_avg_ct_kwh":"12.397","duration_hours":2,"avg_price_ct_kwh":"5.475","savings_vs_avg_pct":"55.8"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","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.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_4qg1lLLaN8hRyxSr3Mivb","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Finds the cheapest electricity price window for a given duration of hours using live grid data","exampleAgentPrompt":"Find the cheapest 3-hour electricity window available today so I can schedule my EV charger to run during the lowest-cost period.","exampleUseCases":[{"title":"Optimize heat pump runtime for cost savings","prompt":"What's the best 2-hour window today to run my heat pump when electricity is cheapest? I want to minimize my heating costs."},{"title":"Schedule dishwasher during low-price hours","prompt":"When should I start my dishwasher tonight to catch the lowest electricity prices? I need about 3 hours for the full cycle."},{"title":"Automate demand response battery charging","prompt":"Find me the optimal 4-hour slot today when the grid electricity is most affordable so I can charge my home battery and reduce my energy expenses."}],"resultDescription":"Returns the optimal time window (start and end times) during which electricity is cheapest for the requested duration, along with associated price data to support scheduling decisions.","failureModes":["Invalid or missing duration_hours — returns 400 with validation error","duration_hours exceeds available forecast horizon — returns error or truncated window","Live grid data unavailable — service may return 503 or stale data warning","Payment not included or insufficient — x402 payment required error","duration_hours is zero or negative — rejected with validation error"],"whenToPreferThis":"Use this endpoint when an AI agent needs to schedule flexible electrical loads (EV charging, battery charging, heat pumps, appliances) during the lowest-cost electricity hours. Ideal for home energy management, demand response automation, and cost-optimization workflows where the agent needs a concrete actionable time window rather than raw price timeseries.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T18:48:29.424Z","isFirstParty":false}