{"openapi":"3.1.0","info":{"title":"HALOWERK Energy","version":"3.0.0","summary":"Strompreis-Prognose, Negativpreis-Wahrscheinlichkeit und Dispatch-Entscheidungen für Batterie-, EV- und Trading-Agenten.","description":"Strompreis-Prognose, Negativpreis-Wahrscheinlichkeit und Dispatch-Entscheidungen für Batterie-, EV- und Trading-Agenten.\n\nPaid per call over x402 in USDC on Base Mainnet. Call a route without a payment header to receive the 402 challenge; it costs nothing and triggers no work.","contact":{"name":"Die Netzhandwerker","email":"api@halowerk.com","url":"https://halowerk.com/impressum"},"x-payment":{"protocol":"x402","network":"eip155:8453","asset":"USDC","asset_address":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","pay_to":"0x2880EdfFF13100677Bf97A3CBdF3Bc34771C4E5E","request_header":"PAYMENT-SIGNATURE"}},"servers":[{"url":"https://energy.halowerk.com"}],"paths":{"/v3/dispatch-plan":{"post":{"operationId":"v3_dispatch_plan","summary":"Buy an executable dispatch plan","description":"Schedules a deadline-bound compute, DePIN, battery or power-trading workload into an actionable German or European power window. Returns exact timing, expected EUR cost and savings, uncertainty, freshness, expiry and decision trace.","x-input-schema-url":"https://energy.halowerk.com/v3/dispatch-plan/schema","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["opportunity_id","power_kw","energy_kwh","deadline","risk_profile"],"properties":{"opportunity_id":{"type":"string"},"power_kw":{"type":"number","exclusiveMinimum":0},"energy_kwh":{"type":"number","exclusiveMinimum":0},"deadline":{"type":"string","format":"date-time"},"risk_profile":{"type":"string","enum":["conservative","balanced","aggressive"]},"constraints":{"type":"object","properties":{"earliest_start":{"type":"string","format":"date-time"},"latest_end":{"type":"string","format":"date-time"},"max_price_eur_mwh":{"type":"number","minimum":-1000,"maximum":10000},"must_run_continuously":{"type":"boolean","const":true}},"additionalProperties":false}},"additionalProperties":false},"example":{"opportunity_id":"bazaar_discovery_probe","power_kw":25,"energy_kwh":50,"deadline":"2099-01-01T06:00:00.000Z","risk_profile":"balanced","constraints":{"must_run_continuously":true}}}}},"responses":{"200":{"description":"Result. Settled.","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Request body does not match inputSchema. Nothing settled."},"402":{"description":"Payment required — 0.02 USDC (per_request). The challenge carries accepts, description and inputSchema."},"500":{"description":"Internal error. Nothing settled."}}}},"/v3/dispatch-plan/schema":{"get":{"operationId":"endpoint_schema","summary":"Input schema and a valid example body. Free.","responses":{"200":{"description":"Schema and example."}}}},"/v3/market-brief":{"post":{"operationId":"v3_market_brief","summary":"Buy a timestamped EU market brief","description":"Returns licensed ENTSO-E and SMARD spot-market context for compute, DePIN, battery and power-trading agents: published day-ahead prices, volatility, load, renewable share when available, the observed share of published negative-price hours, uncertainty, freshness and expiry.","x-input-schema-url":"https://energy.halowerk.com/v3/market-brief/schema","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["region","horizon_hours","use_case"],"properties":{"region":{"type":"string","example":"DE-LU"},"horizon_hours":{"type":"integer","minimum":1,"maximum":48},"use_case":{"type":"string","enum":["compute","depin","battery","trading"]}},"additionalProperties":false},"example":{"region":"DE-LU","horizon_hours":24,"use_case":"trading"}}}},"responses":{"200":{"description":"Result. Settled.","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Request body does not match inputSchema. Nothing settled."},"402":{"description":"Payment required — 0.05 USDC (per_request). The challenge carries accepts, description and inputSchema."},"500":{"description":"Internal error. Nothing settled."}}}},"/v3/market-brief/schema":{"get":{"operationId":"endpoint_schema","summary":"Input schema and a valid example body. Free.","responses":{"200":{"description":"Schema and example."}}}},"/research":{"get":{"operationId":"research","summary":"Research Payment Requirements","description":"GET-Fallback mit maschinenlesbarer 402-Antwort für POST /research.","x-input-schema-url":"https://energy.halowerk.com/research/schema?method=GET","responses":{"200":{"description":"Result. Settled.","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Request body does not match inputSchema. Nothing settled."},"402":{"description":"Payment required — 0.05 USDC (per_request). The challenge carries accepts, description and inputSchema."},"500":{"description":"Internal error. Nothing settled."}}},"post":{"operationId":"research_post","summary":"Energy Research","description":"Aggregierte Energie-Recherche für DE/EU aus Live-Datenquellen.","x-input-schema-url":"https://energy.halowerk.com/research/schema?method=POST","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["query"],"properties":{"query":{"type":"string","minLength":1},"sources":{"type":"array","items":{"type":"string"}}},"additionalProperties":false},"example":{"query":"German electricity market summary today"}}}},"responses":{"200":{"description":"Result. Settled.","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Request body does not match inputSchema. Nothing settled."},"402":{"description":"Payment required — 0.05 USDC (per_request). The challenge carries accepts, description and inputSchema."},"500":{"description":"Internal error. Nothing settled."}}}},"/research/schema":{"get":{"operationId":"endpoint_schema","summary":"Input schema and a valid example body. Free.","responses":{"200":{"description":"Schema and example."}}}},"/articles/{id}":{"get":{"operationId":"articles_id","summary":"Article Payment Requirements","description":"GET-Fallback mit maschinenlesbarer 402-Antwort für POST /articles/{id}.","x-input-schema-url":"https://energy.halowerk.com/articles/{id}/schema?method=GET","responses":{"200":{"description":"Result. Settled.","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Request body does not match inputSchema. Nothing settled."},"402":{"description":"Payment required — 0.01 USDC (per_request). The challenge carries accepts, description and inputSchema."},"500":{"description":"Internal error. Nothing settled."}}},"post":{"operationId":"articles_id_post","summary":"Premium Artikel","description":"Volltext eines Energie-Fachartikels.","x-input-schema-url":"https://energy.halowerk.com/articles/{id}/schema?method=POST","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{},"additionalProperties":false},"example":{}}}},"responses":{"200":{"description":"Result. Settled.","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Request body does not match inputSchema. Nothing settled."},"402":{"description":"Payment required — 0.01 USDC (per_request). The challenge carries accepts, description and inputSchema."},"500":{"description":"Internal error. Nothing settled."}}}},"/articles/{id}/schema":{"get":{"operationId":"endpoint_schema","summary":"Input schema and a valid example body. Free.","responses":{"200":{"description":"Schema and example."}}}},"/tasks":{"get":{"operationId":"tasks","summary":"Task Payment Requirements","description":"GET-Fallback mit maschinenlesbarer 402-Antwort für POST /tasks.","x-input-schema-url":"https://energy.halowerk.com/tasks/schema?method=GET","responses":{"200":{"description":"Result. Settled.","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Request body does not match inputSchema. Nothing settled."},"402":{"description":"Payment required — 0.10 USDC (per_request). The challenge carries accepts, description and inputSchema."},"500":{"description":"Internal error. Nothing settled."}}},"post":{"operationId":"tasks_post","summary":"Async Bounty Task","description":"Asynchroner Deep-Dive Task mit Mindest-Bounty.","x-input-schema-url":"https://energy.halowerk.com/tasks/schema?method=POST","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["task_description","bounty"],"properties":{"task_description":{"type":"string","minLength":1},"bounty":{"type":"string","pattern":"^(?:100(?:\\.0+)?|(?:[1-9][0-9]?)(?:\\.[0-9]+)?|0\\.(?:1[0-9]*|[2-9][0-9]*))$","description":"Minimum 0.10 USDC, maximum 100.00 USDC."}},"additionalProperties":false},"example":{"task_description":"Deep research on German battery arbitrage","bounty":"0.10"}}}},"responses":{"200":{"description":"Result. Settled.","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Request body does not match inputSchema. Nothing settled."},"402":{"description":"Payment required — 0.10 USDC (per_request). The challenge carries accepts, description and inputSchema."},"500":{"description":"Internal error. Nothing settled."}}}},"/tasks/schema":{"get":{"operationId":"endpoint_schema","summary":"Input schema and a valid example body. Free.","responses":{"200":{"description":"Schema and example."}}}},"/demo/paid-sample":{"get":{"operationId":"demo_paid_sample","summary":"x402 Paid Signal Test","description":"Cheapest end-to-end x402 purchase test. Always returns a 402 challenge without payment and the current full NegPrice decision after a valid USDC payment.","x-input-schema-url":"https://energy.halowerk.com/demo/paid-sample/schema","responses":{"200":{"description":"Result. Settled.","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Request body does not match inputSchema. Nothing settled."},"402":{"description":"Payment required — 0.001 USDC (per_request). The challenge carries accepts, description and inputSchema."},"500":{"description":"Internal error. Nothing settled."}}}},"/demo/paid-sample/schema":{"get":{"operationId":"endpoint_schema","summary":"Input schema and a valid example body. Free.","responses":{"200":{"description":"Schema and example."}}}},"/energy/decision":{"post":{"operationId":"energy_decision","summary":"Energy Decision","description":"EV, battery, and flexible-load agents buy this endpoint to receive an executable action with timing, expected value, confidence, and expiry.","x-input-schema-url":"https://energy.halowerk.com/energy/decision/schema","requestBody":{"required":true,"content":{"application/json":{"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"},"policy_profile":{"type":"string","enum":["balanced","utility","precision","recall"],"description":"Optional override. Trading defaults to precision; flexible devices default to utility."},"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"}},"additionalProperties":false}},"additionalProperties":false},"example":{"goal":"minimize_cost","device":"ev","location":"Germany","duration_hours":2,"constraints":{"target_soc":80,"max_power_kw":11}}}}},"responses":{"200":{"description":"Result. Settled.","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Request body does not match inputSchema. Nothing settled."},"402":{"description":"Payment required — 0.01 USDC (per_request). The challenge carries accepts, description and inputSchema."},"500":{"description":"Internal error. Nothing settled."}}}},"/energy/decision/schema":{"get":{"operationId":"endpoint_schema","summary":"Input schema and a valid example body. Free.","responses":{"200":{"description":"Schema and example."}}}},"/research/quick":{"post":{"operationId":"research_quick","summary":"Quick Research","description":"Research and market-monitoring agents buy this endpoint to answer a focused question with a compact live market snapshot.","x-input-schema-url":"https://energy.halowerk.com/research/quick/schema","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["query"],"properties":{"query":{"type":"string","minLength":1},"sources":{"type":"array","items":{"type":"string"}}},"additionalProperties":false},"example":{"query":"Summarize the German electricity market for the next 24 hours."}}}},"responses":{"200":{"description":"Result. Settled.","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Request body does not match inputSchema. Nothing settled."},"402":{"description":"Payment required — 0.003 USDC (per_request). The challenge carries accepts, description and inputSchema."},"500":{"description":"Internal error. Nothing settled."}}}},"/research/quick/schema":{"get":{"operationId":"endpoint_schema","summary":"Input schema and a valid example body. Free.","responses":{"200":{"description":"Schema and example."}}}},"/price/spot":{"post":{"operationId":"price_spot","summary":"Spotpreis jetzt","description":"Trading and dispatch agents buy this endpoint to obtain the current German EPEX spot price for immediate decisions.","x-input-schema-url":"https://energy.halowerk.com/price/spot/schema","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{},"additionalProperties":false},"example":{}}}},"responses":{"200":{"description":"Result. Settled.","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Request body does not match inputSchema. Nothing settled."},"402":{"description":"Payment required — 0.001 USDC (per_request). The challenge carries accepts, description and inputSchema."},"500":{"description":"Internal error. Nothing settled."}}}},"/price/spot/schema":{"get":{"operationId":"endpoint_schema","summary":"Input schema and a valid example body. Free.","responses":{"200":{"description":"Schema and example."}}}},"/price/forecast":{"post":{"operationId":"price_forecast","summary":"24h Preis-Forecast","description":"Energy-trading and flexible-load agents buy this endpoint to compare the next 24 hours of EPEX prices and volatility.","x-input-schema-url":"https://energy.halowerk.com/price/forecast/schema","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{},"additionalProperties":false},"example":{}}}},"responses":{"200":{"description":"Result. Settled.","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Request body does not match inputSchema. Nothing settled."},"402":{"description":"Payment required — 0.005 USDC (per_request). The challenge carries accepts, description and inputSchema."},"500":{"description":"Internal error. Nothing settled."}}}},"/price/forecast/schema":{"get":{"operationId":"endpoint_schema","summary":"Input schema and a valid example body. Free.","responses":{"200":{"description":"Schema and example."}}}},"/carbon/now":{"post":{"operationId":"carbon_now","summary":"CO2-Intensität jetzt","description":"Aktuelle CO2-Intensität des deutschen Strommix.","x-input-schema-url":"https://energy.halowerk.com/carbon/now/schema","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{},"additionalProperties":false},"example":{}}}},"responses":{"200":{"description":"Result. Settled.","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Request body does not match inputSchema. Nothing settled."},"402":{"description":"Payment required — 0.001 USDC (per_request). The challenge carries accepts, description and inputSchema."},"500":{"description":"Internal error. Nothing settled."}}}},"/carbon/now/schema":{"get":{"operationId":"endpoint_schema","summary":"Input schema and a valid example body. Free.","responses":{"200":{"description":"Schema and example."}}}},"/grid/load":{"post":{"operationId":"grid_load","summary":"Netzlast","description":"Grid-monitoring and dispatch agents buy this endpoint to obtain the latest German system load from SMARD.","x-input-schema-url":"https://energy.halowerk.com/grid/load/schema","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{},"additionalProperties":false},"example":{}}}},"responses":{"200":{"description":"Result. Settled.","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Request body does not match inputSchema. Nothing settled."},"402":{"description":"Payment required — 0.001 USDC (per_request). The challenge carries accepts, description and inputSchema."},"500":{"description":"Internal error. Nothing settled."}}}},"/grid/load/schema":{"get":{"operationId":"endpoint_schema","summary":"Input schema and a valid example body. Free.","responses":{"200":{"description":"Schema and example."}}}},"/renewable/share":{"post":{"operationId":"renewable_share","summary":"Erneuerbare Anteil","description":"Carbon-aware and ESG agents buy this endpoint to measure the current renewable share and generation mix in Germany.","x-input-schema-url":"https://energy.halowerk.com/renewable/share/schema","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{},"additionalProperties":false},"example":{}}}},"responses":{"200":{"description":"Result. Settled.","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Request body does not match inputSchema. Nothing settled."},"402":{"description":"Payment required — 0.001 USDC (per_request). The challenge carries accepts, description and inputSchema."},"500":{"description":"Internal error. Nothing settled."}}}},"/renewable/share/schema":{"get":{"operationId":"endpoint_schema","summary":"Input schema and a valid example body. Free.","responses":{"200":{"description":"Schema and example."}}}},"/flexibility/window":{"post":{"operationId":"flexibility_window","summary":"Flexibility Window","description":"EV, heat-pump, and flexible-load agents buy this endpoint to identify the cheapest upcoming operating hours.","x-input-schema-url":"https://energy.halowerk.com/flexibility/window/schema","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{},"additionalProperties":false},"example":{}}}},"responses":{"200":{"description":"Result. Settled.","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Request body does not match inputSchema. Nothing settled."},"402":{"description":"Payment required — 0.01 USDC (per_request). The challenge carries accepts, description and inputSchema."},"500":{"description":"Internal error. Nothing settled."}}}},"/flexibility/window/schema":{"get":{"operationId":"endpoint_schema","summary":"Input schema and a valid example body. Free.","responses":{"200":{"description":"Schema and example."}}}},"/signals/buy-sell":{"post":{"operationId":"signals_buy_sell","summary":"Buy/Sell Signal","description":"Trading bots buy this endpoint to receive a multi-factor buy/sell signal with RSI, Z-score, trend, and confidence.","x-input-schema-url":"https://energy.halowerk.com/signals/buy-sell/schema","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{},"additionalProperties":false},"example":{}}}},"responses":{"200":{"description":"Result. Settled.","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Request body does not match inputSchema. Nothing settled."},"402":{"description":"Payment required — 0.02 USDC (per_request). The challenge carries accepts, description and inputSchema."},"500":{"description":"Internal error. Nothing settled."}}}},"/signals/buy-sell/schema":{"get":{"operationId":"endpoint_schema","summary":"Input schema and a valid example body. Free.","responses":{"200":{"description":"Schema and example."}}}},"/bundle/trading":{"post":{"operationId":"bundle_trading","summary":"Trading Bundle","description":"Energy-trading agents buy this endpoint to receive an eight-source market bundle with key metrics, insights, and raw evidence.","x-input-schema-url":"https://energy.halowerk.com/bundle/trading/schema","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["query"],"properties":{"query":{"type":"string","minLength":1},"sources":{"type":"array","items":{"type":"string"}}},"additionalProperties":false},"example":{"query":"Assess DE-LU day-ahead trading conditions for the next 24 hours."}}}},"responses":{"200":{"description":"Result. Settled.","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Request body does not match inputSchema. Nothing settled."},"402":{"description":"Payment required — 0.02 USDC (per_request). The challenge carries accepts, description and inputSchema."},"500":{"description":"Internal error. Nothing settled."}}}},"/bundle/trading/schema":{"get":{"operationId":"endpoint_schema","summary":"Input schema and a valid example body. Free.","responses":{"200":{"description":"Schema and example."}}}},"/history/prices":{"post":{"operationId":"history_prices","summary":"Historische Preise","description":"Stundendaten für EPEX-Preise nach Periode.","x-input-schema-url":"https://energy.halowerk.com/history/prices/schema","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["period"],"properties":{"period":{"type":"string","pattern":"^(?:last-[1-9][0-9]*d|[0-9]{4}(?:-Q[1-4]|-(?:0[1-9]|1[0-2]))?)$","examples":["last-7d","last-30d","2025-Q4","2024-01"]}},"additionalProperties":false},"example":{"period":"last-7d"}}}},"responses":{"200":{"description":"Result. Settled.","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Request body does not match inputSchema. Nothing settled."},"402":{"description":"Payment required — 0.05 USDC (per_request). The challenge carries accepts, description and inputSchema."},"500":{"description":"Internal error. Nothing settled."}}}},"/history/prices/schema":{"get":{"operationId":"endpoint_schema","summary":"Input schema and a valid example body. Free.","responses":{"200":{"description":"Schema and example."}}}},"/history/prices/stats":{"post":{"operationId":"history_prices_stats","summary":"Preisstatistik","description":"Statistik für eine historische Preisperiode.","x-input-schema-url":"https://energy.halowerk.com/history/prices/stats/schema","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["period"],"properties":{"period":{"type":"string","pattern":"^(?:last-[1-9][0-9]*d|[0-9]{4}(?:-Q[1-4]|-(?:0[1-9]|1[0-2]))?)$","examples":["last-7d","last-30d","2025-Q4","2024-01"]}},"additionalProperties":false},"example":{"period":"last-7d"}}}},"responses":{"200":{"description":"Result. Settled.","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Request body does not match inputSchema. Nothing settled."},"402":{"description":"Payment required — 0.01 USDC (per_request). The challenge carries accepts, description and inputSchema."},"500":{"description":"Internal error. Nothing settled."}}}},"/history/prices/stats/schema":{"get":{"operationId":"endpoint_schema","summary":"Input schema and a valid example body. Free.","responses":{"200":{"description":"Schema and example."}}}},"/subscribe/price-alert":{"post":{"operationId":"subscribe_price_alert","summary":"Price Alert Subscription","description":"Webhook-Subscription für Strompreis-Thresholds.","x-input-schema-url":"https://energy.halowerk.com/subscribe/price-alert/schema","requestBody":{"required":true,"content":{"application/json":{"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"]}},"additionalProperties":false},"example":{"webhook_url":"https://agent.example/webhooks/energy"}}}},"responses":{"200":{"description":"Result. Settled.","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Request body does not match inputSchema. Nothing settled."},"402":{"description":"Payment required — 0.10 USDC (per_request). The challenge carries accepts, description and inputSchema."},"500":{"description":"Internal error. Nothing settled."}}}},"/subscribe/price-alert/schema":{"get":{"operationId":"endpoint_schema","summary":"Input schema and a valid example body. Free.","responses":{"200":{"description":"Schema and example."}}}},"/subscribe/co2-low":{"post":{"operationId":"subscribe_co2_low","summary":"CO2 Low Subscription","description":"Webhook-Subscription für niedrige CO2-Intensität.","x-input-schema-url":"https://energy.halowerk.com/subscribe/co2-low/schema","requestBody":{"required":true,"content":{"application/json":{"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"]}},"additionalProperties":false},"example":{"webhook_url":"https://agent.example/webhooks/energy"}}}},"responses":{"200":{"description":"Result. Settled.","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Request body does not match inputSchema. Nothing settled."},"402":{"description":"Payment required — 0.10 USDC (per_request). The challenge carries accepts, description and inputSchema."},"500":{"description":"Internal error. Nothing settled."}}}},"/subscribe/co2-low/schema":{"get":{"operationId":"endpoint_schema","summary":"Input schema and a valid example body. Free.","responses":{"200":{"description":"Schema and example."}}}},"/optimizer/cheapest-window":{"post":{"operationId":"optimizer_cheapest_window","summary":"Cheapest Window","description":"Flexible-load agents buy this endpoint to schedule a contiguous operating window at the lowest average electricity price.","x-input-schema-url":"https://energy.halowerk.com/optimizer/cheapest-window/schema","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"duration_hours":{"type":"integer","minimum":1,"maximum":24,"default":2}},"additionalProperties":false},"example":{"duration_hours":2}}}},"responses":{"200":{"description":"Result. Settled.","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Request body does not match inputSchema. Nothing settled."},"402":{"description":"Payment required — 0.005 USDC (per_request). The challenge carries accepts, description and inputSchema."},"500":{"description":"Internal error. Nothing settled."}}}},"/optimizer/cheapest-window/schema":{"get":{"operationId":"endpoint_schema","summary":"Input schema and a valid example body. Free.","responses":{"200":{"description":"Schema and example."}}}},"/price/negative-forecast":{"post":{"operationId":"price_negative_forecast","summary":"Negative Price Forecast","description":"Stunden mit negativen Strompreisen in den nächsten 24 Stunden.","x-input-schema-url":"https://energy.halowerk.com/price/negative-forecast/schema","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{},"additionalProperties":false},"example":{}}}},"responses":{"200":{"description":"Result. Settled.","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Request body does not match inputSchema. Nothing settled."},"402":{"description":"Payment required — 0.005 USDC (per_request). The challenge carries accepts, description and inputSchema."},"500":{"description":"Internal error. Nothing settled."}}}},"/price/negative-forecast/schema":{"get":{"operationId":"endpoint_schema","summary":"Input schema and a valid example body. Free.","responses":{"200":{"description":"Schema and example."}}}},"/predict/negative-price":{"post":{"operationId":"predict_negative_price","summary":"Buy Current Negative Price Signal","description":"Battery, EV, and trading agents buy this endpoint to receive calibrated 2h/4h/6h negative-price probabilities, reviewed threshold profiles and an executable response policy.","x-input-schema-url":"https://energy.halowerk.com/predict/negative-price/schema","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"policy_profile":{"type":"string","enum":["balanced","utility","precision","recall"],"default":"balanced","description":"Selects the reviewed probability threshold profile without changing the underlying calibrated probabilities."}},"additionalProperties":false},"example":{"policy_profile":"balanced"}}}},"responses":{"200":{"description":"Result. Settled.","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Request body does not match inputSchema. Nothing settled."},"402":{"description":"Payment required — 0.001 USDC (per_request). The challenge carries accepts, description and inputSchema."},"500":{"description":"Internal error. Nothing settled."}}}},"/predict/negative-price/schema":{"get":{"operationId":"endpoint_schema","summary":"Input schema and a valid example body. Free.","responses":{"200":{"description":"Schema and example."}}}},"/summary/today":{"post":{"operationId":"summary_today","summary":"Daily Summary","description":"Token-effiziente Tageszusammenfassung mit konkreter Handlungsempfehlung.","x-input-schema-url":"https://energy.halowerk.com/summary/today/schema","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{},"additionalProperties":false},"example":{}}}},"responses":{"200":{"description":"Result. Settled.","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Request body does not match inputSchema. Nothing settled."},"402":{"description":"Payment required — 0.01 USDC (per_request). The challenge carries accepts, description and inputSchema."},"500":{"description":"Internal error. Nothing settled."}}}},"/summary/today/schema":{"get":{"operationId":"endpoint_schema","summary":"Input schema and a valid example body. Free.","responses":{"200":{"description":"Schema and example."}}}},"/region":{"post":{"operationId":"region","summary":"Regionale Energiedaten","description":"Preis, CO2, Grünstrom und Wetter für eine PLZ-Region.","x-input-schema-url":"https://energy.halowerk.com/region/schema","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["plz"],"properties":{"plz":{"type":"string","pattern":"^[0-9]{5}$"}},"additionalProperties":false},"example":{"plz":"48599"}}}},"responses":{"200":{"description":"Result. Settled.","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Request body does not match inputSchema. Nothing settled."},"402":{"description":"Payment required — 0.005 USDC (per_request). The challenge carries accepts, description and inputSchema."},"500":{"description":"Internal error. Nothing settled."}}}},"/region/schema":{"get":{"operationId":"endpoint_schema","summary":"Input schema and a valid example body. Free.","responses":{"200":{"description":"Schema and example."}}}},"/events/grid":{"post":{"operationId":"events_grid","summary":"Grid Events","description":"Ereignisfeed für Dunkelflaute, Sturm, negative Preise und Rekorde.","x-input-schema-url":"https://energy.halowerk.com/events/grid/schema","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{},"additionalProperties":false},"example":{}}}},"responses":{"200":{"description":"Result. Settled.","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Request body does not match inputSchema. Nothing settled."},"402":{"description":"Payment required — 0.005 USDC (per_request). The challenge carries accepts, description and inputSchema."},"500":{"description":"Internal error. Nothing settled."}}}},"/events/grid/schema":{"get":{"operationId":"endpoint_schema","summary":"Input schema and a valid example body. Free.","responses":{"200":{"description":"Schema and example."}}}},"/next-actions":{"get":{"operationId":"meta_next_actions","summary":"Free agent surface. No payment, no authentication.","responses":{"200":{"description":"ok"}}}}}}