Plan energiegebruik in Homey op prijs en net-CO₂

Installeren in vier stappen

1. Open de Homey testpagina.
2. Accepteer de melding voor het testkanaal en installeer de app op je compatibele Homey.
3. Voeg het apparaat Prijs- & CO₂-prognose toe en volg de begeleide configuratie.
4. Gebruik de Flow-kaarten om op het juiste moment te schakelen, laden, verwarmen of melden.

Zo wordt de prognose opgebouwd

De prijslogica is ook voor Homey niet simpelweg “alleen forecast”. Ze werkt bewust in twee stappen, zodat echte marktdata altijd voorrang houden zodra ze beschikbaar zijn.

Geavanceerd alternatief: HomeyScript en directe API-toegang

Voor de meeste gebruikers is de native app hierboven de juiste start. Voor eigen scripts blijft er een summary-pad waarvan structuur en naamgeving zijn afgestemd op HomeyScript en Advanced Flow.

Alternatief: volledige prijsreeks voor eigen logica

Wil je prijzen zelf vergelijken, drempels berekenen of eigen tijdvensters kiezen in plaats van alleen kant-en-klare signalen te gebruiken? Gebruik dan de Homey-prijsreeks.

mode=mixed gebruikt officiële day-ahead-prijzen zodra die beschikbaar zijn en vult alleen de resterende horizon aan met de prognose. Echte kwartierprijzen blijven kwartierprijzen; uurprognoses worden als vier gelijke kwartierslots geleverd.

const API_KEY = '';
const url = 'https://api.energypriceforecast.eu/api/v1/homey/prices?country=nl&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('Geen geldige prijzen ontvangen');
return Math.min(...prices);

Dit voorbeeld geeft de laagste basisprijs van de komende twaalf uur terug als Number. De waarden zijn standaard marktprijzen zonder belastingen en netkosten.

Wat de API precies teruggeeft

De Homey-endpoint levert een compacte automation-weergave. Dat is belangrijk, omdat je in Homey meestal niet wilt starten met een complete ruwe tijdreeks, maar met een paar heldere waarden voor Flows.

Periode en resolutie

De voorbeelden gebruiken hours=48 en window_hours=4. Dat is een goed startpunt, maar niet de volledige productgrens.

Zo gebruik je dit in Advanced Flow

1. Installeer HomeyScript.
2. Maak in Advanced Flow een tijdtrigger, bijvoorbeeld elke 15 minuten.
3. Voeg daarna een HomeyScript-kaart toe met returntype Number, Yes/No of Text.
4. Plak een van de copy-paste-blokken hieronder.
5. Gebruik de result-tag in de volgende Flow-stap.

Homey beschrijft HomeyScript expliciet als manier om website-API’s te benaderen. De onderstaande voorbeelden gebruiken precies dat met de Homey-summary-endpoint.

Voorbeeld 1: actuele prijs als Number teruggeven

Handig als je op drempelwaarden of vergelijkingen wilt sturen.

const API_KEY = '';
const url = 'https://api.energypriceforecast.eu/api/v1/homey/summary?country=nl&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('Geen actuele prijs ontvangen');
return price;

Voorbeeld 2: loopt het beste prijsvenster nu?

Voor echte automatiseringen is dat vaak belangrijker dan alleen weten wanneer het volgende venster start.

const API_KEY = '';
const url = 'https://api.energypriceforecast.eu/api/v1/homey/summary?country=nl&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;

Voorbeeld 3: volgende volledige start als Text teruggeven

Praktisch voor planning, dashboards of meldingen.

const API_KEY = '';
const url = 'https://api.energypriceforecast.eu/api/v1/homey/summary?country=nl&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 || '');

Optioneel met API-key

Als je meer dan de vrije horizon wilt testen, zet je de key direct in het script. De API verwacht op dit moment een Bearer-header.

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

Doorslaggevend is uiteindelijk niet alleen wat je in de URL vraagt, maar wat de server in meta.allowed_horizon_hours echt toestaat.

Typische Homey-use-cases

Belangrijke meta-velden voor debug