SpotWave API

Priserna på SpotWave kommer från ett litet JSON-API som bara används för att hämta data. Du får gärna använda det för egna projekt, dashboards och hemautomation, inom villkoren nedan.

Grunder

Endpoints

GET /meta/markets

Alla marknader (elområden) som stöds, med namn, valuta och fasta månadskostnader (inkl. moms), som aldrig räknas in i priset 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=…

Totalpriset uppdelat för varje period i ett intervall. from och to är ISO-tidsstämplar (inklusive); ett intervall längre än 92 dagar kortas till de senaste 92 dagarna.

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

Samma parametrar och svar som /spotprice, för morgondagen. Returnerar en tom lista tills morgondagens day-ahead-priser har publicerats, oftast runt 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=…

Det senast sparade spotpriset för en marknad: bara det rena spotpriset, utan skatter eller avgifter. hourUtc är periodens början. Returnerar 404 om marknaden saknar 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 av spotpriset under de senaste 30 dagarna. Med dem avgör SpotWave om ett pris är billigt eller dyrt.

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

Långsiktiga referensnivåer: det rullande årsgenomsnittet för totalpriset, förra årets, och ett typical-band (låg/mitt/hög per timme på dygnet, UTC) baserat på samma tid på året under de senaste åren. Fälten är null tills det finns tillräckligt med 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

En ögonblicksbild av alla marknader: aktuellt totalpris och spotpris, dagens spann hittills, skatteandel, momssats och en sparkline per timme, sorterat från billigast. Det är grunden för sidan marknader.

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 data senast uppdaterades och, per marknad, om morgondagens priser har kommit. Bra för att avgöra när du ska hämta /forecast.

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

GET /history

Tidigare priser för en marknad: genomsnitt per månad och år, rekorddagar och rekordtimmar, timmar under noll och genomsnittspriset per timme på dygnet de senaste 12 månaderna. Bara spotpriset, i marknadens valuta till dagens kurs.

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

GET /history/month

En månad dag för dag: genomsnitt, lägsta och högsta pris, timmar under noll, billigaste och dyraste dagen samt genomsnitten för månaden före och samma månad förra året.

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

Använd med AI-assistenter

SpotWave är också en MCP-server, så AI-assistenter och agenter själva kan slå upp aktuella och tidigare priser. Lägg till https://spotwave.eu/api/mcp som fjärr-MCP-server (streamable HTTP, ingen nyckel) i en klient som stöder MCP. Det finns fyra verktyg: list_markets, get_current_price, get_prices (idag, imorgon eller en tidigare dag) och 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"}'

Visa priset på din egen sida

En liten widget med dagens totalpris och graf, med en länk tillbaka till SpotWave. Välj marknad med market (valfri kod från /meta/markets), språk med lang (en, nl, de, da, sv, nb, fi) och tema med theme (light eller dark).

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

Rimlig användning

Källhänvisning

Om du publicerar något som bygger på dessa data, ange gärna SpotWave med en länk till spotwave.eu. Spotpriserna kommer från ENTSO-E Transparency Platform; skatter och avgifter är SpotWaves egna ungefärliga värden, beskrivna på sidan datakällor.

Home Assistant

En Home Assistant-integration som använder detta API är under arbete. Fram till dess kan Home Assistants inbyggda RESTful-sensor läsa /spotprice/current direkt.

Marknader · Guide · API