{"openapi":"3.1.0","info":{"title":"EU Power Dispatch API for Compute, DePIN, Batteries and Trading","version":"3.0.0","description":"Run a public preflight for a deadline-bound German or European workload, then buy an executable dispatch plan or timestamped market brief with USDC on Base.","contact":{"name":"Die Netzhandwerker","email":"info@netzhandwerker.de","url":"https://netzhandwerker.de"},"x-guidance":"Call GET /v3/opportunities first for a non-payable value and freshness preflight. Use its opportunity_id immediately with POST /v3/dispatch-plan when exact workload timing is needed. Use POST /v3/market-brief for a regional 6-48 hour market view. Paid routes return an x402 V2 Payment-Required challenge for USDC on Base Mainnet; retry the identical request with Payment-Signature. Treat expires_at and source_timestamps as hard freshness limits.","license":{"name":"Proprietary"}},"servers":[{"url":"https://energy.halowerk.com"}],"externalDocs":{"description":"Copy-paste x402 purchase quickstart with verified Node.js, Python, and curl flows","url":"https://energy.halowerk.com/examples/quickstart"},"x-purchase-examples":{"quickstart":"https://energy.halowerk.com/examples/quickstart","nodejs":"https://energy.halowerk.com/examples/buy-nodejs","python":"https://energy.halowerk.com/examples/buy-python","curl":"https://energy.halowerk.com/examples/buy-curl","signing_helper":"https://energy.halowerk.com/examples/sign-eip3009.mjs"},"components":{"securitySchemes":{"x402":{"type":"apiKey","in":"header","name":"PAYMENT-SIGNATURE","description":"Canonical x402 payment proof header. Production uses Base Mainnet (eip155:8453), chain 8453, USDC."}},"schemas":{"PaymentRequired":{"type":"object","required":["x402Version","error","resource","accepts"],"properties":{"x402Version":{"type":"integer","enum":[2]},"error":{"type":"string"},"resource":{"type":"object","additionalProperties":true},"accepts":{"type":"array","minItems":1,"items":{"type":"object","required":["scheme","network","amount","asset","payTo","maxTimeoutSeconds"],"properties":{"scheme":{"type":"string"},"network":{"type":"string"},"amount":{"type":"string"},"asset":{"type":"string"},"payTo":{"type":"string"},"maxTimeoutSeconds":{"type":"integer"},"extra":{"type":"object","additionalProperties":true}},"additionalProperties":true}},"extensions":{"type":"object","additionalProperties":true},"docs":{"type":"string","format":"uri","example":"https://energy.halowerk.com/examples/quickstart"},"signing_guide":{"type":"string","format":"uri","example":"https://energy.halowerk.com/examples/buy-nodejs"}},"additionalProperties":true}}},"x-service":{"endpoint_count":3,"paid_endpoint_count":2,"free_endpoint_count":1,"payment":{"protocol":"x402","network":"eip155:8453","chain_id":8453,"asset":"USDC","asset_address":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","accepted_tokens":[{"symbol":"USDC","name":"USD Coin","network":"eip155:8453","chain_id":8453,"contract_address":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","decimals":6,"transfer_method":"eip3009"}],"recipient":"0x2880EdfFF13100677Bf97A3CBdF3Bc34771C4E5E","facilitators":{"primary":"CDP","fallback":"https://facilitator.xpay.sh"},"payment_required_header":"PAYMENT-REQUIRED","payment_signature_header":"PAYMENT-SIGNATURE","payment_response_header":"PAYMENT-RESPONSE"},"purchase_examples":{"quickstart":"https://energy.halowerk.com/examples/quickstart","nodejs":"https://energy.halowerk.com/examples/buy-nodejs","python":"https://energy.halowerk.com/examples/buy-python","curl":"https://energy.halowerk.com/examples/buy-curl","signing_helper":"https://energy.halowerk.com/examples/sign-eip3009.mjs"},"full_openapi":"https://energy.halowerk.com/openapi-full.json","trust":"https://energy.halowerk.com/trust/dashboard"},"paths":{"/v3/opportunities":{"get":{"operationId":"gETV3Opportunities","tags":["EU Power Dispatch"],"summary":"Find an energy opportunity","description":"Public preflight for deadline-aware compute, DePIN, battery and power-trading workloads in Germany and Europe. Returns only actionability and value bands; exact execution timing remains in the paid dispatch plan.","security":[],"parameters":[{"name":"region","in":"query","required":true,"schema":{"type":"string","example":"DE-LU"}},{"name":"use_case","in":"query","required":true,"schema":{"type":"string","enum":["compute","depin","battery","trading"]}},{"name":"duration_minutes","in":"query","required":true,"schema":{"type":"integer","minimum":60,"maximum":1440,"multipleOf":60,"description":"Hourly granularity until 15-minute ENTSO-E ingestion is production-verified."}},{"name":"deadline","in":"query","required":true,"schema":{"type":"string","format":"date-time"}},{"name":"power_kw","in":"query","required":false,"schema":{"type":"number","exclusiveMinimum":0}},{"name":"energy_kwh","in":"query","required":false,"schema":{"type":"number","exclusiveMinimum":0}}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"opportunity_id":"opp_example_01","buy_recommended":true,"actionability":"high","expected_savings_band_eur":"1.00-5.00","carbon_band":"unknown","confidence_band":"high","generated_at":"2026-07-30T10:00:00.000Z","expires_at":"2026-07-30T10:15:00.000Z","data_freshness":{"status":"current","source":"ENTSO-E Transparency Platform A44","observed_through":"2026-07-31T22:00:00.000Z","fetched_at":"2026-07-30T09:45:00.000Z","license":"CC BY 4.0","attribution":"ENTSO-E Transparency Platform","licence_scope":"A44 day-ahead prices; DE-LU; preflight"},"paid_endpoint":"https://energy.halowerk.com/v3/dispatch-plan","price_usdc":0.02,"model_version":"dispatch-deterministic-3.0.0"},"schema":{"type":"object","properties":{"opportunity_id":{"type":"string"},"buy_recommended":{"type":"boolean"},"actionability":{"type":"string"},"expected_savings_band_eur":{"type":"string"},"carbon_band":{"type":"string"},"confidence_band":{"type":"string"},"generated_at":{"type":"string"},"expires_at":{"type":"string"},"data_freshness":{"type":"object","properties":{"status":{"type":"string"},"source":{"type":"string"},"observed_through":{"type":"string"},"fetched_at":{"type":"string"},"license":{"type":"string"},"attribution":{"type":"string"},"licence_scope":{"type":"string"}},"required":["status","source","observed_through","fetched_at","license","attribution","licence_scope"],"additionalProperties":true},"paid_endpoint":{"type":"string"},"price_usdc":{"type":"number"},"model_version":{"type":"string"}},"required":["opportunity_id","buy_recommended","actionability","expected_savings_band_eur","carbon_band","confidence_band","generated_at","expires_at","data_freshness","paid_endpoint","price_usdc","model_version"],"additionalProperties":true}}}},"400":{"description":"Invalid region, use case, duration, deadline or energy constraint","content":{"application/json":{"example":{"error":"invalid_region_use_case_duration_deadline_or_energy_constraint"}}}},"404":{"description":"Not found","content":{"application/json":{"example":{"error":"not_found"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"example":{"error":"rate_limit_exceeded"}}}},"500":{"description":"Internal server error","content":{"application/json":{"example":{"error":"internal_server_error"}}}},"503":{"description":"Source is stale, unlicensed, missing or schema-incompatible; no opportunity is created","content":{"application/json":{"example":{"error":"source_is_stale_unlicensed_missing_or_schema_incompatible_no_opportunity_is_created"}}}}}}},"/v3/dispatch-plan":{"post":{"operationId":"pOSTV3DispatchPlan","tags":["EU Power Dispatch"],"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.","security":[{"x402":[]}],"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}}}}},"x-purchase-guide":{"quickstart":"https://energy.halowerk.com/examples/quickstart","nodejs":"https://energy.halowerk.com/examples/buy-nodejs","python":"https://energy.halowerk.com/examples/buy-python","curl":"https://energy.halowerk.com/examples/buy-curl","signing_helper":"https://energy.halowerk.com/examples/sign-eip3009.mjs"},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.02"},"protocols":[{"x402":{}}],"network":"eip155:8453","chain_id":8453,"asset":"USDC","asset_address":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","accepted_tokens":[{"symbol":"USDC","name":"USD Coin","network":"eip155:8453","chain_id":8453,"contract_address":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","decimals":6,"transfer_method":"eip3009"}],"recipient":"0x2880EdfFF13100677Bf97A3CBdF3Bc34771C4E5E","facilitators":{"primary":"CDP","fallback":"https://facilitator.xpay.sh"}},"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"schedule_start":"2026-07-31T01:00:00.000Z","schedule_end":"2026-07-31T03:00:00.000Z","action":"schedule","expected_cost_eur":4.12,"expected_savings_eur":1.38,"baseline_cost_eur":5.5,"expected_carbon_effect":"unknown","confidence":0.95,"uncertainty":{"type":"deterministic_day_ahead_market_data","price_range_eur_mwh":[82.4,82.4],"forecast_signal":"experimental_not_used_for_schedule"},"source_timestamps":{"first_available":"2026-07-30T10:00:00.000Z","last_available":"2026-07-31T22:00:00.000Z","fetched_at":"2026-07-30T09:45:00.000Z","observed_through":"2026-07-31T22:00:00.000Z"},"source_attribution":{"attribution":"ENTSO-E Transparency Platform","licence":"CC BY 4.0","licence_scope":"A44 day-ahead prices; DE-LU; preflight"},"model_version":"dispatch-deterministic-3.0.0","expires_at":"2026-07-30T10:15:00.000Z","risk_flags":[],"decision_trace":["constraints_validated","candidate_windows_ranked","lowest_cost_feasible_window_selected"],"payment_receipt":{"protocol":"x402","network":"eip155:8453","idempotent_replay":false}},"schema":{"type":"object","properties":{"schedule_start":{"type":"string"},"schedule_end":{"type":"string"},"action":{"type":"string"},"expected_cost_eur":{"type":"number"},"expected_savings_eur":{"type":"number"},"baseline_cost_eur":{"type":"number"},"expected_carbon_effect":{"type":"string"},"confidence":{"type":"number"},"uncertainty":{"type":"object","properties":{"type":{"type":"string"},"price_range_eur_mwh":{"type":"array","items":{"type":"number"}},"forecast_signal":{"type":"string"}},"required":["type","price_range_eur_mwh","forecast_signal"],"additionalProperties":true},"source_timestamps":{"type":"object","properties":{"first_available":{"type":"string"},"last_available":{"type":"string"},"fetched_at":{"type":"string"},"observed_through":{"type":"string"}},"required":["first_available","last_available","fetched_at","observed_through"],"additionalProperties":true},"source_attribution":{"type":"object","properties":{"attribution":{"type":"string"},"licence":{"type":"string"},"licence_scope":{"type":"string"}},"required":["attribution","licence","licence_scope"],"additionalProperties":true},"model_version":{"type":"string"},"expires_at":{"type":"string"},"risk_flags":{"type":"array","items":{}},"decision_trace":{"type":"array","items":{"type":"string"}},"payment_receipt":{"type":"object","properties":{"protocol":{"type":"string"},"network":{"type":"string"},"idempotent_replay":{"type":"boolean"}},"required":["protocol","network","idempotent_replay"],"additionalProperties":true}},"required":["schedule_start","schedule_end","action","expected_cost_eur","expected_savings_eur","baseline_cost_eur","expected_carbon_effect","confidence","uncertainty","source_timestamps","source_attribution","model_version","expires_at","risk_flags","decision_trace","payment_receipt"],"additionalProperties":true}}}},"400":{"description":"Invalid technical constraints","content":{"application/json":{"example":{"error":"invalid_technical_constraints"}}}},"402":{"description":"x402 payment required","content":{"application/json":{"example":{"x402Version":2,"error":"payment_required","price_usdc":0.02,"resource":{"url":"https://energy.halowerk.com/v3/dispatch-plan","method":"POST","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.","mimeType":"application/json","serviceName":"EU Power Dispatch API","tags":["compute-scheduling","depin-workloads","carbon-aware-compute","battery-dispatch","power-trading","germany","europe"],"iconUrl":"https://energy.halowerk.com/favicon.svg"},"extensions":{"bazaar":{"info":{"input":{"type":"http","method":"POST","bodyType":"json","body":{"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}}},"output":{"type":"json","example":{"schedule_start":"2026-07-31T01:00:00.000Z","schedule_end":"2026-07-31T03:00:00.000Z","action":"schedule","expected_cost_eur":4.12,"expected_savings_eur":1.38,"baseline_cost_eur":5.5,"expected_carbon_effect":"unknown","confidence":0.95,"uncertainty":{"type":"deterministic_day_ahead_market_data","price_range_eur_mwh":[82.4,82.4],"forecast_signal":"experimental_not_used_for_schedule"},"source_timestamps":{"first_available":"2026-07-30T10:00:00.000Z","last_available":"2026-07-31T22:00:00.000Z","fetched_at":"2026-07-30T09:45:00.000Z","observed_through":"2026-07-31T22:00:00.000Z"},"source_attribution":{"attribution":"ENTSO-E Transparency Platform","licence":"CC BY 4.0","licence_scope":"A44 day-ahead prices; DE-LU; preflight"},"model_version":"dispatch-deterministic-3.0.0","expires_at":"2026-07-30T10:15:00.000Z","risk_flags":[],"decision_trace":["constraints_validated","candidate_windows_ranked","lowest_cost_feasible_window_selected"],"payment_receipt":{"protocol":"x402","network":"eip155:8453","idempotent_replay":false}}}},"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"input":{"type":"object","properties":{"type":{"type":"string","const":"http"},"method":{"type":"string","enum":["POST","PUT","PATCH"]},"bodyType":{"type":"string","enum":["json","form-data","text"]},"body":{"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"},"risk_profile":{"type":"string","enum":["conservative","balanced","aggressive"]},"constraints":{"type":"object","properties":{"earliest_start":{"type":"string"},"latest_end":{"type":"string"},"max_price_eur_mwh":{"type":"number","minimum":-1000,"maximum":10000},"must_run_continuously":{"type":"boolean","const":true}},"additionalProperties":false}},"additionalProperties":false}},"required":["type","method","bodyType","body"],"additionalProperties":false},"output":{"type":"object","properties":{"type":{"type":"string"},"example":{"type":"object"}},"required":["type"]}},"required":["input"]}}},"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},"accepts":[{"scheme":"exact","network":"eip155:8453","amount":"20000","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","payTo":"0x2880EdfFF13100677Bf97A3CBdF3Bc34771C4E5E","maxTimeoutSeconds":300,"extra":{"asset":"USDC","network_name":"Base Mainnet","name":"USD Coin","decimals":6,"assetTransferMethod":"eip3009","version":"2","eip712Domain":{"name":"USD Coin","version":"2","chainId":8453,"verifyingContract":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"}}}],"payment_headers":{"retry_with":"PAYMENT-SIGNATURE","challenge":"PAYMENT-REQUIRED","response":"PAYMENT-RESPONSE"},"docs":"https://energy.halowerk.com/examples/quickstart","signing_guide":"https://energy.halowerk.com/examples/buy-nodejs","capability_request":{"url":"https://bedarf.halowerk.com/capabilities/request","method":"POST","cost":"free","description":"Missing a capability, or does the scope not fit? Report the need here - no payment required. Similar reports are bundled; the response returns an id you can check back on.","body_example":{"requested_capability":"short label","description":"what exactly is needed","max_price":0.01}}},"schema":{"$ref":"#/components/schemas/PaymentRequired"}}}},"404":{"description":"Not found","content":{"application/json":{"example":{"error":"not_found"}}}},"409":{"description":"Opportunity is invalid, expired or incompatible; no settlement attempted","content":{"application/json":{"example":{"error":"opportunity_is_invalid_expired_or_incompatible_no_settlement_attempted"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"example":{"error":"rate_limit_exceeded"}}}},"500":{"description":"Internal server error","content":{"application/json":{"example":{"error":"internal_server_error"}}}},"503":{"description":"Source is stale, unlicensed, missing or schema-incompatible; no settlement is attempted","content":{"application/json":{"example":{"error":"source_is_stale_unlicensed_missing_or_schema_incompatible_no_settlement_is_attempted"}}}}}}},"/v3/market-brief":{"post":{"operationId":"pOSTV3MarketBrief","tags":["EU Power Dispatch"],"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.","security":[{"x402":[]}],"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"}}}},"x-purchase-guide":{"quickstart":"https://energy.halowerk.com/examples/quickstart","nodejs":"https://energy.halowerk.com/examples/buy-nodejs","python":"https://energy.halowerk.com/examples/buy-python","curl":"https://energy.halowerk.com/examples/buy-curl","signing_helper":"https://energy.halowerk.com/examples/sign-eip3009.mjs"},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.05"},"protocols":[{"x402":{}}],"network":"eip155:8453","chain_id":8453,"asset":"USDC","asset_address":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","accepted_tokens":[{"symbol":"USDC","name":"USD Coin","network":"eip155:8453","chain_id":8453,"contract_address":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","decimals":6,"transfer_method":"eip3009"}],"recipient":"0x2880EdfFF13100677Bf97A3CBdF3Bc34771C4E5E","facilitators":{"primary":"CDP","fallback":"https://facilitator.xpay.sh"}},"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"spot_market":{"region":"DE-LU","currency":"EUR/MWh"},"price_forecast":[{"start":"2026-07-30T11:00:00.000Z","end":"2026-07-30T12:00:00.000Z","price_eur_mwh":71.2,"type":"published_day_ahead"}],"volatility":{"standard_deviation_eur_mwh":12.4,"band":"low"},"load":{"value_mw":54321,"timestamp":"2026-07-30T09:00:00.000Z","fetched_at":"2026-07-30T09:45:00.000Z","source":"SMARD.de"},"renewable_share":{"value_pct":52.1,"method":"renewable_generation_as_share_of_load","timestamp":"2026-07-30T09:00:00.000Z","fetched_at":"2026-07-30T09:45:00.000Z","source":"SMARD.de"},"negative_price_probability":{"value":0.18,"method":"published_day_ahead_share","forecast_status":"not_used"},"uncertainty":{"published_price_hours":24,"missing_price_hours":0,"negative_price_ml_status":"not_used"},"source_timestamps":{"generated_at":"2026-07-30T10:00:00.000Z","spot_observed_through":"2026-07-31T10:00:00.000Z","spot_fetched_at":"2026-07-30T09:45:00.000Z","load_observed_at":"2026-07-30T09:00:00.000Z"},"source_attributions":[{"source_id":"entsoe_day_ahead","attribution":"ENTSO-E Transparency Platform","licence":"CC BY 4.0"},{"source_id":"smard_load","attribution":"Bundesnetzagentur | SMARD.de","licence":"CC BY 4.0"},{"source_id":"smard_generation","attribution":"Bundesnetzagentur | SMARD.de","licence":"CC BY 4.0"}],"model_version":"dispatch-deterministic-3.0.0","expires_at":"2026-07-30T10:15:00.000Z","payment_receipt":{"protocol":"x402","network":"eip155:8453","idempotent_replay":false}},"schema":{"type":"object","properties":{"spot_market":{"type":"object","properties":{"region":{"type":"string"},"currency":{"type":"string"}},"required":["region","currency"],"additionalProperties":true},"price_forecast":{"type":"array","items":{"type":"object","properties":{"start":{"type":"string"},"end":{"type":"string"},"price_eur_mwh":{"type":"number"},"type":{"type":"string"}},"required":["start","end","price_eur_mwh","type"],"additionalProperties":true}},"volatility":{"type":"object","properties":{"standard_deviation_eur_mwh":{"type":"number"},"band":{"type":"string"}},"required":["standard_deviation_eur_mwh","band"],"additionalProperties":true},"load":{"type":"object","properties":{"value_mw":{"type":"integer"},"timestamp":{"type":"string"},"fetched_at":{"type":"string"},"source":{"type":"string"}},"required":["value_mw","timestamp","fetched_at","source"],"additionalProperties":true},"renewable_share":{"type":"object","properties":{"value_pct":{"type":"number"},"method":{"type":"string"},"timestamp":{"type":"string"},"fetched_at":{"type":"string"},"source":{"type":"string"}},"required":["value_pct","method","timestamp","fetched_at","source"],"additionalProperties":true},"negative_price_probability":{"type":"object","properties":{"value":{"type":"number"},"method":{"type":"string"},"forecast_status":{"type":"string"}},"required":["value","method","forecast_status"],"additionalProperties":true},"uncertainty":{"type":"object","properties":{"published_price_hours":{"type":"integer"},"missing_price_hours":{"type":"integer"},"negative_price_ml_status":{"type":"string"}},"required":["published_price_hours","missing_price_hours","negative_price_ml_status"],"additionalProperties":true},"source_timestamps":{"type":"object","properties":{"generated_at":{"type":"string"},"spot_observed_through":{"type":"string"},"spot_fetched_at":{"type":"string"},"load_observed_at":{"type":"string"}},"required":["generated_at","spot_observed_through","spot_fetched_at","load_observed_at"],"additionalProperties":true},"source_attributions":{"type":"array","items":{"type":"object","properties":{"source_id":{"type":"string"},"attribution":{"type":"string"},"licence":{"type":"string"}},"required":["source_id","attribution","licence"],"additionalProperties":true}},"model_version":{"type":"string"},"expires_at":{"type":"string"},"payment_receipt":{"type":"object","properties":{"protocol":{"type":"string"},"network":{"type":"string"},"idempotent_replay":{"type":"boolean"}},"required":["protocol","network","idempotent_replay"],"additionalProperties":true}},"required":["spot_market","price_forecast","volatility","load","renewable_share","negative_price_probability","uncertainty","source_timestamps","source_attributions","model_version","expires_at","payment_receipt"],"additionalProperties":true}}}},"400":{"description":"Invalid region, horizon or use case","content":{"application/json":{"example":{"error":"invalid_region_horizon_or_use_case"}}}},"402":{"description":"x402 payment required","content":{"application/json":{"example":{"x402Version":2,"error":"payment_required","price_usdc":0.05,"resource":{"url":"https://energy.halowerk.com/v3/market-brief","method":"POST","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.","mimeType":"application/json","serviceName":"EU Power Dispatch API","tags":["compute-scheduling","depin-workloads","carbon-aware-compute","battery-dispatch","power-trading","germany","europe"],"iconUrl":"https://energy.halowerk.com/favicon.svg"},"extensions":{"bazaar":{"info":{"input":{"type":"http","method":"POST","bodyType":"json","body":{"region":"DE-LU","horizon_hours":24,"use_case":"trading"}},"output":{"type":"json","example":{"spot_market":{"region":"DE-LU","currency":"EUR/MWh"},"price_forecast":[{"start":"2026-07-30T11:00:00.000Z","end":"2026-07-30T12:00:00.000Z","price_eur_mwh":71.2,"type":"published_day_ahead"}],"volatility":{"standard_deviation_eur_mwh":12.4,"band":"low"},"load":{"value_mw":54321,"timestamp":"2026-07-30T09:00:00.000Z","fetched_at":"2026-07-30T09:45:00.000Z","source":"SMARD.de"},"renewable_share":{"value_pct":52.1,"method":"renewable_generation_as_share_of_load","timestamp":"2026-07-30T09:00:00.000Z","fetched_at":"2026-07-30T09:45:00.000Z","source":"SMARD.de"},"negative_price_probability":{"value":0.18,"method":"published_day_ahead_share","forecast_status":"not_used"},"uncertainty":{"published_price_hours":24,"missing_price_hours":0,"negative_price_ml_status":"not_used"},"source_timestamps":{"generated_at":"2026-07-30T10:00:00.000Z","spot_observed_through":"2026-07-31T10:00:00.000Z","spot_fetched_at":"2026-07-30T09:45:00.000Z","load_observed_at":"2026-07-30T09:00:00.000Z"},"source_attributions":[{"source_id":"entsoe_day_ahead","attribution":"ENTSO-E Transparency Platform","licence":"CC BY 4.0"},{"source_id":"smard_load","attribution":"Bundesnetzagentur | SMARD.de","licence":"CC BY 4.0"},{"source_id":"smard_generation","attribution":"Bundesnetzagentur | SMARD.de","licence":"CC BY 4.0"}],"model_version":"dispatch-deterministic-3.0.0","expires_at":"2026-07-30T10:15:00.000Z","payment_receipt":{"protocol":"x402","network":"eip155:8453","idempotent_replay":false}}}},"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"input":{"type":"object","properties":{"type":{"type":"string","const":"http"},"method":{"type":"string","enum":["POST","PUT","PATCH"]},"bodyType":{"type":"string","enum":["json","form-data","text"]},"body":{"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}},"required":["type","method","bodyType","body"],"additionalProperties":false},"output":{"type":"object","properties":{"type":{"type":"string"},"example":{"type":"object"}},"required":["type"]}},"required":["input"]}}},"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},"accepts":[{"scheme":"exact","network":"eip155:8453","amount":"50000","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","payTo":"0x2880EdfFF13100677Bf97A3CBdF3Bc34771C4E5E","maxTimeoutSeconds":300,"extra":{"asset":"USDC","network_name":"Base Mainnet","name":"USD Coin","decimals":6,"assetTransferMethod":"eip3009","version":"2","eip712Domain":{"name":"USD Coin","version":"2","chainId":8453,"verifyingContract":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"}}}],"payment_headers":{"retry_with":"PAYMENT-SIGNATURE","challenge":"PAYMENT-REQUIRED","response":"PAYMENT-RESPONSE"},"docs":"https://energy.halowerk.com/examples/quickstart","signing_guide":"https://energy.halowerk.com/examples/buy-nodejs","capability_request":{"url":"https://bedarf.halowerk.com/capabilities/request","method":"POST","cost":"free","description":"Missing a capability, or does the scope not fit? Report the need here - no payment required. Similar reports are bundled; the response returns an id you can check back on.","body_example":{"requested_capability":"short label","description":"what exactly is needed","max_price":0.01}}},"schema":{"$ref":"#/components/schemas/PaymentRequired"}}}},"404":{"description":"Not found","content":{"application/json":{"example":{"error":"not_found"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"example":{"error":"rate_limit_exceeded"}}}},"500":{"description":"Internal server error","content":{"application/json":{"example":{"error":"internal_server_error"}}}},"503":{"description":"Source is stale, unlicensed, missing or schema-incompatible; no settlement is attempted","content":{"application/json":{"example":{"error":"source_is_stale_unlicensed_missing_or_schema_incompatible_no_settlement_is_attempted"}}}}}}}}}