/api/v1/pricesKey verplichtDagprijzen
Uurprijzen of kwartierprijzen van één Nederlandse kalenderdag. Parameters: date=YYYY-MM-DD en resolution=hour of quarterhour.
Parameters & response in de reference ↗Documentatie / Endpointoverzicht
Prijzen, belastingopbouw, datadekking en API-toegang. Base URL: https://stroomprijzenapi.nl.
9 endpoints
/api/v1/pricesKey verplichtUurprijzen of kwartierprijzen van één Nederlandse kalenderdag. Parameters: date=YYYY-MM-DD en resolution=hour of quarterhour.
Parameters & response in de reference ↗/api/v1/prices/nowKey verplichtDe huidige uurprijs of kwartierprijs met de kale marktprijs en volledige belastingopbouw.
Parameters & response in de reference ↗/api/v1/tax-ratesKey verplichtEnergiebelasting, ODE, btw-periodes en de berekeningsformule per jaar.
Bekijk de uitleg en gegevens →Parameters & response in de reference ↗/api/v1/test-vectorsKey verplichtControleerbare bedragen per belastingjaar, inclusief de btw-wijziging van 2022.
Bekijk de uitleg en gegevens →Parameters & response in de reference ↗/api/v1/statusPubliekBeschikbare historie per resolutie en de laatste ingest-run.
Parameters & response in de reference ↗/healthPubliekLiveness zonder de database te bevragen.
Parameters & response in de reference ↗/api/v1/keysBevestigd accountMaak vanuit je account een key aan met een optioneel label. Je krijgt de key één keer terug.
Parameters & response in de reference ↗/api/v1/keys/meKey verplichtTier, daglimiet en verbruik van je API-key.
Parameters & response in de reference ↗/mcpKey verplichtStreamable HTTP met zes alleen-lezen tools. JSON-RPC voor AI-assistenten.
MCP configureren ↗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.
| Veld | Betekenis |
|---|---|
momentUtc | UTC-tijdstip. Gebruik dit als unieke sleutel voor een interval. |
localTime | Lokale tijd met UTC-offset, in Europe/Amsterdam. |
rawEurMwh | Kale marktprijs in EUR/MWh. Deel door 1.000 voor EUR/kWh. |
energyTaxEurKwh | Energiebelasting per kWh voor het betreffende jaar. |
odeEurKwh | Historische ODE per kWh; nul vanaf 2023. |
vatRate | Btw als fractie, op basis van het moment. |
exclVatEurKwh | Marktprijs plus energiebelasting en ODE, vóór btw. |
allInEurKwh | Prijs inclusief energiebelasting, ODE en btw. Exclusief leveranciersopslag, netbeheer en vaste kosten. |
allIn = (rawEurMwh / 1000 + energyTaxEurKwh + odeEurKwh) × (1 + vatRate)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.
De server op /mcp biedt zes alleen-lezen tools, waaronder find_cheapest_window. Gebruik een API-key en Streamable HTTP.