Energiedaten & Recherche
energy / decision
EV, battery, and flexible-load agents buy this endpoint to receive an executable action with timing, expected value, confidence, and expiry.
POST https://energy.halowerk.com/energy/decisionEingaben
| Feld | Typ | Pflicht | Beschreibung |
|---|---|---|---|
| goal | string | Nein | |
| device | string | Nein | |
| location | string | Nein | |
| duration_hours | integer | Nein | |
| deadline | string | Nein | |
| policy_profile | string | Nein | Optional override. Trading defaults to precision; flexible devices default to utility. |
| constraints | object | Nein |
Vollständiges Eingabeschema anzeigen
{
"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
}Veröffentlichtes Eingabebeispiel
{
"goal": "minimize_cost",
"device": "ev",
"location": "Germany",
"duration_hours": 2,
"constraints": {
"target_soc": 80,
"max_power_kw": 11
}
}Ergebnis & Dokumentation
Maschinenlesbare Dokumentation dieses Hubs
Quelle dieser Seite: der veröffentlichte HALOWERK-Katalog. Stand: 2026-11-01, 15:19 UTC.
Weitere Endpunkte dieses Hubs
- Energiedaten & Recherche0,01 USDC
articles / {id}
POSThttps://energy.halowerk.com/articles/{id}Retrieve the full text of an identified energy article. See the linked schema for inputs, coverage and limitations.
- Energiedaten & Recherche0,02 USDC
bundle / trading
POSThttps://energy.halowerk.com/bundle/tradingEnergy-trading agents buy this endpoint to receive an eight-source market bundle with key metrics, insights, and raw evidence.
- Energiedaten & Recherche0,001 USDC
carbon / now
POSThttps://energy.halowerk.com/carbon/nowRead the reported carbon intensity of the German electricity mix. See the linked schema for inputs, coverage and limitations.