SpotWave API

Prisene på SpotWave kommer fra et lite JSON-API som bare brukes til å hente data. Du kan gjerne bruke det til egne prosjekter, dashboards og hjemmeautomasjon, innenfor vilkårene nedenfor.

Grunnleggende

Endepunkter

GET /meta/markets

Alle markedene (prisområdene) som støttes, med navn, valuta og faste månedskostnader (inkl. mva), som aldri regnes inn i prisen per kWh.

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=…

Totalprisen delt opp for hver periode i et tidsrom. from og to er ISO-tidsstempler (inkludert); et tidsrom på mer enn 92 dager kortes ned til de siste 92 dagene.

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=…

Samme parametere og svar som /spotprice, for morgendagen. Returnerer en tom liste til morgendagens day-ahead-priser er publisert, som regel rundt kl. 13:00.

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

GET /spotprice/current?country=…

Den sist lagrede spotprisen for et marked: bare den rene spotprisen, uten avgifter eller nettleie. hourUtc er starten på perioden. Returnerer 404 hvis markedet ikke har data.

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=…

Persentiler av spotprisen de siste 30 dagene. Med dem avgjør SpotWave om en pris er billig eller dyr.

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=…

Langsiktige referansenivåer: det glidende årsgjennomsnittet av totalprisen, fjorårets, og et typical-bånd (lav/midt/høy per time i døgnet, UTC) basert på samme tid av året de siste årene. Feltene er null til det finnes nok historikk.

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

Et øyeblikksbilde av alle markeder: nåværende totalpris og spotpris, dagens spenn så langt, avgiftsandel, mva-sats og en sparkline per time, sortert fra billigst. Dette er grunnlaget for siden markeder.

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

Når dataene sist ble oppdatert, og per marked om morgendagens priser er kommet. Nyttig for å avgjøre når du skal hente /forecast.

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

GET /history

Tidligere priser for et marked: snitt per måned og år, rekorddager og rekordtimer, timer under null og snittprisen per time i døgnet de siste 12 månedene. Bare spotprisen, i markedets valuta til dagens kurs.

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

GET /history/month

En måned dag for dag: snitt, laveste og høyeste pris, timer under null, billigste og dyreste dag, og snittet for måneden før og samme måned i fjor.

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

Bruk med KI-assistenter

SpotWave er også en MCP-server, så KI-assistenter og agenter selv kan slå opp nåværende og tidligere priser. Legg til https://spotwave.eu/api/mcp som ekstern MCP-server (streamable HTTP, ingen nøkkel) i en klient som støtter MCP. Det finnes fire verktøy: list_markets, get_current_price, get_prices (i dag, i morgen eller en tidligere dag) og 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"}'

Vis prisen på din egen side

En liten widget med dagens totalpris og graf, med en lenke tilbake til SpotWave. Velg marked med market (en hvilken som helst kode fra /meta/markets), språk med lang (en, nl, de, da, sv, nb, fi) og tema med theme (light eller dark).

<iframe src="https://spotwave.eu/embed?market=NL&lang=nb&theme=light"
  width="360" height="300" style="border:0;border-radius:14px"
  title="Strømpris i dag" loading="lazy"></iframe>

Rimelig bruk

Kildehenvisning

Hvis du publiserer noe som bygger på disse dataene, oppgi gjerne SpotWave med en lenke til spotwave.eu. Spotprisene kommer fra ENTSO-E Transparency Platform; avgifter og nettleie er SpotWaves egne veiledende tall, beskrevet på siden datakilder.

Home Assistant

En Home Assistant-integrasjon som bruker dette API-et, er under arbeid. Inntil da kan Home Assistants innebygde RESTful-sensor lese /spotprice/current direkte.

Markeder · Veiledning · API