SpotWave API

De prijzen op SpotWave komen uit een kleine JSON-API waarmee je alleen gegevens kunt ophalen. Je mag die gebruiken voor eigen projecten, dashboards en domotica, binnen de gebruiksvoorwaarden hieronder.

Basis

Endpoints

GET /meta/markets

Alle ondersteunde markten (biedzones) met hun naam, valuta en vaste maandkosten (incl. btw), die nooit in de prijs per kWh worden meegerekend.

curl https://spotwave.eu/api/meta/markets
[
  {
    "code": "NL",
    "name": "Netherlands",
    "currency": "EUR",
    "fees": {
      "gridFixedPerMonth": 39.83,
      "energyTaxCreditPerMonth": 52.41,
      "netPerMonth": -12.58,
      "native": { "currency": "EUR", "gridFixedPerMonth": 39.83, "energyTaxCreditPerMonth": 52.41, "netPerMonth": -12.58 }
    }
  },
  …
]

GET /spotprice?country=…&from=…&to=…

De opbouw van de all-in prijs voor elke periode in een tijdvak. from en to zijn ISO-tijdstempels (inclusief); een tijdvak langer dan 92 dagen wordt ingekort tot de laatste 92 dagen.

curl "https://spotwave.eu/api/spotprice?country=NL&from=2026-10-20T00:00:00Z&to=2026-10-20T23:59:59Z"
[
  {
    "periodUtc": "2026-10-20T12:00:00Z",
    "country": "NL",
    "spotEurPerKwh": 0.10301,
    "energyTaxEurPerKwh": 0.0916,
    "gridFeeEurPerKwh": 0.0,
    "vatEurPerKwh": 0.0408681,
    "totalEurPerKwh": 0.2354781,
    "native": { "currency": "EUR", "spotPerKwh": 0.10301, "energyTaxPerKwh": 0.0916, "gridFeePerKwh": 0.0, "vatPerKwh": 0.0408681, "totalPerKwh": 0.2354781 }
  },
  …
]

GET /forecast?country=…&from=…&to=…

Dezelfde parameters en hetzelfde antwoord als /spotprice, voor de dag van morgen. Geeft een lege lijst tot de day-ahead-prijzen van morgen zijn gepubliceerd, meestal rond 13:00 uur.

curl "https://spotwave.eu/api/forecast?country=DE&from=2026-10-21T00:00:00Z&to=2026-10-21T23:59:59Z"

GET /spotprice/current?country=…

De meest recente opgeslagen marktprijs voor een markt: alleen de kale marktprijs, zonder belastingen of kosten. hourUtc is het begin van de periode. Geeft 404 als de markt geen gegevens heeft.

curl "https://spotwave.eu/api/spotprice/current?country=NL"
{ "id": 3179619, "country": "NL", "hourUtc": "2026-10-20T15:45:00Z", "eurPerKwh": 0.25471 }

GET /spotprice/stats?country=…

Percentielen van de marktprijs over de afgelopen 30 dagen. Daarmee bepaalt SpotWave of een prijs goedkoop of duur is.

curl "https://spotwave.eu/api/spotprice/stats?country=SE3"
{
  "p25": 0.0401, "median": 0.0825, "p75": 0.1208, "avg": 0.0842,
  "native": { "currency": "SEK", "p25": 0.4452, "median": 0.9165, "p75": 1.3411, "avg": 0.9352 }
}

GET /spotprice/context?country=…

Referentieniveaus op lange termijn: de voortschrijdende jaargemiddelde all-in prijs, die van vorig jaar en een typical-band (laag/midden/hoog per uur van de dag, UTC) op basis van dezelfde tijd van het jaar in de afgelopen jaren. Velden zijn null zolang er nog te weinig historie is.

curl "https://spotwave.eu/api/spotprice/context?country=NL"
{
  "yearAvg": 0.2409, "lastYearAvg": 0.2219,
  "typical": [ { "i": 0, "low": 0.1694, "mid": 0.2172, "high": 0.2650 }, … ],
  "native": { "currency": "EUR", "yearAvg": 0.2409, "lastYearAvg": 0.2219, "typical": [ … ] }
}

GET /compare

Een momentopname van alle markten: de huidige all-in prijs en marktprijs, het bereik van vandaag tot nu toe, het belastingaandeel, het btw-tarief en een sparkline per uur, gesorteerd van goedkoop naar duur. Hierop draait de pagina markten.

curl https://spotwave.eu/api/compare
{
  "asOf": "2026-10-20T15:58:49Z",
  "euAvgSpot": 0.1596,
  "zones": [
    {
      "country": "NL", "name": "Netherlands",
      "currentAllIn": 0.4012, "spot": 0.2400, "taxShare": 40.19, "vatRate": 21.0,
      "todayMin": 0.2307, "todayMax": 0.4012, "isNegative": false,
      "sparkline": [0.1701, 0.1681, 0.1722, …],
      "native": { "currency": "EUR", "currentAllIn": 0.4012, "spot": 0.2400, "todayMin": 0.2307, "todayMax": 0.4012, "sparkline": [ … ] }
    },
    …
  ]
}

GET /meta/status

Wanneer de gegevens voor het laatst zijn bijgewerkt, en per markt of de prijzen van morgen er al zijn. Handig om te bepalen wanneer je /forecast ophaalt.

curl https://spotwave.eu/api/meta/status
{ "lastUpdated": "2026-10-20T13:05:12Z", "tomorrowPublished": { "NL": true, "DE": true, "SE3": false, … } }

GET /history

Historische prijzen voor één markt: maand- en jaargemiddelden, recorddagen en -uren, uren onder nul en de gemiddelde prijs per uur van de dag over de afgelopen 12 maanden. Alleen de marktprijs, in de valuta van de markt tegen de koers van vandaag.

curl "https://spotwave.eu/api/history?country=NL"

GET /history/month

Eén maand dag voor dag: gemiddelde, laagste en hoogste prijs, uren onder nul, de goedkoopste en duurste dag, en de gemiddelden van de vorige maand en dezelfde maand vorig jaar.

curl "https://spotwave.eu/api/history/month?country=NL&month=2026-09"

Gebruik met AI-assistenten

SpotWave is ook een MCP-server, zodat AI-assistenten en agents zelf actuele en historische prijzen kunnen opzoeken. Voeg https://spotwave.eu/api/mcp toe als externe MCP-server (streamable HTTP, geen sleutel) in een client die MCP ondersteunt. Er zijn vier tools: list_markets, get_current_price, get_prices (vandaag, morgen of een dag in het verleden) en compare_markets.

curl https://spotwave.eu/api/mcp -H 'Content-Type: application/json' -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

De prijs op je eigen site

Een kleine widget met de all-in prijs en grafiek van vandaag, met een link naar SpotWave. Kies de markt met market (elke code uit /meta/markets), de taal met lang (en, nl, de, da, sv, nb, fi) en het thema met theme (light of dark).

<iframe src="https://spotwave.eu/embed?market=NL&lang=nl&theme=light"
  width="360" height="300" style="border:0;border-radius:14px"
  title="Stroomprijs vandaag" loading="lazy"></iframe>

Redelijk gebruik

Bronvermelding

Publiceer je iets dat op deze gegevens is gebaseerd, vermeld SpotWave dan met een link naar spotwave.eu. De marktprijzen komen van het ENTSO-E Transparency Platform; belastingen en kosten zijn indicatieve bedragen van SpotWave zelf, toegelicht op de pagina databronnen.

Home Assistant

Er wordt gewerkt aan een Home Assistant-integratie die deze API gebruikt. Tot die tijd kan de ingebouwde RESTful-sensor van Home Assistant /spotprice/current rechtstreeks uitlezen.

Markten · Uitleg · API