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. Één helder JSON-endpoint, secured met API-keys, inclusief volledig 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.

Wat de API biedt

168-uurs uurprijzen voor Nederland in €/kWh
Samenvattingen: goedkoopste uren, gemiddelde prijs en verwachte piek
Modelnauwkeurigheid: MAE, R², aantal datapunten en laatste backtest-range
Standaard JSON-format, eenvoudig aan te roepen met curl of fetch

Hoe werkt de API?

Eén simpel abonnement: €9,99 p/m
Inclusief alle endpoints: forecast, summary, metrics
Fair use: tot 50.000 requests per maand per API key
Rate limit: 10 requests per minuut per key
Base URL: https://api.wattwanneer.nl/v1/

Interesse? Vraag een API-key aan

Stuur ons een kort bericht met je bedrijfsnaam, geplande use-case en het verwachte verbruik. Wij activeren vervolgens handmatig het €9,99-per-maand abonnement en leveren je direct een unieke API-key voor productiegebruik.

Vraag een API key aan

Voorbeeld JSON

/v1/forecast

{
  "zone": "NL",
  "generated_at": "2025-11-20T12:00:00Z",
  "model_version": "rf-2025.11.01",
  "horizon_hours": 168,
  "points": [
    {
      "timestamp": "2025-11-20T12:00:00Z",
      "price_eur_per_kwh": 0.1217,
      "confidence_low": 0.1097,
      "confidence_high": 0.1367
    }
  ]
}

/v1/summary

{
  "zone": "NL",
  "generated_at": "2025-11-20T12:00:00Z",
  "cheapest_hours_next_24h": [
    "2025-11-21T07:00:00Z",
    "2025-11-21T04:00:00Z",
    "2025-11-21T05:00:00Z"
  ],
  "average_price_next_24h": 0.1229,
  "average_price_next_7d": 0.1198,
  "expected_peak_price_next_7d": 0.1518
}

/v1/metrics

{
  "model_version": "rf-2025.11.01",
  "mae_eur_per_kwh": 0.01014,
  "r2": 0.886,
  "n_samples": 95258,
  "last_backtest_range": {
    "from": "2025-09-01",
    "to": "2025-11-01"
  }
}

Voorbeeld API-aanroepen

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

curl

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

JavaScript fetch

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

Base URL + headers

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

Transparantie & nauwkeurigheid

De nauwkeurigheid wordt gemeten met MAE en R² op basis van 95.258 rijen historische EPEX-data. Een MAE van ongeveer 0,01014 €/kWh en een R² van 0,886 is sterk voor een volatiele energiemarkt. Modellevaluaties draaien periodiek zodat nieuwe backtests eenvoudig kunnen worden doorgestuurd naar dit endpoint.

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.