Sprache

Home Assistant · Strompreis und CO2

Home Assistant braucht hier keine eigene Integration

Für StrompreisVorhersage reicht ein normales Home-Assistant-Paket mit einem REST-Sensor. Die API liefert aktuelle Werte, laufende Zustände und die wichtigsten Zeitfenster bereits so, dass du ohne viel eigene Logik starten kannst.

Kostenlos starten, optional länger planen

Der Home-Assistant-Einstieg bleibt ohne API-Key nutzbar und liefert typischerweise bis zu 48 Stunden. Wenn du größere Verbraucher über mehrere Tage planen möchtest, kannst du Private Pro mit bis zu 120 Stunden 14 Tage kostenlos testen.

Worum es hier eigentlich geht

Der fehlende Teil war für Home Assistant bisher nicht die API, sondern der Einstieg. Deshalb startet diese Seite jetzt bewusst mit fertigen Dateien statt mit roher REST-Syntax.

Wichtiger API-Hinweis

Neue Setups sollten https://api.energypriceforecast.eu/api/v1/... verwenden. Die Summary-API liefert keine komplette Preisreihe, sondern einen kompakten Automations-Block mit aktuellem Preis, aktuellem CO2-Wert, bestmöglichem Fenster und Meta-Infos zum Zugriff.

In 5 Minuten zum Ergebnis

Wenn du einfach nur starten willst, nimm diese drei Dateien. Die Paketdatei holt die Daten, die Lovelace-Karte zeigt sie an und die Beispiel-Automation demonstriert die eigentliche Nutzung.

Absichtlich einfachDie Paketdatei nutzt nur den Summary-Endpunkt. Keine eigene HACS-Komponente, kein Add-on, kein Python-Skript.
Schon für echte Steuerung gedachtWichtig sind hier nicht nur Startzeiten, sondern auch Zustände wie is_cheapest_window_now und Restminuten.
Serverfreundlicher AbrufDas Beispiel pollt standardmäßig alle 30 Minuten. Für Day-Ahead plus Forecast ist das im Normalfall völlig ausreichend.

So sieht das Ergebnis aus

Vorschau einer Lovelace-Karte mit aktuellem Preis, CO2-Wert und Preisfenstern.
Die Lovelace-Karte zeigt direkt die Entitäten aus der Paketdatei, ohne dass du erst eigene Dashboards bauen musst.
Vorschau einer einfachen Home-Assistant-Automation mit Trigger auf das günstigste Preisfenster.
Die Beispiel-Automation startet absichtlich simpel und lässt sich dann auf Wallbox, Wärmepumpe oder Schalter umbiegen.

So bindest du das Paket ein

  1. Lade die Paketdatei herunter und speichere sie als /config/packages/energypriceforecast.yaml.
  2. Falls Packages noch nicht aktiviert sind, ergänze in configuration.yaml diesen Block.
  3. Home Assistant neu laden oder einmal neu starten.
  4. Importiere danach die Lovelace-Karte und optional die Beispiel-Automation.
homeassistant:
  packages: !include_dir_named packages

Die Lovelace-Karte kannst du in einem Dashboard über Manuell einfügen. Die Automation kannst du in den Automationen ebenfalls als YAML importieren oder einfach als Vorlage übernehmen.

Welche Entitäten bekommst du danach?

Die Paketdatei legt eine Rohquelle und darauf aufbauend direkt nutzbare Entitäten an. Damit sieht man sofort, ob die API sauber läuft, und kann ohne JSON-Parsing eigene Automationen bauen.

Entität Bedeutung Typischer Einsatz
sensor.energypriceforecast_apiRohantwort des Summary-Endpunkts inklusive flat, price, co2 und meta.Debugging und Grundlage für weitere Templates.
sensor.epf_aktueller_preisAktueller Preis im laufenden Slot. Quelle kann Day-Ahead oder Forecast sein.Preisgesteuerte Wallbox, Wärmepumpe, Boiler.
sensor.epf_aktuelle_co2_intensitaetAktueller CO2-Wert im laufenden Slot.CO2-orientierte Lastverschiebung.
binary_sensor.epf_guenstigstes_preisfenster_aktivon, wenn das rechnerisch beste Preisfenster bereits läuft.Direkte Laufentscheidung ohne eigene Zeitvergleiche.
sensor.epf_restminuten_guenstigstes_preisfensterRestdauer des aktuell besten Preisfensters.Schätzen, wie lange ein Verbraucher noch laufen darf.
sensor.epf_naechstes_volles_preisfensterDas nächste vollständige Zukunftsfenster für Preis.Späteres Starten oder Planen.
sensor.epf_api_key_statusStatus des hinterlegten API-Keys.Schnell sehen, ob 48h oder 120h wirklich greifen.
sensor.epf_erlaubter_horizontServerseitig erlaubter Horizont in Stunden.Prüfen, ob dein Setup wirklich die gewünschte Länge bekommt.

Welchen Zeitraum liefert die API genau?

Für Home Assistant ist das Entscheidende nicht nur die URL, sondern auch die fachliche Logik dahinter. Genau das sollte transparent sein.

Ohne API-KeyDas Beispiel nutzt hours=48. Damit bekommst du den einfachen Testhorizont, der ohne zusätzlichen Schlüssel öffentlich gedacht ist.
Mit API-KeyWenn du den Bearer-Token im Header setzt, kannst du den Horizon im Paket auf bis zu hours=120 erhöhen, also auf 5 Tage.
PreisauflösungDay-Ahead kann in 15-Minuten-Slots vorliegen. Forecast außerhalb davon bleibt stündlich. Die Summary mischt das intern sauber.
Day-Ahead firstSobald offizielle Day-Ahead-Preise vorhanden sind, werden diese bevorzugt. Nur für den restlichen offenen Zeitraum werden Prognosewerte verwendet.
CO2 bleibt stündlichDie CO2-Daten werden nicht künstlich auf Viertelstunden umgerechnet. Für die Summary reicht die stündliche CO2-Sicht in der Regel aus.
Fertig berechnete FensterDie API liefert nicht nur Rohwerte, sondern bereits das günstigste Fenster, das grünste Fenster und das nächste vollständige Zukunftsfenster.

Wo trägst du den API-Key ein und wie erhöhst du den Horizont?

Beides passiert direkt in der Paketdatei. Du musst keinen zweiten Endpunkt verwenden, sondern nur den Authorization-Header aktivieren und den Stundenwert anpassen.

rest:
  - resource: "https://api.energypriceforecast.eu/api/v1/home-assistant/summary?country=de&hours=120&window_hours=4"
    scan_interval: 1800
    headers:
      Accept: "application/json"
      Authorization: "Bearer DEIN_API_KEY"

Danach siehst du in sensor.epf_api_key_status, sensor.epf_erlaubter_horizont und sensor.epf_genutzter_horizont, ob dein Key wirklich verwendet wird.

Was bringt der Summary-Endpunkt konkret?

Der Summary-Pfad ist absichtlich für Automationen gebaut. Er spart dir viel eigene Logik, weil du nicht erst stundenlange Reihen parsen musst, um einfache Entscheidungen zu treffen.

Feld Bedeutung Warum es nützlich ist
flat.current_priceAktueller Preiswert im laufenden Slot.Direkter Ist-Zustand für Preislogik.
flat.current_co2_g_kwhAktueller CO2-Wert im laufenden Slot.Direkter Ist-Zustand für CO2-Logik.
flat.is_cheapest_window_nowZeigt, ob das beste Preisfenster bereits aktiv ist.Wichtiger als nur ein Startzeitpunkt.
flat.cheapest_window_remaining_minutesRestdauer des laufenden besten Preisfensters.Nützlich für Laufzeitentscheidungen.
price.next_full_window.startNächstes vollständiges Zukunftsfenster für Preis.Planung, wenn du bewusst später starten willst.
meta.api_key_stateStatus des hinterlegten Schlüssels.Fehlersuche und Testphase.
meta.allowed_horizon_hoursWas serverseitig für diesen Zugriff erlaubt ist.Saubere Transparenz bei Limits.
meta.used_horizon_hoursWas die API tatsächlich geliefert hat.Landingpage und Backend bleiben damit ehrlich synchron.

Beispiel: Auto nur im günstigen Fenster laden

Genau dafür liegt die Beispiel-Automation bei. Sie nutzt bewusst den Boolean binary_sensor.epf_guenstigstes_preisfenster_aktiv statt nur auf eine Uhrzeit zu triggern. Das ist robuster, weil das beste Fenster auch bereits laufen kann.

trigger:
  - platform: state
    entity_id: binary_sensor.epf_guenstigstes_preisfenster_aktiv
    to: "on"

action:
  - service: persistent_notification.create
    data:
      title: "Günstiges Preisfenster aktiv"

Wenn du statt einer Benachrichtigung direkt eine Wallbox oder einen Schalter starten willst, ersetzt du im letzten Schritt nur den Service durch deinen eigenen Ziel-Service wie switch.turn_on.

Mit KI an dein Setup anpassen

Dieser Prompt hilft einer KI, aus dem Summary-Endpunkt eine passende Home-Assistant-Automation zu bauen. Er ersetzt nicht den einfachen Copy-Paste-Einstieg oben, sondern ist für individuelle Verbraucher, Zeitvorgaben und Sicherheitsregeln gedacht.

API-Key schützen

Gib einer KI niemals deinen echten API-Key. Lass im Ergebnis immer DEIN_API_KEY stehen und trage den Schlüssel erst lokal in Home Assistant ein.

Prompt zum Kopieren anzeigen
Du hilfst mir, eine sichere Home-Assistant-Automation mit der Energy Price Forecast EU API zu bauen.

Lies zuerst den API-Vertrag unter:
https://energypriceforecast.eu/openapi/integration-api.json

Verwende den Endpunkt /api/v1/home-assistant/summary und erfinde keine Felder. Die API nutzt offizielle Day-Ahead-Preise, sobald sie verfügbar sind, und Prognosewerte nur für den danach noch offenen Zeitraum.

Stelle mir vor dem YAML nacheinander höchstens diese Fragen:
1. Land oder Preiszone?
2. Welcher Verbraucher soll gesteuert werden und welche Home-Assistant-Entity schaltet ihn?
3. Leistung, benötigte Laufzeit und spätester Endzeitpunkt?
4. Soll nach Preis, CO2 oder beidem optimiert werden?
5. Free ohne Key und maximal 48 Stunden oder Private Pro mit maximal 120 Stunden?
6. Nutze ich packages oder configuration.yaml?

Regeln für dein Ergebnis:
- Free: hours=48 und kein Authorization-Header.
- Private Pro: hours=120 und Header Authorization: Bearer DEIN_API_KEY.
- Bitte mich niemals, den echten Key in den Chat einzufügen.
- Prüfe HTTP-Fehler sowie meta.api_key_state und meta.allowed_horizon_hours.
- Erkläre jede verwendete API-Eigenschaft kurz.
- Erzeuge vollständiges, gültig eingerücktes YAML und nenne den genauen Ablageort.
- Baue zuerst einen sicheren Testmodus mit Benachrichtigung oder input_boolean. Schalte den echten Verbraucher erst in einem getrennten, klar markierten Schritt.
- Definiere ein sicheres Verhalten bei alten, fehlenden oder unplausiblen Daten. Ein API-Fehler darf den Verbraucher nicht unkontrolliert einschalten.
- Gib zum Schluss eine kurze Prüfliste: API liefert HTTP 200, Sensoren haben Werte, erlaubter Horizont stimmt, Testmodus löst korrekt aus.

Wenn Angaben fehlen, frage nach. Triff keine stillen Annahmen über Entity-Namen, Tarif oder elektrische Grenzen.

Maschinenlesbare Grundlage: OpenAPI-Vertrag der Integrationsendpunkte.

Erweiterte Lösung für komplexere Optimierung

Wenn dir einfache Home-Assistant-Automationen nicht mehr reichen, lohnt sich DAO vor allem dann, wenn du Preis, PV, Speicher und Verbraucher gemeinsam optimieren willst. Home Assistant auf dieser Seite ist bewusst der einfache Einstieg. DAO ist der Fortgeschrittenen-Pfad für Nutzer, die mehr als nur Schalten oder Triggern wollen.

Wann reicht summary und wann brauchst du mehr?

summary reicht für die meisten Home-Assistant-Automationen

Wenn du aktuelle Werte, ein bestes Fenster und einfache Zustände brauchst, ist der Summary-Endpunkt der richtige Weg. Genau dafür ist auch die Paketdatei gebaut.

Für eigene Preisreihen oder Charts ist ein Rohreihen-Endpunkt besser

Wenn du später bewusst eigene Scoring-Logik, Diagramme oder detaillierte Zeitreihen bauen willst, ist der Summary-Endpunkt absichtlich nicht maximal ausführlich. Dann ist ein Forecast-Endpunkt mit Rohserie der passendere Pfad.

Sind das exakte Haushaltsstrompreise?

Nicht automatisch. Die Summary arbeitet primär mit Markt- bzw. Basispreisen. Dein exakter Haushaltsstrompreis hängt zusätzlich von Netz, Steuern, Abgaben und Lieferantenaufschlägen ab.

Was tun, wenn nach dem Einfügen keine Werte erscheinen?

Typische Ursachen sind: Paketordner nicht eingebunden, Einrückungsfehler in YAML, Home Assistant nicht neu geladen oder ein falscher country-Wert. Am schnellsten sieht man das in den HA-Logs und in den Entwicklerwerkzeugen.

Verwandt: evcc mit Strompreis- und CO2-Prognose und Strompreis vs CO2.