SpotWave API

Priserne på SpotWave kommer fra et lille JSON-API, som kun bruges til at hente data. Du må gerne bruge det til egne projekter, dashboards og hjemmeautomatisering inden for vilkårene nedenfor.

Grundlæggende

Basis-URL: https://spotwave.eu/api. Alle endpoints er almindelige GET-kald uden API-nøgle, og CORS er åbent, så du kan kalde det direkte fra en webside.
Maskinlæsbar specifikation: OpenAPI-dokument. Generér en klient i et hvilket som helst sprog ud fra den.
Priser er pr. kWh i valutaenheder (€/kWh for EUR-felterne). Hver række har også en native-blok i markedets egen valuta (DKK, SEK, NOK, PLN, …), omregnet til ECB's daglige referencekurs.
Tidspunkter er ISO 8601 i UTC. Day-ahead-priser gælder for hvert kvarter.
country er en markedskode fra /meta/markets: NL, DE, SE3, DK1, NO2, ITN osv.
Samlede priser er markedspris + elafgift + nettarif pr. kWh, med moms oveni. Elselskabernes tillæg er ikke med; siden datakilder viser, hvordan hvert tal er beregnet.

Endpoints

GET /meta/markets

Alle understøttede markeder (prisområder) med navn, valuta og faste månedlige omkostninger (inkl. moms), som aldrig regnes med i prisen pr. 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=…

Den samlede pris delt op for hver periode i et tidsrum. from og to er ISO-tidsstempler (inklusive); et tidsrum på mere end 92 dage forkortes til de seneste 92 dage.

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 parametre og svar som /spotprice, til morgendagen. Returnerer en tom liste, indtil morgendagens day-ahead-priser er offentliggjort, som regel omkring 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 senest gemte markedspris for et marked: kun den rene spotpris uden afgifter eller tariffer. hourUtc er periodens start. 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=…

Percentiler af markedsprisen over de seneste 30 dage. Dem bruger SpotWave til at afgøre, 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=…

Langsigtede referenceniveauer: det glidende årsgennemsnit af den samlede pris, sidste års, og et typical-bånd (lav/midt/høj for hver time på dagen, UTC) baseret på samme tid på året i de senere år. Felterne er null, indtil der er nok historik.

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 øjebliksbillede af alle markeder: den aktuelle samlede pris og spotpris, dagens spænd indtil nu, afgiftsandel, momssats og en sparkline pr. time, sorteret fra billigst. Det er grundlaget 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

Hvornår data sidst blev opdateret, og for hvert marked om morgendagens priser er kommet. Nyttigt til at afgøre, hvornå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: måneds- og årsgennemsnit, rekorddage og -timer, timer under nul og gennemsnitsprisen for hver time på dagen over de seneste 12 måneder. Kun spotprisen, i markedets valuta til dagens kurs.

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

GET /history/month

En måned dag for dag: gennemsnit, laveste og højeste pris, timer under nul, den billigste og dyreste dag samt gennemsnittet for måneden før og samme måned sidste år.

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

Brug med AI-assistenter

SpotWave er også en MCP-server, så AI-assistenter og agenter selv kan slå aktuelle og tidligere priser op. Tilføj https://spotwave.eu/api/mcp som ekstern MCP-server (streamable HTTP, ingen nøgle) i en klient, der understøtter MCP. Der er fire værktøjer: 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 lille widget med dagens samlede pris og graf, med et link tilbage til SpotWave. Vælg marked med market (en hvilken som helst kode fra /meta/markets), sprog 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=da&theme=light"
  width="360" height="300" style="border:0;border-radius:14px"
  title="Elpris i dag" loading="lazy"></iframe>

Rimelig brug

API'et er gratis og uden nøgle, men kører på en lille server, så antallet af forespørgsler er begrænset. Hvis forespørgsler bliver afvist, så vent lidt og prøv igen senere.
Priserne ændrer sig højst hvert kvarter, og morgendagens kommer én gang om dagen: Spørg højst hvert 15. minut, og gem det, du henter.
Send en beskrivende User-Agent (din apps navn og en kontakt-URL). Nogle standard-user-agents fra HTTP-biblioteker blokeres af det CDN, der står foran API'et.
Der er ingen garanti for oppetid, og endpoints kan ændre sig.

Kildeangivelse

Hvis du offentliggør noget, der bygger på disse data, så nævn SpotWave med et link til spotwave.eu. Markedspriserne kommer fra ENTSO-E Transparency Platform; afgifter og tariffer er SpotWaves egne vejledende tal, beskrevet på siden datakilder.

Home Assistant

En Home Assistant-integration, der bruger dette API, er under udvikling. Indtil da kan Home Assistants indbyggede RESTful-sensor læse /spotprice/current direkte.

Markeder · Vejledning · API