Taal

DE NL FR DA EN CS

Home Assistant · prijs en CO2

Home Assistant heeft hier geen aparte integratie nodig

Voor stroomprijs, CO2 en de beste tijdvensters volstaat een gewone REST-sensor. De publieke summary-endpoint geeft de belangrijkste waarden direct als JSON terug.

Webapp openen Live-JSON openen

geen add-on en geen HACS-component nodig
één endpoint voor prijs, CO2 en tijdvensters
duidelijk onderscheid tussen basisprijs, CO2 en totaalprijs-ondersteuning

Belangrijk

De API is direct bruikbaar in Home Assistant, scripts en andere automatiseringen. Wat vooral ontbrak was begrijpelijke documentatie, niet een extra technische integratie.

API-migratie

Nieuwe integraties moeten vanaf nu https://api.energypriceforecast.eu/api/v1/... gebruiken. Oudere project-URL's werken voor bestaande setups deels nog, maar mogen niet langer als referentie voor nieuwe integraties worden gebruikt.

Aanbevolen endpoint

Voor Home Assistant is /api/v1/home-assistant/summary het meest praktisch. De endpoint levert niet alleen ruwe waarden, maar ook al berekende vensters voor goedkoop, groen en gecombineerd gebruik.

https://api.energypriceforecast.eu/api/v1/home-assistant/summary?country=nl&hours=48&window_hours=4

Prijsflat.current_price en flat.cheapest_window_*.

CO2flat.current_co2_g_kwh en flat.greenest_window_*.

Gecombineerdflat.combined_window_* voor de compromiskeuze tussen prijs en CO2.

Snelle start voor copy-paste

Ja, dit is bewust zo opgezet dat een gewone Home Assistant-configuratie genoeg is. De eenvoudigste route is: YAML-blok plakken, markt aanpassen, Home Assistant herladen.

Plaats het YAML-blok hieronder in configuration.yaml of in een package-bestand dat Home Assistant al inlaadt.
Pas alleen country aan. Gebruik voor Denemarken altijd dk1 of dk2.
Herlaad of herstart Home Assistant.
Controleer onder Ontwikkelaarstools of de nieuwe sensoren waarden teruggeven.

Geschikt voor beginnersHet voorbeeld gebruikt bewust eenvoudige flat-velden in plaats van complexe templates, zodat het copy-paste-vriendelijk blijft.

Wat je moet aanpassenMeestal alleen country. De rest kan ongewijzigd blijven.

Wat je daarna zou moeten zienMinstens één sensor voor de actuele prijs en één sensor voor het goedkoopste venster.

REST-sensorvoorbeeld

Dit voorbeeld vraagt Nederland elke 15 minuten op. Voor andere markten hoef je alleen de parameter country te wijzigen.

rest:
  - resource: "https://api.energypriceforecast.eu/api/v1/home-assistant/summary?country=nl&hours=48&window_hours=4"
    scan_interval: 900
    sensor:
      - name: "StroomprijsVoorspelling actuele prijs"
        value_template: "{{ value_json.flat.current_price }}"
        unit_of_measurement: "EUR/kWh"

      - name: "StroomprijsVoorspelling actuele CO2-intensiteit"
        value_template: "{{ value_json.flat.current_co2_g_kwh }}"
        unit_of_measurement: "gCO2/kWh"

      - name: "StroomprijsVoorspelling goedkoopste venster start"
        value_template: "{{ value_json.flat.cheapest_window_start }}"

      - name: "StroomprijsVoorspelling groenste venster start"
        value_template: "{{ value_json.flat.greenest_window_start }}"

Na het invoegen Home Assistant herladen of herstarten en de sensorwaarden onder Ontwikkelaarstools controleren.

Officiële veldreferentie voor `home-assistant/summary`

De summary-endpoint is bewust compact. Voor veel automatiseringen volstaat het blok flat. Wie meer controle of eigen dashboards wil, kan daarnaast de blokken price, co2, combined en source gebruiken.

Veld	Betekenis	Typisch gebruik
`flat.current_price`	Actuele prijs in `EUR/kWh`. Voor de lopende slot gebruikt de API automatisch de beste publiek beschikbare bron.	Eenvoudige prijssensor voor automatiseringen.
`flat.current_price_source`	Bronlabel van de actuele prijs, bijvoorbeeld `day_ahead`.	Controleren of de waarde al officieel is of nog voorspeld.
`flat.current_co2_g_kwh`	Actuele CO2-intensiteit in `gCO2/kWh`.	CO2-gestuurde belastingverschuiving.
`flat.cheapest_window_*`	Start, einde en gemiddelde waarde van het goedkoopste tijdvenster.	EV-laden, boiler, warmtepomp.
`flat.greenest_window_*`	Start, einde en gemiddelde waarde van het groenste tijdvenster.	CO2-geoptimaliseerde planning.
`flat.combined_window_*`	Compromisvenster tussen prijs en CO2.	Wanneer beide belangrijk zijn zonder eigen scorelogica.
`price.current`	Object met `start`, `end`, `value`, `unit` en `source` voor de actuele prijsslot.	Dashboards en preciezere logica.
`price.cheapest_window_next_horizon`	Gestructureerd blok voor het goedkoopste venster, inclusief duur en bronverdeling.	Als je start, einde en context samen wilt gebruiken.
`co2.current`	Object met actuele CO2-waarde en het bijbehorende tijdvenster.	CO2-weergave zonder parsing uit `flat`.
`co2.greenest_window_next_horizon`	Gestructureerd blok voor het groenste venster.	CO2-geoptimaliseerd laden of verwarmen.
`combined.best_window_next_horizon`	Gecombineerd aanbevelingsblok met prijs-, CO2- en scorewaarden.	Eén directe beslissing zonder eigen gewichten.
`source.price`	Metadata over de prijsbron, inclusief Firestore-document, day-ahead-provider en aantallen beschikbare waarden.	Debugging, monitoring en kwaliteitscontrole.
`source.co2`	Metadata over de CO2-bron.	Debugging en herleidbaarheid.

Belangrijk over prijsveldenDe summary-endpoint levert niet de volledige ruwe tijdreeks van alle prijsvarianten. Voor Home Assistant levert hij vooral de actuele toestand en reeds berekende vensters. Voor volledige uurlijkse reeksen is hourly-forecast geschikter.

Actueel is niet hetzelfde als historisch vaststaandflat.current_price is de publiek bruikbare prijs voor de lopende slot. Die kan uit de officiële day-ahead komen of uit een andere vrijgegeven bron wanneer de marktuitkomst nog niet volledig beschikbaar is.

Totaalprijs alleen voor geselecteerde marktenDe publieke retail-forecast-endpoint is momenteel alleen bedoeld voor geselecteerde markten. Voor andere markten blijft de summary bewust bij markt- of basiswaarden.

Wanneer volstaat `summary` en wanneer heb je `hourly-forecast` nodig?

summary volstaat voor eenvoudige automatiseringen

Als je alleen de actuele prijs, de actuele CO2-intensiteit of het beste 4-uursvenster nodig hebt, is home-assistant/summary de juiste endpoint. Zo blijft de YAML kort en vermijd je onnodig parsen.

hourly-forecast is beter voor grafieken en complexere templates

Als je zelf grafieken wilt tekenen, eigen scores wilt berekenen of day-ahead apart van modelvoorspelling wilt tonen, gebruik dan hourly-forecast. Daar zijn de uurlijkse reeksen explicieter zichtbaar.

Supportmatrix van de publieke API

Niet elk zichtbaar land is al voor elk publiek endpoint vrijgegeven. Daarom is het beter om expliciet te tonen welke markten per endpoint echt ondersteund worden.

Markt	`hourly-forecast`	`home-assistant/summary`	`co2-live`	Eindprijsprognose voor consumenten `retail-forecast`
DE	ja	ja	ja	ja
NL	ja	ja	ja	ja
BE	ja	ja	ja	nee
FR	ja	ja	ja	nee
CZ	ja	ja	nee	nee
DK1	ja	ja	ja	ja
DK2	ja	ja	ja	ja

DenemarkenGebruik voor Denemarken altijd dk1 of dk2. dk valt terug op DK1.

TsjechiëCZ is publiek nu prijs-only: de summary werkt, maar zonder publieke CO2-endpoint en zonder totaalprijs.

Eindprijs voor consumentenMet retail-forecast wordt hier een geschatte eindklantprijs bedoeld, niet alleen de kale markt- of basisprijs. Publiek beschikbaar is dit momenteel alleen voor DE, NL, DK1 en DK2.

Belangrijke opmerkingen

Is dit een officiële Home Assistant-integratie?

Nee. Dit is bewust een eenvoudige REST-aanpak. Die is stabieler, makkelijker te testen en voor veel setups volledig voldoende.

Zijn de API-prijzen mijn exacte huishoudtarief?

Niet automatisch. hourly-forecast en de Home-Assistant-summary leveren eerst markt- of basisprijzen. Het exacte totaal hangt per land af van netkosten, belastingen, heffingen en leveranciersmarges.

Wat gebeurt er bij een niet-ondersteund land?

De publieke API geeft daarvoor nu bewust een foutmelding in plaats van stil op Duitsland terug te vallen. Dat is expres strenger, zodat automatiseringen geen verkeerde data krijgen.

Wat als er na het plakken geen waarden verschijnen?

De meest voorkomende oorzaken zijn: YAML op de verkeerde plek geplaatst, Home Assistant niet herladen, een niet-ondersteunde country-waarde of een fout in de YAML-inspringing. Ontwikkelaarstools en de Home Assistant-logs laten dat meestal direct zien.

Gerelateerd: evcc met stroomprijs- en CO2-prognose.

Markt	`hourly-forecast`	`home-assistant/summary`	`co2-live`	Eindprijsprognose voor consumenten `retail-forecast`
DE	ja	ja	ja	ja
NL	ja	ja	ja	ja
BE	ja	ja	ja	nee
FR	ja	ja	ja	nee
CZ	ja	ja	nee	nee
DK1	ja	ja	ja	ja
DK2	ja	ja	ja	ja

Markt	`hourly-forecast`	`home-assistant/summary`	`co2-live`	Eindprijsprognose voor consumenten `retail-forecast`
DE	ja	ja	ja	ja
NL	ja	ja	ja	ja
BE	ja	ja	ja	nee
FR	ja	ja	ja	nee
CZ	ja	ja	nee	nee
DK1	ja	ja	ja	ja
DK2	ja	ja	ja	ja

Home Assistant heeft hier geen aparte integratie nodig

Aanbevolen endpoint

Snelle start voor copy-paste

REST-sensorvoorbeeld

Officiële veldreferentie voor home-assistant/summary

Wanneer volstaat summary en wanneer heb je hourly-forecast nodig?

Supportmatrix van de publieke API

Belangrijke opmerkingen

Officiële veldreferentie voor `home-assistant/summary`

Wanneer volstaat `summary` en wanneer heb je `hourly-forecast` nodig?

Markt	`hourly-forecast`	`home-assistant/summary`	`co2-live`	Eindprijsprognose voor consumenten `retail-forecast`
DE	ja	ja	ja	ja
NL	ja	ja	ja	ja
BE	ja	ja	ja	nee
FR	ja	ja	ja	nee
CZ	ja	ja	nee	nee
DK1	ja	ja	ja	ja
DK2	ja	ja	ja	ja