Zum Inhalt
HALOWERK

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/decision

Eingaben

Felder des veröffentlichten Eingabeschemas
FeldTypPflichtBeschreibung
goalstringNein
devicestringNein
locationstringNein
duration_hoursintegerNein
deadlinestringNein
policy_profilestringNeinOptional override. Trading defaults to precision; flexible devices default to utility.
constraintsobjectNein
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
}

Originalschema öffnen

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

Alle Endpunkte dieses Hubs →