EnergyZero Smart-Home-Integration, kostenlos und Open Source

Dynamische Strom- und Gaspreise in den Niederlanden von EnergyZero, für heute und morgen.

• Veröffentlicht von guim31
• Geräte
• Version 1.0.1
• Erfordert Gladys >=5.1.0
• ★ 0

Auf GitHub ansehenAlle Integrationen

Die dynamischen Strom- und Gaspreise der Niederlande, veröffentlicht von EnergyZero, in Gladys: der Preis der aktuellen Stunde, die günstigsten Stunden des Tages, ein Preisdiagramm für heute und morgen und Szenen-Auslöser, damit deine Geräte laufen, wenn der Strom am günstigsten ist.

Diese Integration ist nicht mit EnergyZero verbunden. Entwickelt wurde sie ohne Zugriff auf die echte API aus der Entwicklungsumgebung, mit echten Antworten, die die Bibliothek energyzero aufgezeichnet hat: Rückmeldungen sind willkommen.

Überblick

EnergyZero veröffentlicht, ohne Konto und ohne Schlüssel:

• die stündlichen Strompreise des niederländischen Day-Ahead-Markts (EPEX, Zone NL), als Börsenpreis oder als Endpreis, den ein EnergyZero-Kunde zahlt (Börsenpreis, Energiesteuer und Einkaufskosten), mit oder ohne MwSt.;
• den täglichen Gaspreis, gültig von 6 bis 6 Uhr.

Die Strompreise für morgen werden zwischen 14 und 15 Uhr veröffentlicht. Die Preise gelten auch für die Marken, die ihre Energie über EnergyZero beziehen (ANWB Energie, Energie van Ons, Mijndomein Energie, SamSam, ZonderGas…).

Alle Uhrzeiten sind Amsterdamer Zeit, und ein Tag geht in Amsterdam von Mitternacht bis Mitternacht, egal in welcher Zeitzone dein Gladys läuft.

Voraussetzungen

• Gladys Assistant 5.1.0 oder neuer.
• Internetzugang von Gladys zu public.api.energyzero.nl.
• Sonst nichts: kein Konto, kein API-Schlüssel, keine Hardware.

Installation

1. Öffne in Gladys Integrationen → Von GitHub installieren und gib https://github.com/guim31/gladys-energyzero ein.
2. Öffne die Integration, prüfe die Konfiguration, speichere.
3. Öffne den Tab Entdecken und füge das Gerät EnergyZero hinzu.
4. Füge auf einem Dashboard das Widget Strompreise hinzu.

Konfiguration

Feld	Standard	Wirkung
Strompreis	Endpreis	Endpreis für Verbraucher oder nur der EPEX-Day-Ahead-Börsenpreis
MwSt. einbeziehen	Ja	Preise mit der niederländischen MwSt. (21 %)
Gaspreis	Ja	Auch den Gaspreis des Tages lesen; eine Änderung fügt eine Funktion hinzu oder entfernt sie
Sprache der Funktionsnamen	Französisch	Wird beim Hinzufügen des Geräts verwendet: Die Namen ändern sich danach nicht mehr

Die Schaltfläche Preise jetzt abrufen fragt EnergyZero sofort ab und zeigt, was für heute und morgen veröffentlicht ist: praktisch, um die Verbindung zu prüfen.

Das Gerät EnergyZero

Ein einziges Gerät, nur lesbar, von der Integration selbst jede Minute aktualisiert (die Preise werden einmal pro Stunde bei EnergyZero abgerufen).

Funktion	Typ	Wert
Aktueller Strompreis (€/kWh)	Preis	Preis der aktuellen Stunde
Preis nächste Stunde (€/kWh)	Preis	Preis der nächsten Stunde (nach 23 Uhr, sobald morgen bekannt ist)
Durchschnittspreis heute (€/kWh)	Preis	Durchschnitt der Stunden des Tages
Tiefstpreis heute (€/kWh)	Preis	Günstigste Stunde des Tages
Höchstpreis heute (€/kWh)	Preis	Teuerste Stunde des Tages
Günstigste Stunde heute	Text	Beginn der günstigsten Stunde, HH:MM
Teuerste Stunde heute	Text	Beginn der teuersten Stunde, HH:MM
Rang der Stunde (1 = günstigste)	Zähler	Rang der aktuellen Stunde am Tag, 1 bis 24 (23 oder 25 bei der Zeitumstellung)
Gaspreis heute (€/m³)	Preis	Gaspreis des Gastags (6 bis 6 Uhr), wenn aktiviert

Gladys kennt keine Einheit €/kWh: Die Preise erscheinen in Euro, der Name sagt, wofür. Ist eine Funktion die einzige ihres Typs am Gerät, zeigt das Dashboard statt ihres Namens die allgemeine Bezeichnung des Typs („Zähler“).

Dashboard-Widget

Strompreise zeigt die Preisart, drei Kacheln (jetzt, nächste Stunde, Durchschnitt heute), das Diagramm von heute und morgen mit der günstigsten und der teuersten Stunde jedes Tages und einer Linie zur aktuellen Uhrzeit, danach die günstigste Stunde von heute und morgen, den Durchschnitt von morgen und den Gaspreis. Vor 15 Uhr steht dort, dass die Preise für morgen ab 15 Uhr kommen.

Szenen-Auslöser

Zwei Auslöser, im Szenen-Editor unter EnergyZero. Beide betreffen den Strom und die Stunden des aktuellen Tages (Mitternacht bis Mitternacht).

Die günstigsten Stunden des Tages beginnen

Löst einmal am Tag aus, zu Beginn des günstigsten Blocks aufeinanderfolgender Stunden. Wähle die Länge des Blocks: 1 bis 6 oder 8 Stunden (1 Stunde ist die günstigste Stunde des Tages). Variablen: Durchschnittspreis des Blocks, Beginn und Ende.

Eine der günstigsten Stunden beginnt

Löst zu Beginn jeder der N günstigsten Stunden des Tages aus, ob am Stück oder nicht. Wähle N: 1 bis 6, 8, 10 oder 12. Variablen: Preis der Stunde, ihr Rang, Beginn und Ende.

Die Auslöser kommen, wenn die Stunde beginnt, höchstens 10 Minuten zu spät (Neustart von Gladys oder der Integration): Eine Stunde, die schon länger läuft, löst nichts aus. „Der Preis fällt unter X“ ist kein Auslöser: Nutze die Funktion Aktueller Strompreis mit der Schwellenwert-Bedingung des Szenen-Editors.

Szenen-Beispiele

• Spülmaschine in den günstigsten 3 Stunden: Auslöser Die günstigsten Stunden des Tages beginnen, 3 Stunden → Steckdose der Spülmaschine einschalten.
• Warmwasserboiler in den 4 günstigsten Stunden: Auslöser Eine der günstigsten Stunden beginnt, 4 → Boiler einschalten; eine zweite Szene auf Rang der Stunde größer als 4 → ausschalten.
• Warnung bei teurem Strom: wenn Aktueller Strompreis über 0,40 steigt → Nachricht senden „Strom ist gerade teuer, warte mit dem Trockner“.

Aktualisierung und API-Nutzung

EnergyZero veröffentlicht kein Kontingent für diese öffentliche API. Die Integration nutzt sie sparsam:

• zwei Anfragen pro Stunde (Strom, und Gas, wenn aktiviert), jede liefert drei Tage (gestern, heute, morgen);
• ab 14 Uhr alle 15 Minuten eine weitere Stromanfrage, bis die Preise für morgen veröffentlicht sind, danach wieder stündlich;
• nach einem Fehler neuer Versuch nach 5, 10, 20, 40 und dann 60 Minuten; die zuletzt bekannten Preise bleiben so lange in Gebrauch (die Preise sind einen Tag im Voraus bekannt).

Die Zustände werden nur bei einer Änderung veröffentlicht, dazu eine Erinnerung alle 6 Stunden.

Fehlerbehebung

• „EnergyZero ist nicht erreichbar“ in der Konfiguration: Gladys hat keinen Internetzugang, oder EnergyZero ist gestört. Die zuletzt bekannten Preise bleiben in Gebrauch; drücke Preise jetzt abrufen, um es erneut zu versuchen.
• „veröffentlicht aber keinen Strompreis für heute“: EnergyZero hat ohne Preis für den Tag geantwortet, das passiert bei einer Veröffentlichungsstörung. Die Integration versucht es jede Stunde erneut.
• Kein Wert am Gerät: Füge das Gerät zuerst über den Tab „Entdecken“ hinzu; seine Werte kommen sofort.
• Die Gas-Funktion fehlt oder bleibt: Öffne nach einer Änderung der Gas-Einstellung den Tab „Entdecken“ und drücke beim Gerät auf Aktualisieren.
• Ausführliche Protokolle: Setze LOG_LEVEL=debug am Container, um jeden Abruf zu sehen.

Einschränkungen

• Nur Stundenpreise. Der niederländische Day-Ahead-Markt handelt seit Oktober 2025 in Viertelstunden: Die Integration zeigt die Stundenpreise von EnergyZero.
• Nur die Niederlande, Preise von EnergyZero (und der Marken, die es beliefert). Dein eigener Vertrag kann einen anderen Aufschlag haben.
• Die Auslöser betrachten nur den aktuellen Tag: Ein günstigster Block geht nie über Mitternacht.
• Nur lesend: Die Integration steuert selbst nichts.
• Die Funktionsnamen werden beim Hinzufügen des Geräts festgelegt; eine spätere Änderung der Sprache benennt sie nicht um.

Vergleich mit Nord Pool

Eine Nord-Pool-Integration liefert den reinen Day-Ahead-Börsenpreis einer Gebotszone, ohne MwSt. und Steuern. EnergyZero bringt für die Niederlande den Endpreis für Verbraucher (Energiesteuer, Einkaufskosten und MwSt. inbegriffen, also was ein EnergyZero-Kunde zahlt) und den Gaspreis; sein Börsenpreis (EPEX Day-Ahead, Zone NL) ist derselbe Markt wie die Zone NL von Nord Pool.

Konfigurationseinstellungen

Diese Einstellungen fragt EnergyZero in seinem Konfigurationsbildschirm in Gladys ab.

Einstellung	Typ	Pflichtfeld	Beschreibung
Energiepreise in den Niederlanden	section	Nein	EnergyZero veröffentlicht die stündlichen Strompreise des niederländischen Day-Ahead-Markts und den täglichen Gaspreis, ohne Konto und ohne Schlüssel. Die Strompreise für morgen kommen zwischen 14 und 15 Uhr. Füge das Gerät EnergyZero über den Tab „Entdecken“ hinzu und das Preis-Widget über das Dashboard. Nicht mit EnergyZero verbunden.
Strompreis	select	Nein	Endpreis: was ein EnergyZero-Kunde zahlt (Börsenpreis, Energiesteuer und Einkaufskosten). Börse: nur der EPEX-Day-Ahead-Preis der niederländischen Zone.
MwSt. einbeziehen	boolean	Nein	Preise mit der niederländischen MwSt. (21 %).
Gaspreis	boolean	Nein	Auch den Gaspreis des Tages lesen (€/m³, von 6 bis 6 Uhr). Eine Änderung fügt eine Funktion hinzu oder entfernt sie: Aktualisiere das Gerät im Tab „Entdecken“.
Sprache der Funktionsnamen	select	Nein	Wird beim Hinzufügen des Geräts zu Gladys verwendet: Die Namen ändern sich danach nicht mehr.

So installierst du EnergyZero in Gladys

1. Öffne in Gladys Integrationen: EnergyZero erscheint im Katalog neben den nativen Integrationen, mit einem Community-Badge.
2. Klicke auf Installieren. Gladys lädt das Docker-Image (ghcr.io/guim31/gladys-energyzero:1.0.1) herunter, startet es in einer vom Kern isolierten Sandbox und erzeugt die Oberfläche der Integration (Geräte, Erkennung und Konfiguration).
3. Öffne den Bildschirm Konfiguration der Integration, fülle die Einstellungen aus und speichere.
4. Du kannst sie auch direkt über die URL ihres Repositorys installieren: https://github.com/guim31/gladys-energyzero.

EnergyZero benötigt Gladys >=5.1.0. Der Katalog in Gladys wird stündlich aktualisiert, eine neue Version ist also spätestens eine Stunde nach ihrer Veröffentlichung verfügbar.

Du nutzt Gladys noch nicht? Es ist kostenlos und Open Source: folge der Installationsanleitung, um loszulegen.

Über externe Integrationen

EnergyZero ist eine externe Integration: eine Community-Integration, die als Docker-Container verpackt und auf GitHub veröffentlicht wird. Gladys installiert sie mit einem Klick und führt sie in einer vom Kern isolierten Sandbox aus. Sie wird von guim31 veröffentlicht und gepflegt, nicht vom Gladys-Kernteam.

• Alle Integrationen durchsuchen, native und aus der Community
• Deine eigene externe Integration bauen und veröffentlichen
• Quellcode auf GitHub — Quelle dieser Dokumentation

Abonniere den Newsletter von Gladys Assistant

Ein paar E-Mails im Monat zu neuen Releases und Neuigkeiten aus dem Projekt. Verschickt von Pierre-Gilles Leymarie, dem Gründer des Projekts. Jederzeit abbestellbar 🙂