Sprache

Native Homey-App · öffentlicher Test

Energieverbrauch in Homey nach Preis und Netz-CO₂ planen

Installiere Energy Price Forecast wie eine normale Homey-App. Sie zeigt aktuelle Werte, erstellt verlässliche Wärmepumpen- und Wochenendpläne und liefert die Ergebnisse als Flow-Karten – ganz ohne HomeyScript.

Was dir die App liefert

Ein virtuelles Prognosegerät verbindet Preis- und Netz-CO₂-Daten mit fertigen Plänen für normale Homey-Flows.

  • Wärmepumpe oder Boiler: Wähle die günstigsten N Einzelstunden in jedem festen X-Stunden-Block. So wird der Betrieb nicht immer weiter verschoben.
  • E-Auto: Plane das Wochenende und lade nur in den ausgewählten günstigen Stunden.
  • Flexible Verbraucher: Nutze das günstigste zusammenhängende Preisfenster oder das grünste CO₂-Fenster.
  • Klarer Status: Datenquelle, Prognosehorizont und Aktualität stehen direkt am Gerät.
Energy Price Forecast für Homey mit Strompreis- und Netz-CO2-Diagramm
Strompreis und Netz-CO₂ zusammen – offizielle Day-Ahead-Werte haben Vorrang, sobald sie verfügbar sind.

In vier Schritten installieren

  1. Öffne die Homey-Testseite.
  2. Bestätige den Hinweis zum Test-Kanal und installiere die App auf deinem kompatiblen Homey.
  3. Füge das Gerät Preis- & CO₂-Prognose hinzu und folge dem Einrichtungsdialog.
  4. Nutze seine Flow-Karten, um zur richtigen Zeit zu schalten, laden, heizen oder benachrichtigen.
Testversion und Plattformgrenzen

Diese Version ist noch nicht von Homey zertifiziert. Sie unterstützt aktuell Homey Pro, Homey Pro mini und Homey Self-Hosted Server. Homey Cloud wird in dieser ersten Testversion nicht unterstützt.

48 Stunden kostenlos, optional bis zu 120 Stunden

Ohne API-Key plant die App bis zu 48 Stunden voraus – inklusive Wochenendplan von Samstag bis Sonntag. Private Pro erweitert den Horizont auf 120 Stunden und kann das Wochenende schon ab Freitag vorbereiten.

So entsteht die Prognose

Die Preislogik ist auch bei Homey nicht einfach „nur Forecast“. Sie arbeitet bewusst in zwei Schritten, damit echte Marktdaten immer Vorrang haben, sobald sie vorhanden sind.

Schritt 1Sobald offizieller Day-Ahead für einen Slot vorliegt, wird dieser Preis bevorzugt verwendet.
Schritt 2Forecast wird nur für die Zukunft genutzt, für die noch keine offiziellen Day-Ahead-Werte verfügbar sind.
Wichtige FolgeDie Summary kombiniert also reale Day-Ahead-Preise mit Forecast nur für den noch offenen Teil des Horizonts.
Die native App ist der empfohlene Weg

Einrichtung, Statuswerte, Planlogik und Flow-Karten stecken in einer geführten Homey-Oberfläche. HomeyScript brauchst du unten nur noch als Expertenlösung für eigene API-Logik.

HomeyScript bleibt für Spezialfälle verfügbar

Die API-Beispiele unten sind weiterhin nützlich, wenn die native App einen gewünschten Wert noch nicht anbietet oder du völlig eigene Berechnungen bauen möchtest.

Keine Einspeisung in die eingebaute Homey-Energy-Preiskurve

Die API liefert Werte und Signale für HomeyScript und Flows. Sie überschreibt nicht die dynamischen Preise im nativen Homey-Energy-Bereich.

Erweiterte Alternative: HomeyScript und direkter API-Zugriff

Für die meisten Nutzer ist die native App oben der richtige Einstieg. Für eigene Skripte gibt es weiterhin einen Summary-Pfad, dessen Struktur und Benennung auf HomeyScript und Advanced Flow zugeschnitten sind.

https://api.energypriceforecast.eu/api/v1/homey/summary?country=de&hours=48&window_hours=4
Aktueller Preisflat.current_price für Lade- oder Schaltentscheidungen.
CO2 liveflat.current_co2_g_kwh für klimaorientierte Automationen.
Fensterlogikflat.is_cheapest_window_now und price.next_full_window.start für direkte Flow-Entscheidungen.

Alternative: vollständige Preisreihe für eigene Logik

Wenn du Preise selbst vergleichen, Schwellwerte berechnen oder eigene Zeitfenster auswählen möchtest, statt nur fertige Signale zu verwenden, nutze die Homey-Preisreihe.

https://api.energypriceforecast.eu/api/v1/homey/prices?country=de&hours=48&mode=mixed&resolution=15m

mode=mixed verwendet offizielle Day-Ahead-Preise, sobald sie verfügbar sind, und ergänzt nur den verbleibenden Horizont mit Prognosewerten. Echte Viertelstundenpreise bleiben viertelstündlich; Stundenprognosen werden als vier gleiche Viertelstundenslots geliefert.

const API_KEY = '';
const url = 'https://api.energypriceforecast.eu/api/v1/homey/prices?country=de&hours=48&mode=mixed&resolution=15m';

const response = await fetch(url, {
  headers: API_KEY.trim() ? { Authorization: `Bearer ${API_KEY.trim()}` } : {},
});
if (!response.ok) throw new Error(`HTTP ${response.status}`);

const data = await response.json();
const next12Hours = data.entries.slice(0, 48);
const prices = next12Hours.map(slot => Number(slot.value)).filter(Number.isFinite);
if (prices.length === 0) throw new Error('Keine gültigen Preise erhalten');
return Math.min(...prices);

Das Beispiel gibt den niedrigsten Basispreis der nächsten zwölf Stunden als Number zurück. Die Werte sind standardmäßig Marktpreise ohne Steuern und Netzentgelte.

Was die API genau liefert

Der Homey-Endpunkt liefert eine kompakte Automation-Sicht. Das ist wichtig, weil du in Homey meistens nicht mit einer kompletten Rohpreisreihe starten willst, sondern mit wenigen klaren Werten für Flows.

Teil Inhalt Nutzen
flatAktueller Preis, aktuelles CO2, aktive beste Fenster und Restlaufzeiten.Ideal für einfache HomeyScript-Rückgabewerte.
priceAktueller Preis-Slot sowie best_window und next_full_window.Für Planung und Zukunftslogik.
co2Aktueller CO2-Slot sowie CO2-Fenster.Für grünere statt billigere Automationen.
sourceMetadaten zu Day-Ahead und Forecast.Wichtig für Einordnung und Debug.
metaAPI-Key-Status, erlaubter Horizont und Tageszähler.Hilft bei Limits und Fehlersuche.

Zeitraum und Auflösung

Die Beispiele nutzen hours=48 und window_hours=4. Das ist ein sinnvoller Einstieg, aber nicht die gesamte Produktgrenze.

ZeitraumMit hours legst du den angefragten Horizont fest. Öffentlich belastbar kommunizieren wir für die Preisprognose aktuell maximal 120 Stunden.
Tatsächlich erlaubtOhne API-Key sind aktuell 48 Stunden frei. Mit Key kann mehr erlaubt sein. Maßgeblich ist immer meta.allowed_horizon_hours.
AuflösungDay-Ahead kann in Viertelstunden kommen, Forecast und CO2 bleiben meist stündlich. Die Summary fasst das für Automationen kompakt zusammen.

So nutzt du es in Advanced Flow

  1. HomeyScript installieren.
  2. In Advanced Flow einen Zeit-Trigger anlegen, zum Beispiel alle 15 Minuten.
  3. Danach eine HomeyScript-Karte mit Rückgabetyp Number, Yes/No oder Text einfügen.
  4. Einen der Copy-Paste-Blöcke unten einfügen.
  5. Das Ergebnis-Tag im nächsten Flow-Schritt weiterverwenden.

Homey bewirbt explizit, dass HomeyScript Website-APIs ansprechen kann. Die folgenden Beispiele nutzen genau das für den Homey-Summary-Endpunkt.

Beispiel 1: aktuellen Preis als Number zurückgeben

Diese Karte eignet sich, wenn du auf Schwellwerte oder Vergleiche aufbauen willst.

const API_KEY = '';
const url = 'https://api.energypriceforecast.eu/api/v1/homey/summary?country=de&hours=48&window_hours=4';

const response = await fetch(url, {
  headers: API_KEY.trim()
    ? { Authorization: `Bearer ${API_KEY.trim()}` }
    : {},
});

if (!response.ok) {
  throw new Error(`HTTP ${response.status}`);
}

const data = await response.json();
const price = Number(data.flat?.current_price);
if (!Number.isFinite(price)) throw new Error('Keinen aktuellen Preis erhalten');
return price;

Beispiel 2: läuft das beste Preisfenster gerade?

Das ist für echte Automationen oft wichtiger als nur der nächste Startzeitpunkt.

const API_KEY = '';
const url = 'https://api.energypriceforecast.eu/api/v1/homey/summary?country=de&hours=48&window_hours=4';

const response = await fetch(url, {
  headers: API_KEY.trim()
    ? { Authorization: `Bearer ${API_KEY.trim()}` }
    : {},
});

if (!response.ok) {
  throw new Error(`HTTP ${response.status}`);
}

const data = await response.json();
return data.flat?.is_cheapest_window_now === true;

Beispiel 3: nächsten vollständigen Start als Text zurückgeben

Das ist sinnvoll, wenn du einen Flow für Planung, Anzeigen oder Benachrichtigungen bauen willst.

const API_KEY = '';
const url = 'https://api.energypriceforecast.eu/api/v1/homey/summary?country=de&hours=48&window_hours=4';

const response = await fetch(url, {
  headers: API_KEY.trim()
    ? { Authorization: `Bearer ${API_KEY.trim()}` }
    : {},
});

if (!response.ok) {
  throw new Error(`HTTP ${response.status}`);
}

const data = await response.json();
return String(data.price?.next_full_window?.start || '');

Optional mit API-Key

Wenn du mehr als den freien Horizont testen willst, trägst du den Key direkt im Script ein. Die API erwartet aktuell einen Bearer-Header.

const API_KEY = 'DEIN_API_KEY';
const url = 'https://api.energypriceforecast.eu/api/v1/homey/summary?country=de&hours=120&window_hours=4';

Maßgeblich ist am Ende nicht nur der gewünschte Wert in der URL, sondern das, was der Server in meta.allowed_horizon_hours tatsächlich freigibt.

Typische Use Cases in Homey

WallboxNur laden, wenn is_cheapest_window_now wahr ist oder der aktuelle Preis unter einem Grenzwert liegt.
Wärmepumpe oder BoilerGünstige Fenster zum Vorziehen oder Puffern nutzen, statt nur blind auf Uhrzeiten zu setzen.
BenachrichtigungenDen nächsten guten Start als Text zurückgeben und in Push- oder Sprachmeldungen einsetzen.

Wichtige Meta-Felder für Debug

Feld Bedeutung Warum relevant
meta.api_key_statemissing, valid, inactive oder ein anderer Fehlerstatus.Prüfen, ob dein Bearer-Token wirklich greift.
meta.allowed_horizon_hoursServerseitig erlaubter Maximalhorizont.Wichtig für 48h vs. 120h.
meta.used_horizon_hoursTatsächlich verwendeter Horizont.Zeigt, ob ein Request gekürzt wurde.
meta.used_calls_todayBisherige API-Aufrufe am Tag.Hilft bei echter Nutzungsbeobachtung im Test.

Hilf beim Test der nativen Homey-App

Installiere die Testversion und teile dein Homey-Modell, Land und deinen Automationsfall im Community-Thema. Besonders hilfreich sind Rückmeldungen zu Einrichtung, Planwechseln und Flow-Auslösern.