Documentatie / Endpointoverzicht

Stroomprijzen API: endpoints en responsevelden

Prijzen, belastingopbouw, datadekking en API-toegang. Base URL: https://stroomprijzenapi.nl.

9 endpoints

GET/api/v1/pricesKey verplicht

Dagprijzen

Uurprijzen of kwartierprijzen van één Nederlandse kalenderdag. Parameters: date=YYYY-MM-DD en resolution=hour of quarterhour.

Parameters & response in de reference ↗
POST/mcpKey verplicht

MCP-server

Streamable HTTP met zes alleen-lezen tools. JSON-RPC voor AI-assistenten.

MCP configureren ↗

Welk prijsveld gebruik je?

Voor een prijs inclusief belastingen gebruik je allInEurKwh. Een leveranciersopslag moet je zelf toevoegen. De jaarlijkse belastingvermindering is een bedrag per aansluiting en hoort niet in de uurprijs.

VeldBetekenis
momentUtcUTC-tijdstip. Gebruik dit als unieke sleutel voor een interval.
localTimeLokale tijd met UTC-offset, in Europe/Amsterdam.
rawEurMwhKale marktprijs in EUR/MWh. Deel door 1.000 voor EUR/kWh.
energyTaxEurKwhEnergiebelasting per kWh voor het betreffende jaar.
odeEurKwhHistorische ODE per kWh; nul vanaf 2023.
vatRateBtw als fractie, op basis van het moment.
exclVatEurKwhMarktprijs plus energiebelasting en ODE, vóór btw.
allInEurKwhPrijs inclusief energiebelasting, ODE en btw. Exclusief leveranciersopslag, netbeheer en vaste kosten.
Berekening / zonder tussentijdse afronding
allIn = (rawEurMwh / 1000 + energyTaxEurKwh + odeEurKwh) × (1 + vatRate)

Datums en beschikbaarheid

Zonder date geeft het dagendpoint morgen zodra gepubliceerd, anders vandaag. Een expliciet gevraagde dag vóór publicatie geeft een lege points-array. Morgen verschijnt bij SMARD meestal rond 14:00 Nederlandse tijd.

Een dag volgt Europe/Amsterdam. Bij de klokwisseling heeft hij 23 of 25 uren. Match op momentUtc, nooit op array-index. Ruwe uurdata is opgeslagen vanaf 5 januari 2015. De API berekent prijzen inclusief belastingen voor de meegeleverde belastingjaren vanaf 2019; de ruwe historie vóór 2019 is geen apart publiek prijsendpoint. Kwartierprijzen beginnen op 1 oktober 2025.

De berekening gebruikt de eerste energiebelastingschijf, tot 10.000 kWh per jaar. Er zijn geen gasprijzen of andere biedzones dan Nederland.

Voor AI-assistenten: MCP

De server op /mcp biedt zes alleen-lezen tools, waaronder find_cheapest_window. Gebruik een API-key en Streamable HTTP.