48 uur gratis, 120 uur met Private Pro

Waar is dit voor bedoeld?

Het endpoint levert alleen de tijdreeksen. De laadbeslissing blijft bij evcc. evcc kan deze waarden dan meenemen, bijvoorbeeld in de laadplanner voor goedkoop of CO2-geoptimaliseerd laden. De optimizer kan voorspellingsdata ook gebruiken, maar is in evcc nog experimenteel.

Zodra er gepubliceerde day-aheadprijzen zijn, gebruikt het endpoint die eerst. Voor de uren daarna komt onze voorspelling erbij. Dat is vooral interessant als je laadmomenten over meerdere dagen wilt plannen.

Snel starten: invoeren in evcc

Nieuw: uurprijzen voor evcc. Rekent je leverancier één uniforme prijs per uur? Gebruik dan onze HTTP-prijsbron met resolution=hourly. Naar de instelling voor uurtarieven.

Het blok hoort in evcc.yaml op het bovenste YAML-niveau, dus niet onder loadpoints, chargers, meters of afzonderlijke apparaten. Heb je al een blok tariffs:, maak het dan niet dubbel aan, maar vul de regels daar aan of vervang ze.

tariffs:
  currency: EUR
  grid:
    type: custom
    forecast:
      source: http
      uri: https://api.energypriceforecast.eu/api/v1/evcc/tariff?country=nl&type=grid&hours=48

  co2:
    type: custom
    forecast:
      source: http
      uri: https://api.energypriceforecast.eu/api/v1/evcc/tariff?country=nl&type=co2&hours=120

Start daarna evcc opnieuw. Met evcc tariff controleer je of evcc de waarden correct laadt. Wil je alleen de prijsvoorspelling testen, dan volstaat eerst het deel grid:.

Prijsvoorspelling in evcc invoeren

Voorbeeld voor Nederland. De waarden komen in EUR/kWh.

tariffs:
  currency: EUR
  grid:
    type: custom
    forecast:
      source: http
      uri: https://api.energypriceforecast.eu/api/v1/evcc/tariff?country=nl&type=grid&hours=48

hours=48 gebruikt de gratis prijshorizon. Sinds 1 oktober 2026 levert het endpoint zonder API-key maximaal 48 uur; bestaande anonieme 120-uursconfiguraties blijven werken en worden ingekort tot 48 uur.

Uurtarief: passende prijzen voor de planner

Geldt bij je leverancier één uniforme prijs voor elk vol uur, voeg dan aan de HTTP-URL van onze prijsbron dit toe: &resolution=hourly. De API middelt de vier gepubliceerde beurskwartieren tot één uurprijs. De modelvoorspelling daarna blijft per uur.

forecast:
  source: http
  uri: https://api.energypriceforecast.eu/api/v1/evcc/tariff?country=nl&type=grid&hours=48&resolution=hourly

Het blok is een uitsnede van je bestaande bron. Gebruik je onze data apart in de planner, wijzig dan alleen deze bron en behoud het tarief van je leverancier voor kosten en statistieken. Een bestaande prijsformule en de API-key-instellingen blijven behouden. De API levert nog steeds basisprijzen; opslagen en belastingen moeten bij je contract passen.

Ook binnen een lopend uur houdt de uurmodus rekening met alle vier kwartieren. Ontbreekt een waarde, dan gebruikt hij een volledige day-aheadvervangwaarde per uur of de modelvoorspelling per uur. Een gemiddelde van alleen de resterende kwartieren wordt niet als uurprijs teruggegeven.

Laat bij een kwartiertarief de URL ongewijzigd of gebruik resolution=native. Gepubliceerde beursprijzen blijven dan per kwartier; latere voorspellingswaarden blijven per uur.

Het ingebouwde evcc-template energypriceforecast biedt onder de geavanceerde instellingen average: true. Eigen bronnen van het type custom ondersteunen features: [average]. Voor een volledig gemiddelde van het lopende uur raden we de HTTP-bron aan met resolution=hourly; extra middelen in evcc is dan niet nodig. evcc-referentie

Tot 120 uur met een API-key

Vul je persoonlijke API-key als Bearer-token rechtstreeks in het HTTP-blok in en stel in: hours=120. De key hoort onder forecast.auth, niet in de URL.

tariffs:
  currency: EUR
  grid:
    type: custom
    forecast:
      source: http
      uri: https://api.energypriceforecast.eu/api/v1/evcc/tariff?country=nl&type=grid&hours=120
      auth:
        type: bearer
        token: "JOUW_API_KEY"

Start daarna evcc opnieuw en voer evcc tariff uit ter controle. Deel de API-key niet openbaar en zet hem niet in forumberichten of logs.

CO2-voorspelling in evcc invoeren

Voorbeeld voor Nederland. De waarden komen in g/kWh.

tariffs:
  co2:
    type: custom
    forecast:
      source: http
      uri: https://api.energypriceforecast.eu/api/v1/evcc/tariff?country=nl&type=co2&hours=120

CO2-waarden zijn voorspellingen. Ze helpen bij de timing en beschrijven de geschatte CO2e-belasting per verbruikte kWh, maar vervangen geen officiële emissiebalans.

Ondersteunde landen en prijszones

Testen in de browser

Met debug=1 krijg je ook metadata over de bron. In de evcc-configuratie hoort debug=1 niet thuis.

Goed om te weten

tariffs:
  grid:
    type: merged
    primary:
      type: template
      template: nordpool
      region: NO1
      currency: NOK
    secondary:
      type: template
      template: energypriceforecast
      region: NO1
      currency: NOK
      horizon: 48

Meer hierover