WattWanneer API

Dynamische energieprijsvoorspellingen voor jouw app, website of platform

Integreer de 168-uurs stroomprijsverwachting van WattWanneer en voeg direct waarde toe aan je product: automatisch laadadvies, slimme schakelschema’s, kostenoptimalisatie en voorspellend energiebeheer. Drie heldere JSON-endpoints, secured met API-keys, inclusief transparante modelkwaliteit.

Ontworpen voor professionele energie-automatisering

De WattWanneer API is geschikt voor elke toepassing die afhankelijk is van dynamische energieprijzen. Slimme batterijopslag, EV-laadsystemen, warmtepompen, boilers en domotica kunnen met onze 168-uurs forecast exact bepalen wanneer energie gunstig of ongunstig is. Zo bouw je moeiteloos logica voor goedkoop laden, peak-shaving, load-shifting en geoptimaliseerd bufferen. Onze gestandaardiseerde JSON-structuur maakt integratie eenvoudig en betrouwbaar — ideaal voor bedrijven die kostenbesparing en slimme automatisering willen koppelen aan actuele én toekomstige energieprijzen.

Snel starten

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.

Responsevoorbeelden

{
  "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"
    }
  ]
}

{
  "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
}

{
  "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"
  }
}

Voorbeeld API-aanroepen

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

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

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

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: https://wattwanneer.nl/api/v1/
Header:    X-API-Key: JOUW_API_KEY
Rate limit: 10 req/min per key

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. Hieronder een werkende setup. Lees ook onze blogpost voor de bredere context.

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

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.

Verdienmodel: rekent zich snel terug

Een gemiddeld huishouden met EV, vaatwasser, wasmachine en boiler bespaart 150 tot 400 euro per jaar door slim te schakelen op de goedkoopste uren. De API kost €4,99 per maand (10.000 requests, ruim genoeg voor automations die elke 30 minuten pollen). Dat is binnen de eerste maand terugverdiend.

Transparantie & nauwkeurigheid

De nauwkeurigheid is transparant opvraagbaar: via /v1/metrics haal je de modelkwaliteit op, zoals de MAE (gemiddelde afwijking), R², het aantal datapunten en de laatste backtest-range. De MAE ligt doorgaans rond de 1 tot 2,5 cent per kWh, afhankelijk van de marktvolatiliteit. Het model traint op ruim 95.000 uur historische EPEX-data en wordt dagelijks opnieuw getraind.

Disclaimer

De gegevens die WattWanneer verstrekt – inclusief de 168-uurs prijsvoorspelling, samenvattende inzichten en modelmetrics – zijn gebaseerd op historische marktgegevens en een voorspellend model. Hoewel we streven naar een zo betrouwbaar mogelijke forecast, kunnen afwijkingen en onjuiste prijzen voorkomen door marktvolatiliteit, datavertragingen of modelbeperkingen. WattWanneer kan niet aansprakelijk worden gesteld voor beslissingen, kosten, schade of automatiseringen die voortkomen uit het gebruik van deze data. Gebruik de informatie als indicatie en combineer deze waar nodig met eigen controles of aanvullende bronnen.