Documentatie / Quickstart

Snel starten met de Stroomprijzen API

Haal je eerste Nederlandse stroomprijs op. Met een gratis API-key, zonder SDK. Kies je taal en kopieer de code.

1. Haal de huidige stroomprijs op

Maak eerst een gratis API-key met je bevestigde e-mailadres. Stel STROOMPRIJZEN_API_KEY in als omgevingsvariabele op je server of in je terminal. Deel de key niet via je frontend. Lees point.allInEurKwh voor de prijs in euro per kWh inclusief energiebelasting en btw.

cURL
curl --fail-with-body \
  -H "Authorization: Bearer $STROOMPRIJZEN_API_KEY" \
  'https://stroomprijzenapi.nl/api/v1/prices/now'

Dit is geen volledig leverancierstarief. Leveranciersopslag, netbeheerkosten en vaste kosten zijn niet inbegrepen. Controleer of point beschikbaar is voordat je een apparaat aanstuurt.

2. Vraag een dag met kwartierprijzen op

date is een Nederlandse kalenderdag in Europe/Amsterdam. Onderstaand voorbeeld gebruikt een historische datum. Laat date weg voor morgen zodra gepubliceerd, anders vandaag.

cURL / kwartierprijzen
curl --fail-with-body \
  -H "Authorization: Bearer $STROOMPRIJZEN_API_KEY" \
  'https://stroomprijzenapi.nl/api/v1/prices?date=2026-08-15&resolution=quarterhour'

Gebruik resolution=hour voor uurprijzen en resolution=quarterhour voor kwartierprijzen. De intervallen staan in points.

  • Morgen vóór publicatie rond 14:00 Nederlandse tijd: een lege points-array.
  • Zomer- en wintertijd: 23 of 25 uren, of 92 of 100 kwartieren. Match op momentUtc.
  • Ruwe uurdata is opgeslagen vanaf 5 januari 2015. De prijsberekening inclusief belastingen ondersteunt de meegeleverde belastingjaren vanaf 2019. Kwartierprijzen beginnen op 1 oktober 2025.

3. Gebruik je API-key en bekijk je verbruik

Maak een gratis API-key voor 10.000 requests per dag. Vervang jouw-key en voer dit lokaal uit. /keys/me laat je tier, limiet en verbruik zien.

Terminal / authenticatie controleren
export STROOMPRIJZEN_API_KEY='jouw-key'
curl --fail-with-body \
  -H "Authorization: Bearer $STROOMPRIJZEN_API_KEY" \
  'https://stroomprijzenapi.nl/api/v1/keys/me'

Gebruik dezelfde header voor de prijs-endpoints. Een ontbrekende, onbekende of ingetrokken key geeft 401. Bij 429 respecteer je Retry-After; bij een andere fout controleer je eerst status en response. Cache antwoorden en behoud je laatste geldige data bij een tijdelijke storing.

4. Bouw je integratie