Rajapinta

Hinnat koneellisesti

Sama data kuin sivuilla, JSON-muodossa. Ei avaimia eikä rekisteröitymistä: hinnat ovat ENTSO-E:n julkaisemia, ja rajapintaa rajoitetaan vain pyyntömäärällä, 60 pyyntöä minuutissa osoitetta kohti. Vastaukset ovat välimuistitettavia ja kantavat ETag-tunnisteen, joten minuutin välein kyselevä asiakas saa useimmiten 304-vastauksen.

Osoitteet

Kaikki osoitteet alkavat https://wattiplus.fi/api/v1. Sama kuvaus koneluettavana: openapi.json.

Hinnat

Hinnat
Osoite Sisältö Parametrit
/prices/current Hinta juuri nyt, vartin tarkkuudella, ja sen hintaluokka. vat, margin, transfer
/prices/{date} Yhden päivän kaikki vartit. Päivä on tanaan, huomenna tai 2026-09-06. date, vat, margin, transfer, resolution, zone
/prices/upcoming Kaikki vartit tästä hetkestä tallennetun horisontin loppuun. vat, margin, transfer, after, before, resolution

Ajoitus

Ajoitus
Osoite Sisältö Parametrit
/prices/cheapest Halvin yhtenäinen jakso, joka on vielä edessä, sekä sama tälle päivälle ja huomiselle. hours, after, before, vat, margin, transfer
/prices/cheapest-slots Halvimmat vartit hajautettuina, yhteensä hours tuntia, ja niiden muodostamat yhtenäiset jaksot. hours, after, before, vat, margin, transfer

Kotiautomaatio

Kotiautomaatio
Osoite Sisältö Parametrit
/homeassistant Yksi litteä dokumentti: hinta nyt, päivän tunnusluvut, halvimmat jaksot, verkon tila ja molempien päivien vartit. vat, margin, transfer, hours, after, before, slots, threshold, resolution
/me Sama dokumentti tilin omalla tariffilla ja jokainen päällä oleva ilmoitus sensoriksi laskettuna. token
/openapi.json Tämä kuvaus OpenAPI 3.1 -muodossa. –

Verkko

Verkko
Osoite Sisältö Parametrit
/grid Päästökerroin, sähköpulan tila, kulutus, tuotanto, tuonti rajoittain ja puhtaimmat ennustetut jaksot. –

Teksti

Teksti
Osoite Sisältö Parametrit
/prices/current.txt Hinta nyt lukuna. Tariffin kanssa kokonaishinta. vat, margin, transfer
/prices/level.txt Hintaluokka nyt: negative, cheap, moderate, high tai extreme. –
/prices/cheapest.txt 1 kun halvin hours-tunnin jakso on käynnissä, muuten 0. hours, after, before
/prices/below.txt 1 kun hinta on alle rajan, muuten 0. threshold, vat, margin, transfer

Lataus

Lataus
Osoite Sisältö Parametrit
/calendar/cheapest.ics Halvin jakso tänään ja huomenna kalenteritapahtumina. hours, vat
/prices/{period}.csv Kuukausi (2026-08) tai päivä (2026-08-15) CSV-muodossa, puolipisteellä eroteltuna. period, zone

Parametrit

Samat parametrit toimivat jokaisessa osoitteessa, jossa ne on mainittu. Desimaalierottimena kelpaa piste tai pilkku.

Parametrit
vat=1 Hinnat arvonlisäveron kanssa. Oletuksena ilman, koska koneellinen käyttäjä haluaa markkinahinnan. Kalenterisyöte on poikkeus.
margin=0,49 Myyjän marginaali snt/kWh sis. alv. Lisätään jokaiseen hintaan kenttään total.
transfer=3,2 Siirtomaksu snt/kWh sis. alv. Yhdessä marginaalin kanssa total on se hinta, jonka oikeasti maksat.
after=22:00 Jaksoa etsitään vasta tämän Helsingin kellonajan seuraavasta esiintymästä eteenpäin.
before=07:00 Jakson on päätyttävä tähän kellonaikaan mennessä. Ratkeaa after-ajan jälkeen: after=22:00&before=07:00 on tämä yö, ja before=07:00 keskipäivällä tarkoittaa huomisaamua.
hours=2,5 Jakson pituus tunteina, 0,25:stä 12:een vartin askelin. Oletus 3.
slots=4 Hajautettujen halvimpien varttien yhteispituus tunteina.
threshold=5 Hintaraja snt/kWh. Verrataan total-hintaan jos tariffi on annettu, muuten hintaan.
resolution=60 Vartit tiivistetään tuntikeskiarvoiksi laitteelle, joka ei osaa varttia.
zone=SE3 Toinen hinta-alue päivädokumentissa ja CSV:ssä: SE3, EE, LV tai LT.

Aikaleimat ovat ISO 8601 -muodossa aikavyöhykkeen kanssa, eivätkä ne ole koskaan monitulkintaisia edes kellonsiirtopäivinä. Vanhat osoitteet ilman /v1-osaa toimivat edelleen ja vastaavat suoraan, mutta kantavat Deprecation-otsakkeen.

Esimerkkejä

GET https://wattiplus.fi/api/v1/prices/current?vat=1&margin=0,49&transfer=3,2

{
  "starts_at": "2026-09-06T17:00:00+00:00",
  "ends_at": "2026-09-06T17:15:00+00:00",
  "resolution": "PT15M",
  "unit": "c/kWh",
  "vat_included": true,
  "margin": 0.49,
  "transfer": 3.2,
  "price": 6.28,
  "total": 9.97,
  "price_eur_mwh": 50.04,
  "level": "moderate"
}

Auto on ladattava aamuseitsemään mennessä ja se tarvitsee neljä tuntia. Halvimmat vartit sinä aikana, hajautettuina: GET https://wattiplus.fi/api/v1/prices/cheapest-slots?hours=4&before=07:00 

{
  "hours": 4,
  "after": null,
  "before": "2026-09-07T04:00:00+00:00",
  "average": 2.14,
  "active": false,
  "next_starts_at": "2026-09-06T22:30:00+00:00",
  "runs": [
    { "starts_at": "2026-09-06T22:30:00+00:00", "ends_at": "2026-09-07T01:15:00+00:00", "average": 2.05 },
    { "starts_at": "2026-09-07T02:00:00+00:00", "ends_at": "2026-09-07T03:15:00+00:00", "average": 2.33 }
  ],
  "intervals": [ { "start": "…", "end": "…", "value": 1.98, "total": null }, "…" ]
}

level on sivuston hintaluokka: negative, cheap, moderate, high tai extreme, samoilla rajoilla kuin sivuilla. runs ovat valittujen varttien muodostamat yhtenäiset jaksot, jotka rele voi kytkeä sellaisenaan.

Home Assistant

REST-sensori, valmiit automaatiot auton latauksesta saunaanja HACS-integraatio.

Laitteet ja kalenteri

Shelly, ESPHome, Tasmota ja Node-RED yhden luvun osoitteilla, sekä kalenterisyöte.

Tili ja webhookit

Oma tariffi ja ilmoitusrajat sensoreiksi, ja viesti hubille heti kun huomisen hinnat julkaistaan.

Käyttö

Rajapinta on maksuton ja tarkoitettu kotiautomaatioon, harrasteprojekteihin ja pieniin sovelluksiin. Kysele enintään kerran minuutissa per osoite ja kunnioita Cache-Control-otsakkeita; hinnat muuttuvat kerran päivässä iltapäivällä, joten tiheämpi kysely ei tuo uutta tietoa.

Jos näytät dataa julkisesti, mainitse lähteenä Wattiplus ja linkitä wattiplus.fi. Alkuperäinen lähde on ENTSO-E Transparency Platform; sen katkojen aikana sama huutokauppatulos haetaan Eleringin avoimesta syötteestä. Verkon tiedot ovat Fingridin avointa dataa. Rajapinnan muoto pidetään vakaana: kenttiä lisätään, olemassa olevia ei poisteta eikä nimetä uudelleen ilman pitkää siirtymäaikaa.

Hinnat ovat Suomen hinta-alueen pörssihintoja. Niihin ei sisälly siirtomaksua, sähköveroa eikä myyjän marginaalia, ellet anna niitä itse parametreina.

Ei takuuta. Rajapinta tarjotaan sellaisenaan: se voi olla poissa käytöstä, ja tieto voi puuttua tai olla väärin. Jos ohjaat sillä laitteita, tee automaatiosta sellainen, että se toimii turvallisesti myös ilman vastausta. Käyttämällä rajapintaa hyväksyt käyttöehdot.