WattWanneer

WattWanneer API

Automatiseer je apparaten op de voorspelling van komende week.

Je auto, thuisbatterij en warmtepomp kiezen zelf de goedkoopste uren. Werkt met Home Assistant, Homey, evcc, je eigen scripts en AI-assistenten als Claude. Voor Nederland, en nu ook voor België.

Maandelijks opzegbaar · inclusief btw · je key staat direct na betaling in je mail

95% van de dagen zat het goedkoopste laadmoment binnen een uur goed, tot 7 dagen vooruit
0,2 ct per kWh verschil met het perfecte laadmoment
168 uur vooruit, elke middag een nieuwe voorspelling
13 endpoints, van prijsreeks tot batterijplan

Gemeten op wat we echt publiceerden, tegen de werkelijke EPEX-prijzen. Zo meten we.

Zo werkt het

  1. Sluit af

    € 4,99 per maand, afrekenen via Stripe. Maandelijks opzegbaar.

  2. Ontvang je key

    Direct na betaling staat je persoonlijke API-key in je mail.

  3. Koppel je systeem

    Home Assistant: met één klik in HACS. Homey: twee scripts plakken. evcc: één URL. Claude of ChatGPT: één adres. Geen van allen? Zet het in je agenda.

  4. Bespaar vanzelf

    Je auto, batterij en warmtepomp draaien op de goedkoopste uren van de week. Elke middag komt er een nieuwe voorspelling bij.

Wat je krijgt

Home Assistant integratie via HACS Acht sensoren zonder YAML, van de prijs nu tot het goedkoopste venster en de hele week als reeks. Homey HomeyScript Twee scripts plakken, en de prijzen en het laadplan staan als Tags in je Flows. Elektrische auto /charge-plan Geef je vertrektijd en hoeveel kWh erin moet. Je krijgt de goedkoopste uren, met laadverlies en de uren dat je auto thuis is. Thuisbatterij /battery-plan Wanneer laden, wanneer ontladen, en of een dag het cycleren waard is. Met rendement en slijtage. Warmtepomp /cheapest-hours De goedkoopste losse uren per dag, om je huis of boilervat op voor te stoken. Zonnepanelen /negative-hours · /feed-in Uren met een negatieve prijs, en per uur wat terugleveren oplevert tegenover zelf verbruiken. evcc, Victron, Node-RED /tariff Prijzen in het formaat dat evcc verwacht, all-in met je eigen opslag en btw. Eén URL. Prijzen per uur en kwartier /forecast · /v2/prices · /history 168 uur vooruit, de vastgestelde prijzen ook per kwartier, en onze voorspelling naast de echte prijs. Controleer ons gerust.

Of vraag het gewoon aan je AI-assistent

Koppel WattWanneer aan Claude of ChatGPT en vraag in je eigen woorden wanneer je het goedkoopst laadt, wast of je batterij vult. De assistent haalt de prijzen bij ons op en rekent het voor je uit. Geen code, geen grafiek lezen.

  • De prijzen van vandaag en morgen zijn gratis, ook zonder abonnement.
  • Met je key kijkt hij een hele week vooruit en maakt hij een laadplan voor je auto. In Claude kan dat met Pro of Max.
  • Werkt in Claude, ook met een gratis account. In ChatGPT voorlopig met Pro of een zakelijk abonnement.

Wanneer is stroom morgen het goedkoopst?

Mijn auto moet om 7:30 25 kWh erbij hebben. Wanneer laad ik?

Welke dag deze week draai ik de wasmachine het goedkoopst?

Gratis voorspellingen bestaan. Waarom dan deze?

Een gratis prijs-API geeft je getallen. De rest bouw je zelf. Wij leveren ook het plan, en de koppelingen voor Home Assistant en Homey.

Een gratis prijs-API WattWanneer API
Prijzen tot 7 dagen vooruitSomsJa, 168 uur
Laadplan voor je auto, met vertrektijdZelf bouwenKant-en-klaar
Batterijplan met rendement en slijtageZelf bouwenKant-en-klaar
Home AssistantMeestal een REST-snippetIntegratie met 8 sensoren, in HACS
HomeyZelf bouwenKant-en-klare scripts
Nauwkeurigheid gemeten op wat er echt stondZeldenElke dag, openbaar
Blijft het draaien?Vaak zonder garantieBetaalde dienst, met mail voor vragen

Zo maken we de voorspelling

Elke middag draait deze keten opnieuw, van ruwe data tot een gecontroleerde voorspelling.

  1. Data
    • Ruim 100.000 uur marktprijzen, sinds 2015
    • Weer op 23 punten: vier in en rond Nederland, waarvan twee op de Noordzee, veertien verspreid over de Duitse windparken op land en op zee, en vijf in de Duitse deelstaten met de meeste zonnepanelen
    • Wind op 100 meter, de hoogte van een windturbine
    • Gasprijs en feestdagen
  2. Drie modellen
    • Een kortetermijnmodel dat voortbouwt op de prijzen van gisteren en vorige week
    • Een direct model dat elke dag vooruit rechtstreeks uit het weer voorspelt
    • Een niveaumodel dat uit weer, gas en kalender bepaalt hoe duur een dag wordt
    • Gradient boosting, elke dag opnieuw getraind
  3. Mengen en bijsturen
    • Per dag vooruit een eigen verhouding tussen model en historisch dagpatroon
    • Een zonprofiel uit de dagen met vergelijkbare zon van de laatste zes weken
    • Eigen regels voor zonnige weekenden en feestdagen
  4. Controleren
    • Automatische controle voor publicatie. Valt die af, dan blijft de vorige voorspelling staan.
    • Elke dag nagemeten tegen de echte prijs, openbaar

Tot en met morgen krijg je de gepubliceerde marktprijzen, zodra de veiling rond 13:00 klaar is. Het hele verhaal staat in over het model.

Prijs

Thuis

€ 4,99 per maand, inclusief btw

  • Alle 13 endpoints
  • Home Assistant-integratie en Homey-scripts
  • 10.000 aanvragen per maand
  • Ook voor je lease- of zakelijke auto thuis
  • Maandelijks opzegbaar
Abonneren

Wie de goedkoopste dag van de week kiest, scheelt gemiddeld 5 cent per kWh. Bij twee laadsessies van 40 kWh per week is dat rond 200 euro per jaar.

Zakelijk

vanaf € 49 per maand, exclusief btw

  • Voor een dienst of product voor anderen
  • Laaddienst, energieplatform of dashboard voor klanten
  • Meerdere locaties of white-label
Bekijk zakelijk

Opzeggen of je betaalpas wijzigen doe je zelf in het klantportaal. Vragen? Mail wattwanneer@negoci.nl.

Veelgestelde vragen

Waarom betalen als er gratis voorspellingen zijn?

Een gratis voorspelling geeft je een prijsreeks. Bij ons krijg je ook het plan: wanneer je auto laadt, wanneer je batterij laadt en ontlaadt, en welke uren je warmtepomp draait. Plus een integratie voor Home Assistant en scripts voor Homey. En we meten elke dag openbaar hoe goed we zaten.

Werkt de WattWanneer API met Home Assistant?

Ja, en sinds augustus 2026 is er een kant-en-klare integratie. Die staat in de standaardlijst van HACS: je zoekt WattWanneer op, vult je API-key in en krijgt acht sensoren zonder YAML te schrijven. Liever zelf bouwen? De API werkt ook gewoon met de standaard rest-sensor. Op deze pagina staat een werkende configuratie inclusief een automation die de vaatwasser op het goedkoopste blok start.

Hoe koppel ik dynamische stroomprijzen aan Home Assistant?

Zet een rest-sensor op https://wattwanneer.nl/api/v1/summary met je API-key in de header X-API-Key, en lees daar de velden cheapest_window en average_price_next_24h uit. Voor het volledige uurverloop gebruik je /v1/forecast. Alle beschikbare velden staan in de technische documentatie.

Hoe vaak moet ik de API ophalen in Home Assistant?

Een keer per uur is ruim voldoende. De voorspelling wordt een keer per dag ververst, in de middag rond 14:30, dus vaker ophalen levert dezelfde data op. Het veld generated_at laat zien welke run je in handen hebt. De limiet is 10 verzoeken per minuut per key.

Werkt de WattWanneer API met Homey?

Ja, met Homey Pro via HomeyScript. Je zet de prijzen en de voorspelling als Tags in je Flows en kunt daar je auto, wasmachine of thuisbatterij op laten reageren. Homey Energy zelf werkt met day-ahead prijzen tot morgenavond, wij leveren 168 uur vooruit plus een uitgerekend laadplan. De volledige route staat in de Homey-handleiding.

Kan ik dezelfde key in Homey en Home Assistant gebruiken?

Ja. Beide naast elkaar op dezelfde key valt binnen hetzelfde huishoudelijke gebruik, en je hoeft dus niets extra's af te sluiten. De Homey-koppeling gebruikt de v2-endpoints met een eigen limiet van 20 aanvragen per minuut, los van de limiet op v1. Ze zitten elkaar dus niet in de weg. Gebruik je de data in een dienst voor anderen, dan geldt het zakelijke abonnement.

Werkt de API ook met evcc, Victron of Node-RED?

Ja. Het endpoint /v1/tariff geeft de prijzen in het formaat start, end en value dat evcc verwacht als custom tariff, zonder dat je een jq-filter nodig hebt. Datzelfde formaat werkt in Victron Dynamic ESS en in Node-RED. Met de parameters charges en vat reken je je eigen opslag en btw mee, zodat je een all-in tarief krijgt.

Werkt de API ook in België?

Ja. Zet zone=BE achter een v1-endpoint, of kies België als je de Home Assistant-integratie instelt. Voor vandaag en morgen krijg je de echte Belgische day-ahead prijzen. Voor de dagen daarna gebruiken we onze voorspelling, want de Belgische prijs volgt de Nederlandse op de voet: over het afgelopen jaar lag hij per uur gemiddeld 0,7 cent ernaast. Het zijn kale beursprijzen. Btw en nettarieven reken je mee met charges en vat op /v1/tariff. De v2-endpoints en de koppeling met AI-assistenten zijn voorlopig alleen voor Nederland.

Kan ik Claude of ChatGPT vragen wanneer stroom goedkoop is?

Ja. Voeg het adres https://wattwanneer.nl/api/mcp toe als eigen connector in Claude, of in ChatGPT met een Pro- of zakelijk abonnement. Daarna vraag je gewoon wanneer je het goedkoopst laadt of wast. De prijzen van vandaag en morgen zijn gratis. Met je API-key kijkt de assistent een hele week vooruit en maakt hij een laadplan voor je auto. Stap voor stap staat in dit artikel.

Kan ik mijn thuisbatterij aansturen met de API?

Het endpoint /v1/battery-plan geeft per dag de goedkoopste uren om te laden, de duurste om te ontladen, de verwachte spread en of die dag het cycleren waard is. Geef je capaciteit, vermogen en rendement mee. Het is bedoeld als arbitrage-indicatie: laat je eigen regelaar bepalen wanneer er daadwerkelijk geschakeld wordt.

Kan ik mijn elektrische auto laten laden op de goedkoopste uren?

Daar is /v1/charge-plan voor. Geef je vertrektijd, hoeveel kWh erin moet en je laadvermogen mee, en je krijgt de goedkoopste uren terug plus wat het scheelt met meteen beginnen laden. Optioneel geef je op wanneer je auto daadwerkelijk aan de paal hangt, want dat weegt zwaarder dan je laadvermogen. Past de vraag niet in de beschikbare tijd, dan krijg je het maximaal haalbare plan met het percentage dat gehaald wordt in plaats van een foutmelding.

Wat is het verschil met de day-ahead prijzen van ENTSO-E of mijn leverancier?

Day-ahead-bronnen geven de uurprijzen tot en met morgen, zodra de EPEX-veiling rond 13:00 is afgelopen. De WattWanneer API geeft diezelfde gepubliceerde marktprijzen plus zes dagen voorspelling erachter, in een reeks van 168 uur. Dat is nodig zodra je wilt kiezen welke dag of nacht van de week het goedkoopst is.

Mag ik de API gebruiken in mijn eigen product of dienst?

Het abonnement van 4,99 euro per maand is bedoeld voor je eigen huishouden, inclusief het thuis opladen van een lease- of zakelijke auto. Wil je de prijzen gebruiken in een product of dienst voor anderen, bijvoorbeeld een laaddienst, een energieplatform of een dashboard voor klanten, dan hoort daar een zakelijk abonnement bij. Op de pagina WattWanneer Zakelijk staan de niveaus met voorbeelden en de prijzen.

Hoe zeg ik op of wijzig ik mijn betaalpas?

Dat doe je zelf in het klantportaal van Stripe, de betaaldienst van WattWanneer. Vul daar het e-mailadres in waarmee je je hebt aangemeld, dan krijg je een inloglink. Daar zeg je op, wijzig je je betaalpas en download je je facturen. Na het opzeggen blijft je code werken tot het einde van de maand waarvoor je al betaald hebt. Daarna stopt hij vanzelf.

Voor ontwikkelaars

Alle velden per endpoint staan in de technische documentatie, de Homey-endpoints in de v2-documentatie.

Snel starten met curl
  1. Gebruik als base URL: https://wattwanneer.nl/api/v1
  2. Stuur je ontvangen API-key mee als header: X-API-Key: JOUW_API_KEY
  3. Test eerst met een kleine forecast-call voordat je automations aansluit.
curl -H "X-API-Key: JOUW_API_KEY" "https://wattwanneer.nl/api/v1/forecast?hours=24"

Alle timestamps zijn UTC. Een 401 betekent dat de key ontbreekt of ongeldig is. Een 429 betekent dat de rate limit tijdelijk is bereikt.

AI-assistenten koppelen (MCP)

Met de MCP-server vraag je je AI-assistent rechtstreeks naar de stroomprijs, bijvoorbeeld "wanneer laad ik morgen het goedkoopst 25 kWh voor 7:30?". Het adres is https://wattwanneer.nl/api/mcp. Het werkt met assistenten die MCP over HTTP ondersteunen, zoals Claude, ChatGPT (Pro en zakelijk), Cursor en VS Code. Geen ontwikkelaar? Zo koppel je Claude of ChatGPT in een paar minuten.

  • Gratis, zonder key. get_prices geeft de prijzen van vandaag en morgen, per uur of per kwartier. find_cheapest_window zoekt het goedkoopste blok binnen die gepubliceerde prijzen.
  • Met je API-key. get_forecast geeft de prijzen tot 7 dagen vooruit, plan_ev_charging het laadplan voor je auto, en find_cheapest_window zoekt dan ook in de voorspelling.

Stuur je key mee als header Authorization: Bearer JOUW_API_KEY.

Claude Code:

claude mcp add --transport http wattwanneer https://wattwanneer.nl/api/mcp \
  --header "Authorization: Bearer JOUW_API_KEY"

Cursor (.cursor/mcp.json):

{
  "mcpServers": {
    "wattwanneer": {
      "url": "https://wattwanneer.nl/api/mcp",
      "headers": { "Authorization": "Bearer JOUW_API_KEY" }
    }
  }
}

VS Code (.vscode/mcp.json):

{
  "servers": {
    "wattwanneer": {
      "type": "http",
      "url": "https://wattwanneer.nl/api/mcp",
      "headers": { "Authorization": "Bearer JOUW_API_KEY" }
    }
  }
}

In Claude op het web en in de desktop-app voeg je het adres toe als eigen connector. Met Claude Pro of Max zet je je key daarbij onder Request headers, als header Authorization met de waarde Bearer JOUW_API_KEY. Op een gratis account werken de gratis tools. Prijzen zijn kale beursprijzen in cent per kWh, en bij elke prijs staat of hij vaststaat of voorspeld is.

Home Assistant koppelen

De meest voorkomende use-case voor de WattWanneer API is automatische sturing van apparaten via Home Assistant: vaatwasser, EV, boiler, warmtepomp of thuisbatterij die zelf weten wanneer stroom goedkoop is.

Het snelst gaat dat met onze Home Assistant-integratie. Vul je API-key in en je hebt acht sensoren zonder configuratiewerk: huidige prijs, prijs volgend uur, gemiddelde, laagste en hoogste van vandaag, het goedkoopste venster, het weekgemiddelde met de volledige reeks als attribuut, en de prijzen in het formaat van de Nordpool-integratie. De integratie staat in de standaardlijst van HACS: zoek op WattWanneer, of gebruik de knop hieronder. Die opent je eigen Home Assistant en zet de integratie klaar. Uitleg staat in onze blogpost.

Toevoegen aan HACS

Wil je het liever zelf opbouwen, dan werkt de handmatige setup hieronder onverminderd.

1. Sensor met de eerstvolgende forecastprijs

De /v1/forecast endpoint geeft de komende forecasturen terug. Deze REST sensor toont de eerstvolgende prijs en bewaart de timestamp als attribuut:

sensor:
  - platform: rest
    name: "WattWanneer eerstvolgende prijs"
    resource: "https://wattwanneer.nl/api/v1/forecast?hours=24"
    method: GET
    headers:
      X-API-Key: "JOUW_API_KEY"
    value_template: "{{ value_json.points[0].price_eur_per_kwh | float }}"
    json_attributes_path: "$.points[0]"
    json_attributes:
      - timestamp
      - confidence_low
      - confidence_high
      - source
    unit_of_measurement: "EUR/kWh"
    scan_interval: 1800

2. Goedkoopste N-uurs venster vooruit

De /v1/summary endpoint rekent het goedkoopste N-uurs venster kant-en-klaar uit. Geen template-logica nodig:

sensor:
  - platform: rest
    name: "Goedkoopste 2-uurs venster start"
    resource: "https://wattwanneer.nl/api/v1/summary?windowHours=2"
    method: GET
    headers:
      X-API-Key: "JOUW_API_KEY"
    value_template: "{{ value_json.cheapest_window.start }}"
    json_attributes_path: "$.cheapest_window"
    json_attributes:
      - start
      - end
      - end_exclusive
      - avg_price
      - window_hours
    scan_interval: 1800

De sensor-state is nu de starttijd (ISO-timestamp) van het goedkoopste 2-uurs venster in de komende 24 uur. Voor andere lengtes pas je windowHours aan (ondersteund: 1 t/m 24).

3. Automation: vaatwasser op het goedkoopste 2-uurs venster

Trigger een apparaat exact op de starttijd van het venster:

automation:
  - alias: "Vaatwasser starten op goedkoopste 2-uurs venster"
    trigger:
      - platform: time_pattern
        minutes: "/1"
    condition:
      - condition: template
        value_template: >-
          {% set start = as_timestamp(states('sensor.goedkoopste_2_uurs_venster_start')) %}
          {{ start is number and start <= as_timestamp(now()) < start + 60 }}
      - condition: state
        entity_id: input_boolean.vaatwasser_gereed
        state: "on"
    action:
      - service: switch.turn_on
        target:
          entity_id: switch.vaatwasser_stekker
      - service: input_boolean.turn_off
        target:
          entity_id: input_boolean.vaatwasser_gereed

Eén valkuil hierbij. Deze automation vuurt precies op de starttijd van het venster. Ligt dat venster al achter je, dan gebeurt er de rest van de dag niets meer. Dat komt doordat /v1/summary rekent over de eerste 24 punten van de reeks, en die reeks begint bij middernacht van de dag waarop de voorspelling is gedraaid. ’s Zomers merk je dat nauwelijks, want de zon duwt het goedkoopste blok naar de middag. In januari 2026 lag het goedkoopste 3-uursvenster op 29 van de 31 dagen al vóór 12:00. Zet je die ochtend je vaatwasser klaar, dan draait hij niet.

Wil je een venster dat gegarandeerd nog moet komen, gebruik dan /v1/charge-plan. Dat endpoint laat uren die al voorbij zijn weg en geeft je een plan tot een deadline die je zelf opgeeft. Dat werkt net zo goed voor een vaatwasser als voor een auto: geef op wanneer het klaar moet zijn en hoeveel kWh het kost.

4. Grafiek met de prognose (ApexCharts)

Een veelgestelde vraag: hoe krijg je de voorspelling in een grafiek? Een gewone ApexCharts-kaart tekent alleen de geschiedenis van een sensor, en een prognose ligt in de toekomst. Daarvoor heb je een data_generator nodig plus een sensor die de hele reeks als attribuut heeft. De sensor Gemiddelde deze week uit onze integratie heeft dat: in het attribuut forecast staan alle 168 uren.

Let op de entity-id. In de interface heet die sensor Gemiddelde deze week, terwijl Home Assistant hem intern altijd sensor.wattwanneer_average_this_week noemt. Dat blijft zo als je Home Assistant in het Nederlands gebruikt, want entity-ids worden altijd van de Engelse naam afgeleid. Heb je de sensor zelf hernoemd, vul dan je eigen id in.

type: custom:apexcharts-card
header:
  title: Stroomprijs komende week
  show: true
graph_span: 7d
span:
  start: hour
now:
  show: true
  label: nu
series:
  - entity: sensor.wattwanneer_average_this_week
    name: Verwachte prijs
    type: area
    stroke_width: 2
    float_precision: 3
    unit: " €/kWh"
    data_generator: |
      return entity.attributes.forecast.map(p => {
        return [new Date(p.start).getTime(), p.price];
      });

Zet graph_span op 48h als je alleen vandaag en morgen wilt zien. Wil je kolommen die van kleur wisselen bij een prijsgrens, vervang dan type: area door:

    type: column
    color_threshold:
      - value: 0
        color: "#22c55e"
      - value: 0.10
        color: "#eab308"
      - value: 0.20
        color: "#ef4444"

Bouw je zonder onze integratie, dan werkt hetzelfde recept op de REST-sensor uit stap 1, mits je daar de volledige reeks als attribuut bewaart in plaats van alleen de eerstvolgende prijs.

Veelgebruikte automations

  • EV laden: 3-uurs venster, ~7-10 kWh per nacht. Schakelt de laadpaal of stuurt de OCPP-instructie via de Easee, Zaptec of Wallbox-integratie.
  • Vaatwasser of wasmachine: 1-2 uurs venster, getrigger via slimme stekker of Miele/Bosch-integratie.
  • Boiler / elektrisch warm water: 1 uurs venster is genoeg om de tank op te warmen.
  • Warmtepomp opwarmcyclus: 5-uurs venster met setpoint-verhoging.
  • Thuisbatterij: combineer met je inverter (Sonnen, GrowAtt, SolarEdge) en het venster-endpoint om laad- en ontlaadmomenten te plannen.
Homey koppelen

Draai je Homey Pro, dan kun je de prijzen en de voorspelling als Tags in je Flows gebruiken. Dat gaat via HomeyScript, de gratis scriptapp van Athom. Je plakt twee kant-en-klare scripts, vult je API-key in en je Flows kunnen sturen op de goedkoopste uren van de komende week.

De koppeling gebruikt drie endpoints die speciaal hiervoor zijn gemaakt:

  • GET /v2/prices geeft één doorlopende prijsreeks vanaf het lopende uur, waarin gepubliceerde marktprijzen en voorspelling zijn samengevoegd, met je eigen afname- en teruglevertarief erbij. Per uur, of met interval=15 per kwartier.
  • GET /v2/charge-plan rekent daarop een laadplan uit dat het lopende uur meeneemt.
  • POST /v2/battery-plan geeft een uitvoerbaar laad-, ontlaad- en bewaarplan voor een thuisbatterij, inclusief rendement, slijtage en laadstandgrenzen.

Ze zitten in hetzelfde abonnement en hebben een eigen limiet van 20 aanvragen per minuut, los van de limiet op de v1-endpoints. Gebruik je WattWanneer in Homey én in Home Assistant op dezelfde key, dan zitten die elkaar dus niet in de weg. De volledige beschrijving staat in de v2-documentatie.

curl -H "X-API-Key: JOUW_API_KEY" \
  "https://wattwanneer.nl/api/v2/prices?from=now&hours=168"

Naar de Homey-handleiding v2-documentatie

De bestaande /v1-endpoints veranderen hier niet door. Wie die al gebruikt in Home Assistant, evcc of eigen scripts hoeft niets aan te passen.

Voorbeelden per endpoint

Een prijsvoorspelling wordt pas nuttig als er iets van gaat bewegen. Dit zijn de koppelingen waar de API voor gemaakt is, per apparaat uitgelegd. Bouw je zelf een energiemanager en wil je precies weten welke velden elk endpoint teruggeeft? Bekijk dan de technische documentatie.

evcc / Victron / Node-RED: /v1/tariff

Laadpaal- en energiemanagementsoftware wil een kant-en-klare tarievenfeed. Dit endpoint levert precies dat formaat, all-in met je eigen opslag en btw. Eén URL instellen en je auto of batterij plant zichzelf rond de goedkoopste uren, tot zeven dagen vooruit in plaats van alleen tot morgen:

curl -H "X-API-Key: JOUW_API_KEY" \
  "https://wattwanneer.nl/api/v1/tariff?charges=0.12&vat=21"

[
  { "start": "2026-07-10T00:00:00Z", "end": "2026-07-10T01:00:00Z", "value": 0.312 },
  ...
]

Laad je thuis met een eigen laadpaal? Elke slim geladen kWh levert sinds 2026 via ERE-certificaten ook nog een vergoeding op, bovenop het prijsvoordeel.

Thuisbatterij: /v1/battery-plan

Geef je batterij door en krijg per dag het laad/ontlaadplan met winstindicatie:

curl -H "X-API-Key: JOUW_API_KEY" \
  "https://wattwanneer.nl/api/v1/battery-plan?capacity_kwh=10&power_kw=5&efficiency=0.9"

{ "days": [ {
    "date": "2026-07-10",
    "charge_hours": ["2026-07-10T11:00:00Z", "2026-07-10T12:00:00Z"],
    "avg_charge_price": 0.0113,
    "discharge_hours": ["2026-07-10T18:00:00Z", "2026-07-10T19:00:00Z"],
    "avg_discharge_price": 0.1499,
    "spread_eur_per_kwh": 0.1386,
    "estimated_profit_eur": 1.21,
    "worth_cycling": true
  }, ... ],
  "best_day": "2026-07-14" }

Het veld worth_cycling is de kern: dat zegt of de spread van die dag groot genoeg is om een laadcyclus (en de bijbehorende slijtage) waard te zijn. Haal het plan dagelijks rond 13:45 op, dan staat de verse voorspelling klaar en draait je batterij op de automatische piloot.

Elektrische auto: /v1/charge-plan

Waar /v1/battery-plan arbitrage doet, gaat dit om een vaste hoeveelheid energie die op een bepaald moment binnen moet zijn. Geef je vertrektijd, hoeveel kWh erin moet en wat je laadpaal aankan, en je krijgt de goedkoopste uren terug:

curl -H "X-API-Key: JOUW_API_KEY" \
  "https://wattwanneer.nl/api/v1/charge-plan?departure=2026-08-29T07:00&energy_kwh=30&power_kw=11"

{ "energy_from_grid_kwh": 33.33,
  "energy_scheduled_kwh": 33.33,
  "completion_pct": 100.0,
  "horizon_limited": false,
  "plan": [
    { "start": "2026-08-27T10:00:00Z", "kwh": 11.0, "price_eur_per_kwh": 0.0105, "cost_eur": 0.116 },
    { "start": "2026-08-27T11:00:00Z", "kwh": 11.0, "price_eur_per_kwh": 0.0050, "cost_eur": 0.055 },
    ... ],
  "total_cost_eur": 0.35,
  "cost_if_started_now_eur": 1.90,
  "savings_eur": 1.54,
  "savings_pct": 81.5 }

power_kw is verplicht en dat is met opzet: 1 fase 16A is 3,7 kW, 1 fase 32A is 7,4 kW en 3 fasen 16A is 11 kW. Met een verkeerde aanname krijg je een plan dat je laadpaal niet kan uitvoeren. Het laadverlies zit er ook in, vandaar dat energy_from_grid_kwh hoger uitvalt dan wat je vroeg.

Staat je auto niet de hele dag thuis, geef dan available_from en available_until mee (lokale uren, 18 tot 8 loopt over middernacht). Dat maakt meer uit dan je laadvermogen: we rekenden het door over heel 2025.

curl -H "X-API-Key: JOUW_API_KEY" \
  "https://wattwanneer.nl/api/v1/charge-plan?departure=2026-08-29T07:00&energy_kwh=30&power_kw=3.7&available_from=22&available_until=6"

Wordt het krap, dan krijg je geen foutmelding maar het maximaal haalbare plan. Vraag je bijvoorbeeld 30 kWh op 3,7 kW met vertrek de volgende ochtend, dan past dat niet in één nacht en ziet het antwoord er zo uit:

{ "energy_from_grid_kwh": 33.33,
  "energy_scheduled_kwh": 29.6,
  "energy_shortfall_kwh": 3.73,
  "completion_pct": 88.8,
  "note": "Er zijn te weinig beschikbare uren om de volledige vraag te laden; ..." }

Handig om op te alarmeren: onder de 100 vertrek je met minder lading dan gepland, en dan kun je besluiten eerder in te pluggen. Ligt je vertrek voorbij onze week-horizon, dan plannen we binnen wat we weten en staat horizon_limited op true.

Warmtepomp / boiler: /v1/cheapest-hours

Een (warmtepomp)boiler hoeft maar een paar uur per dag te draaien, en welke uren dat zijn maakt voor je warme douche niets uit. Vraag de goedkoopste uren van de komende 24 op en stuur er je relais of Home Assistant-automation mee aan. In de zomer landen die uren rond het middagdal van gemiddeld 2,4 cent, in de winter juist in de nacht; het patroon daarachter leggen we uit in het dagritme van de stroomprijs.

curl -H "X-API-Key: JOUW_API_KEY" \
  "https://wattwanneer.nl/api/v1/cheapest-hours?count=6"

Zonnepanelen: /v1/negative-hours

Bij een negatieve beursprijs betaal je met een dynamisch contract om terug te leveren, en steeds meer leveranciers rekenen daar ook nog terugleverkosten bovenop. Afgelopen zomer telden we 91 negatieve uren, meestal rond 13:00. Dit endpoint zet ze zeven dagen vooruit op een rij, zodat je er iets mee kunt: de omvormer die uren op nul-teruglevering zetten, of slimmer, die bijna-gratis stroom zelf opmaken door juist dan de boiler, batterij of auto te laten trekken. Zo wordt een kostenpost een voordeeltje. Hoe gek het kan worden zag je op 1 mei, toen de prijs onder de -50 cent dook.

curl -H "X-API-Key: JOUW_API_KEY" \
  "https://wattwanneer.nl/api/v1/negative-hours?threshold=0"

Met threshold vang je ook de bijna-gratis uren: threshold=0.02 geeft alles van 2 cent of minder.

Na de saldering: /v1/feed-in

Vanaf 1 januari 2027 vervalt de salderingsregeling en telt het moment van terugleveren wel degelijk. Dit endpoint zet per uur de opbrengst van teruglevering naast de besparing van zelf verbruiken, en geeft er een advies bij:

curl -H "X-API-Key: JOUW_API_KEY" \
  "https://wattwanneer.nl/api/v1/feed-in?energy_tax=0.09161&vat=21&charges=0.021"

{ "hours": [
    { "timestamp": "2026-08-28T14:00:00Z", "market_eur_per_kwh": 0.1079,
      "feed_in_eur_per_kwh": 0.1079, "self_use_eur_per_kwh": 0.2668, "advice": "self_use" },
    { "timestamp": "2026-08-29T10:00:00Z", "market_eur_per_kwh": -0.0051,
      "feed_in_eur_per_kwh": -0.0051, "self_use_eur_per_kwh": 0.1301, "advice": "curtail" },
    ... ],
  "summary": {
    "hours_feed_in_negative": 9,
    "avg_feed_in_eur_per_kwh": 0.118,
    "avg_self_use_eur_per_kwh": 0.2791,
    "self_use_vs_feed_in_ratio": 2.4 } }

De energiebelasting betaal je bij afname en niet bij teruglevering, en juist dat verschil maakt zelf verbruiken ongeveer twee keer zo waardevol. Geef daarom in elk geval energy_tax (eerste schijf 2026: 0,09161 exclusief btw) en vat mee; zonder parameters zie je de kale marktprijs.

Rekent je leverancier terugleverkosten, zet die dan in deduction. Betaalt hij juist een toeslag bovenop de marktprijs, wat bij meerdere dynamische leveranciers gebeurt, geef die dan negatief mee: deduction=-0.02.

Met floor_pct=50 reken je de wettelijke ondergrens mee die van 2027 tot en met 2030 geldt: minimaal de helft van het kale leveringstarief. Die bodem bijt in de goedkope uren en scheelt daar flink. Een uur met een marktprijs van 1,05 cent en twee cent inhouding komt zonder bodem uit op min 0,95 cent, met bodem op 1,58 cent. Per uur zie je in floor_applied of hij het overnam.

curl -H "X-API-Key: JOUW_API_KEY" \
  "https://wattwanneer.nl/api/v1/feed-in?deduction=-0.02&floor_pct=50&energy_tax=0.09161&vat=21&charges=0.021"

Uren met advies curtail kosten je geld bij teruglevering: daar wil je je omvormer terugregelen of de productie in je accu stoppen. De tijdstempels daarvan staan gebundeld in summary.negative_hours, zodat je er direct op kunt schakelen.

Controleer ons: /v1/history

Gerealiseerde prijzen naast onze 2-dagen-vooruit voorspelling, met MAE en binnen-5-cent-percentage:

curl -H "X-API-Key: JOUW_API_KEY" \
  "https://wattwanneer.nl/api/v1/history?days=7"

Bouw er je eigen nauwkeurigheidsdashboard mee, of check gewoon af en toe of wij onze beloftes waarmaken. Wij kijken via dezelfde cijfers mee, dus we kunnen nergens heen.

Voorbeeld API-aanroepen

Gebruik steeds de header X-API-Key: <JOUW_KEY>.

curl

curl -H "X-API-Key: JOUW_API_KEY" "https://wattwanneer.nl/api/v1/forecast?hours=168"

Goedkoopste venster

curl -H "X-API-Key: JOUW_API_KEY" "https://wattwanneer.nl/api/v1/summary?windowHours=3"

België

curl -H "X-API-Key: JOUW_API_KEY" "https://wattwanneer.nl/api/v1/forecast?hours=168&zone=BE"

JavaScript fetch

fetch("https://wattwanneer.nl/api/v1/forecast?hours=168", {
  headers: { "X-API-Key": "JOUW_API_KEY" }
})
  .then((res) => res.json())
  .then((data) => console.log(data));

Base URL + headers

Base URL: https://wattwanneer.nl/api/v1/
Header:    X-API-Key: JOUW_API_KEY
Rate limit: 10 req/min per key
Responsevoorbeelden

Drie voorbeelden om de vorm te zien. Wil je van elk endpoint alle velden weten, met type en betekenis? Dat staat compleet in de technische documentatie.

/v1/forecast

{
  "zone": "NL",
  "generated_at": "2026-07-02T06:42:00Z",
  "model_version": "hist_gradient_boosting",
  "horizon_hours": 24,
  "points": [
    {
      "timestamp": "2026-07-02T22:00:00Z",
      "price_eur_per_kwh": 0.0999,
      "confidence_low": 0.0592,
      "confidence_high": 0.1406,
      "source": "model"
    }
  ]
}

/v1/summary

{
  "zone": "NL",
  "generated_at": "2026-07-02T06:42:00Z",
  "cheapest_hours_next_24h": [
    "2026-07-03T11:00:00Z",
    "2026-07-03T12:00:00Z",
    "2026-07-03T10:00:00Z"
  ],
  "cheapest_window": {
    "window_hours": 3,
    "start": "2026-07-03T10:00:00Z",
    "end": "2026-07-03T12:00:00Z",
    "end_exclusive": "2026-07-03T13:00:00Z",
    "avg_price": -0.0316
  },
  "average_price_next_24h": 0.0806,
  "average_price_next_7d": 0.1045,
  "expected_peak_price_next_7d": 0.3028
}

/v1/metrics

{
  "model_version": "hist_gradient_boosting",
  "mae_eur_per_kwh": 0.0124,
  "r2": 0.92,
  "n_samples": 95258,
  "last_backtest_range": {
    "from": "2026-05-14",
    "to": "2026-05-21"
  }
}

De prijzen tot en met morgen zijn gepubliceerde marktprijzen, daarna is het een voorspelling. Die kan afwijken door marktvolatiliteit, datavertraging of modelbeperkingen. WattWanneer is niet aansprakelijk voor beslissingen, kosten of schade door automatiseringen op deze data. Gebruik het als indicatie, met je eigen controles.