Home Assistant · Preis und CO2
Home Assistant braucht hier keine eigene Integration
Für StrompreisVorhersage reicht ein normaler REST-Sensor. Der öffentliche Summary-Endpunkt liefert Preis, CO2 und die wichtigsten Zeitfenster direkt als JSON.
- kein Add-on und keine HACS-Komponente nötig
- ein Endpunkt für Preis, CO2 und sinnvolle Zeitfenster
- klare Trennung zwischen Basispreis, CO2 und Gesamtpreis-Unterstützung
Die API ist für Home Assistant, Skripte und andere Automationen direkt nutzbar. Der fehlende Teil war bisher vor allem die verständliche Dokumentation, nicht eine technische Spezialintegration.
Neue Integrationen sollten ab jetzt https://api.energypriceforecast.eu/api/v1/... verwenden. Ältere Projekt-URLs funktionieren für bestehende Setups teilweise noch, sollten für neue Integrationen aber nicht mehr als Referenz dienen.
Empfohlener Endpunkt
Für Home Assistant ist /api/v1/home-assistant/summary der einfachste Einstieg. Er liefert die aktuelle Lage und bereits berechnete Vorschläge für das günstigste, grünste und kombinierte Zeitfenster.
https://api.energypriceforecast.eu/api/v1/home-assistant/summary?country=de&hours=48&window_hours=4flat.current_price und flat.cheapest_window_*.flat.current_co2_g_kwh und flat.greenest_window_*.flat.combined_window_* für den Kompromiss zwischen Preis und CO2.Schnellstart für Copy-Paste
Ja, die API ist absichtlich so aufgebaut, dass ein normales Home-Assistant-Setup ohne eigene Integration ausreicht. Der einfachste Weg ist: YAML-Block einfügen, Land anpassen, Home Assistant neu laden.
- Den YAML-Block unten in
configuration.yamloder in eine bereits eingebundene Package-Datei einfügen. - Nur den Parameter
countryanpassen. Für Dänemark immerdk1oderdk2verwenden. - Home Assistant neu laden oder neu starten.
- Unter Entwicklerwerkzeuge prüfen, ob die neuen Sensoren Werte liefern.
flat statt komplexer Templates. Dadurch bleibt es copy-paste-tauglich.country. Der Rest kann unverändert bleiben.REST-Sensor-Beispiel
Das Beispiel fragt Deutschland alle 15 Minuten ab. Für andere Märkte wird nur der Parameter country angepasst.
rest:
- resource: "https://api.energypriceforecast.eu/api/v1/home-assistant/summary?country=de&hours=48&window_hours=4"
scan_interval: 900
sensor:
- name: "StrompreisVorhersage aktueller Preis"
value_template: "{{ value_json.flat.current_price }}"
unit_of_measurement: "EUR/kWh"
- name: "StrompreisVorhersage aktuelle CO2-Intensität"
value_template: "{{ value_json.flat.current_co2_g_kwh }}"
unit_of_measurement: "gCO2/kWh"
- name: "StrompreisVorhersage günstigstes Fenster Start"
value_template: "{{ value_json.flat.cheapest_window_start }}"
- name: "StrompreisVorhersage grünstes Fenster Start"
value_template: "{{ value_json.flat.greenest_window_start }}"Nach dem Einfügen Home Assistant neu laden oder neu starten und die Sensorwerte unter Entwicklerwerkzeuge prüfen.
Offizielle Feldreferenz für home-assistant/summary
Der Summary-Endpunkt ist bewusst kompakt aufgebaut. Für viele Automationen reicht schon der Block flat. Wer genauer steuern oder Visualisierungen bauen will, kann zusätzlich die strukturierteren Blöcke price, co2, combined und source nutzen.
| Feld | Bedeutung | Typischer Einsatz |
|---|---|---|
flat.current_price | Aktueller Preis in EUR/kWh. Nutzt für den aktuellen Slot automatisch die beste verfügbare öffentliche Quelle. | Einfacher Preis-Sensor für Automationen. |
flat.current_price_source | Quellenlabel des aktuellen Preiswerts, zum Beispiel day_ahead. | Prüfen, ob der Preis schon offiziell oder noch prognostisch ist. |
flat.current_co2_g_kwh | Aktuelle CO2-Intensität in gCO2/kWh. | CO2-basierte Lastverschiebung. |
flat.cheapest_window_* | Start, Ende und Durchschnitt des günstigsten Zeitfensters im angefragten Horizont. | EV-Laden, Boiler, Wärmepumpe. |
flat.greenest_window_* | Start, Ende und Durchschnitt des CO2-ärmsten Zeitfensters. | Ökologisch optimierte Lastverschiebung. |
flat.combined_window_* | Kompromissfenster zwischen Preis und CO2. | Wenn beides relevant ist und kein harter Vorrang gilt. |
price.current | Objekt mit start, end, value, unit und source für den aktuellen Preis-Slot. | Dashboards und präzisere Zustandslogik. |
price.cheapest_window_next_horizon | Strukturierter Block für das günstigste Fenster mit Dauer und Quellenzählung. | Wenn Start, Ende und Kontext gemeinsam gebraucht werden. |
co2.current | Objekt mit aktuellem CO2-Wert und zugehörigem Zeitfenster. | CO2-Anzeige ohne Parsing aus flat. |
co2.greenest_window_next_horizon | Strukturierter Block für das grünste Fenster. | CO2-optimierte Lade- oder Heizlogik. |
combined.best_window_next_horizon | Kombinierter Empfehlungspfad mit Preis-, CO2- und Score-Werten. | Ein einziger "best now"-Entscheid ohne eigene Gewichtung. |
source.price | Metadaten zur Preisquelle, inklusive Firestore-Dokument, Day-Ahead-Provider und Anzahl verfügbarer Einträge. | Debugging, Monitoring und Qualitätskontrolle. |
source.co2 | Metadaten zur CO2-Quelle. | Debugging und Nachvollziehbarkeit. |
hourly-forecast der passendere Endpunkt.flat.current_price ist der aktuell verwendbare öffentliche Preiswert für den laufenden Slot. Er kann aus dem offiziellen Day-Ahead stammen oder aus einer anderen freigegebenen Quelle, wenn der Markt noch nicht vollständig vorliegt.retail-forecast ist aktuell nur für ausgewählte Märkte öffentlich gedacht. Für andere Märkte bleibt die Summary bewusst auf Markt- bzw. Basiswerten.Wann reicht summary und wann brauchst du hourly-forecast?
summary reicht aus, wenn du nur einfache Automationen bauen willst
Wenn du nur den aktuellen Preis, die aktuelle CO2-Intensität oder das beste 4-Stunden-Fenster brauchst, ist home-assistant/summary der richtige Endpunkt. Er hält die YAML kurz und vermeidet unnötiges Parsing.
hourly-forecast ist besser für Diagramme und komplexe Templates
Wenn du alle Stundenwerte selbst visualisieren, eigene Scores berechnen oder Day-Ahead und Prognose getrennt darstellen willst, nimm hourly-forecast. Dort liegen die Zeitreihen ausführlicher und transparenter vor.
Support-Matrix der öffentlichen API
Die öffentliche API unterstützt aktuell nicht jeden Markt in jedem Endpunkt. Entscheidend ist deshalb nicht nur, ob ein Land in der Web-App sichtbar ist, sondern welche API-Funktion dafür schon öffentlich freigegeben ist.
| Markt | hourly-forecast |
home-assistant/summary |
co2-live |
Endkundenpreis-Prognoseretail-forecast |
|---|---|---|---|---|
| DE | ja | ja | ja | ja |
| NL | ja | ja | ja | ja |
| BE | ja | ja | ja | nein |
| FR | ja | ja | ja | nein |
| CZ | ja | ja | nein | nein |
| DK1 | ja | ja | ja | ja |
| DK2 | ja | ja | ja | ja |
dk1 oder dk2 verwenden. dk fällt auf DK1.retail-forecast ist hier die annahmenbasierte Endkundenpreis-Prognose gemeint, nicht nur der reine Börsen- oder Basispreis. Öffentlich freigeschaltet ist sie aktuell nur für DE, NL, DK1 und DK2.Wichtige Hinweise
Ist das eine offizielle Home-Assistant-Integration?
Nein. Es ist bewusst eine einfache REST-Nutzung. Das ist stabiler, leichter testbar und für viele Setups völlig ausreichend.
Sind die API-Preise mein exakter Haushaltsstrompreis?
Nicht automatisch. hourly-forecast und die Home-Assistant-Summary liefern zunächst Markt- bzw. Basispreise. Der genaue Gesamtpreis hängt je nach Land von Netz, Steuern, Abgaben und Lieferantenaufschlägen ab.
Was passiert bei einem nicht unterstützten Land?
Die öffentliche API liefert dafür jetzt bewusst einen Fehler statt still auf Deutschland zurückzufallen. Das ist absichtlich strenger, damit Automationen keine falschen Daten bekommen.
Was tun, wenn nach dem Einfügen keine Werte erscheinen?
Typische Ursachen sind: YAML an der falschen Stelle eingefügt, Home Assistant nicht neu geladen, ein nicht unterstützter country-Wert oder ein Einrückungsfehler in der YAML. Am schnellsten sieht man das unter Entwicklerwerkzeuge und in den Home-Assistant-Logs.
Verwandt: evcc mit Strompreis- und CO2-Prognose und Strompreis vs CO2.