Strompreis und CO2 in Homey nutzen, ohne eigene Homey-App zu bauen

Wichtige Logik früh erklärt

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.

Empfohlener Einstieg: Summary

Für Homey gibt es einen eigenen Summary-Pfad. Technisch ist er nah an den anderen Automations-Endpunkten, aber in Struktur und Benennung klar auf HomeyScript und Advanced Flow zugeschnitten.

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.

Zeitraum und Auflösung

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

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();
return Number(data.flat?.current_price ?? 0);

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

Wichtige Meta-Felder für Debug