SpotWave API

SpotWaven hinnat tulevat pienestä JSON-rajapinnasta, jolla dataa voi vain hakea. Voit käyttää sitä omiin projekteihin, kojelautoihin ja kotiautomaatioon alla olevien käyttöehtojen puitteissa.

Perusteet

Perus-URL: https://spotwave.eu/api. Jokainen rajapinta on tavallinen GET-kutsu ilman API-avainta, ja CORS on auki, joten voit kutsua sitä suoraan verkkosivulta.
Koneluettava kuvaus: OpenAPI-dokumentti. Sen pohjalta voit generoida asiakaskirjaston millä tahansa kielellä.
Hinnat ovat kilowattitunnilta valuuttayksiköissä (€/kWh EUR-kentissä). Jokaisella rivillä on myös native-osio markkinan omassa valuutassa (DKK, SEK, NOK, PLN, …), muunnettuna EKP:n päivittäisellä viitekurssilla.
Ajat ovat ISO 8601 -muodossa UTC-ajassa. Day-ahead-hinnat ovat varttikohtaisia.
country on markkinakoodi luettelosta /meta/markets: NL, DE, SE3, DK1, NO2, ITN ja niin edelleen.
Kokonaishinnat ovat pörssihinta + sähkövero + siirtomaksu kilowattitunnilta, ja niiden päälle arvonlisävero. Sähkön myyjien marginaalit eivät sisälly; tietolähteet-sivulla kerrotaan, miten kukin luku muodostuu.

Rajapinnat

GET /meta/markets

Kaikki tuetut markkinat (hinta-alueet) nimineen, valuuttoineen ja kiinteine kuukausikuluineen (sis. alv), joita ei koskaan lasketa kilowattituntihintaan.

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

Kokonaishinnan erittely jokaiselle jaksolle aikavälillä. from ja to ovat ISO-aikaleimoja (mukaan lukien); yli 92 päivän aikaväli lyhennetään viimeisiin 92 päivään.

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

Samat parametrit ja vastaus kuin /spotprice, huomiselle päivälle. Palauttaa tyhjän listan, kunnes huomisen day-ahead-hinnat on julkaistu, yleensä noin klo 14.00 Suomen aikaa.

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

GET /spotprice/current?country=…

Markkinan viimeisin tallennettu pörssihinta: pelkkä pörssihinta ilman veroja tai maksuja. hourUtc on jakson alku. Palauttaa 404, jos markkinalla ei ole dataa.

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

Pörssihinnan persentiilit viimeisten 30 päivän ajalta. Niiden avulla SpotWave arvioi, onko hinta halpa vai kallis.

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

Pitkän aikavälin vertailutasot: kokonaishinnan liukuva vuosikeskiarvo, edellisen vuoden keskiarvo ja typical-vaihteluväli (matala/keski/korkea vuorokauden tunneittain, UTC) samalta vuodenajalta viime vuosina. Kentät ovat null, kunnes historiaa on riittävästi.

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

Tilannekuva kaikista markkinoista: nykyinen kokonais- ja pörssihinta, tämän päivän vaihteluväli tähän asti, verojen osuus, alv-kanta ja tunneittainen minikäyrä, halvimmasta alkaen. Tämä on markkinat-sivun pohja.

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

Milloin data päivitettiin viimeksi, ja markkinoittain, ovatko huomisen hinnat jo tulleet. Hyödyllinen, kun päätät, milloin haet /forecast-rajapinnan.

curl https://spotwave.eu/api/meta/status

{ "lastUpdated": "2026-10-20T13:05:12Z", "tomorrowPublished": { "NL": true, "DE": true, "SE3": false, … } }

GET /history

Markkinan aiemmat hinnat: kuukausi- ja vuosikeskiarvot, ennätyspäivät ja -tunnit, tunnit alle nollan sekä keskihinta vuorokauden tunneittain viimeisten 12 kuukauden ajalta. Vain pörssihinta, markkinan valuutassa tämän päivän kurssilla.

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

GET /history/month

Yksi kuukausi päivä päivältä: keskiarvo, alin ja ylin hinta, tunnit alle nollan, halvin ja kallein päivä sekä edellisen kuukauden ja edellisen vuoden saman kuukauden keskiarvot.

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

Käyttö tekoälyavustajien kanssa

SpotWave on myös MCP-palvelin, joten tekoälyavustajat ja agentit voivat hakea nykyisiä ja aiempia hintoja itse. Lisää https://spotwave.eu/api/mcp etä-MCP-palvelimeksi (streamable HTTP, ei avainta) MCP:tä tukevaan sovellukseen. Työkaluja on neljä: list_markets, get_current_price, get_prices (tänään, huomenna tai jokin aiempi päivä) ja 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"}'

Näytä hinta omalla sivullasi

Pieni widget, jossa on tämän päivän kokonaishinta ja hintakäyrä sekä linkki SpotWaveen. Valitse markkina parametrilla market (mikä tahansa koodi luettelosta /meta/markets), kieli parametrilla lang (en, nl, de, da, sv, nb, fi) ja teema parametrilla theme (light tai dark).

<iframe src="https://spotwave.eu/embed?market=NL&lang=fi&theme=light"
  width="360" height="300" style="border:0;border-radius:14px"
  title="Sähkön hinta tänään" loading="lazy"></iframe>

Kohtuullinen käyttö

Rajapinta on maksuton eikä vaadi avainta, mutta se toimii pienellä palvelimella, joten kyselyjen määrää on rajoitettu. Jos kyselyjä alkaa hylätä, odota hetki ja yritä myöhemmin uudelleen.
Hinnat muuttuvat enintään vartin välein ja huomisen hinnat tulevat kerran päivässä: kysy enintään 15 minuutin välein ja tallenna hakemasi tiedot.
Lähetä kuvaava User-Agent (sovelluksesi nimi ja yhteystieto-URL). Rajapinnan edessä oleva CDN estää joitakin HTTP-kirjastojen oletusarvoisia user agenteja.
Käytettävyydelle ei anneta takuuta, ja rajapinnat voivat muuttua.

Lähdemaininta

Jos julkaiset jotain, joka perustuu näihin tietoihin, mainitse SpotWave ja linkitä osoitteeseen spotwave.eu. Pörssihinnat tulevat ENTSO-E Transparency Platformista; verot ja maksut ovat SpotWaven omia suuntaa antavia lukuja, jotka on kuvattu tietolähteet-sivulla.

Home Assistant

Tätä rajapintaa käyttävä Home Assistant -integraatio on työn alla. Siihen asti Home Assistantin sisäänrakennettu RESTful-anturi voi lukea /spotprice/current-rajapintaa suoraan.

Markkinat · Opas · API