Sähkön hinta API: näin haet pörssihinnat ilmaiseksi koodilla
Avoimesta rajapinnasta saa pörssisähkön hinnat ilman API-avainta. Tiistain 27.10. halvin 3 tunnin jakso oli klo 2–5, 0,32 snt/kWh.
Pörssisähkön hinnat saa omaan koodiin, taulukkoon tai kotiautomaatioon ilmaiseksi ja ilman rekisteröitymistä Sähkön hinta nyt -palvelun avoimesta rajapinnasta. Tiistain 27.10.2026 hinnoista esimerkkiskripti löytää halvimman kolmen tunnin jakson yöltä klo 2–5, jolloin sähkö maksoi keskimäärin 0,32 senttiä kilowattitunnilta. Kalleimmillaan klo 12–15 hinta oli 1,39 senttiä eli noin nelinkertainen. Kaikki hinnat ovat pörssihintoja sis. ALV 25,5 %.
Rajapinta on tarkoitettu opiskelijoille, opinnäytetöiden tekijöille, harrastajille ja kaikille, jotka haluavat käsitellä sähkön hintaa itse. Alla on päätepisteet, toimiva Python-esimerkki ja vertailu muihin avoimiin lähteisiin, kuten ENTSO-E:hen, Fingridiin ja Nord Pooliin.
Päätepisteet ja mitä ne palauttavat
Rajapinnan osoite on https://api.xn--shknhintanyt-gcb8w.org. API-avainta ei tarvita, vastaukset ovat JSON-muodossa ja CORS on sallittu, joten hintoja voi hakea myös suoraan selaimessa ajettavasta JavaScriptistä. Rajapinnan OpenAPI 3.1 -kuvauksen mukaan pyyntöjä saa tehdä noin 30 kymmenessä sekunnissa samasta IP-osoitteesta.
| Päätepiste | Mitä palauttaa |
|---|---|
/v1/now?zone=FI | Kuluvan vartin hinta, tunnin keskihinta ja hintataso |
/v1/now.txt?zone=FI | Pelkkä hinta tekstinä, esimerkiksi laitteelle |
/v1/prices?zone=FI&day=today | Päivän 96 varttihintaa (points) ja 24 tuntikeskiarvoa (hours) |
/v1/cheapest?zone=FI&hours=3 | Halvin yhtenäinen jakso julkaistuista hinnoista |
/v1/is-cheap.txt?zone=FI&hours=4 | Onko nyt yksi päivän halvimmista tunneista (on/off) |
/v1/daily?zone=FI&days=60 | Päivittäinen keskihinta, minimi ja maksimi, enintään 400 päivää |
/v1/averages?zone=FI | 7, 30 ja 365 päivän keskiarvot sekä kuukausikeskiarvot |
/v1/grid | Suomen sähköntuotanto ja -kulutus nyt (Fingrid) |
Parametri day hyväksyy arvot today, tomorrow, yesterday tai päivämäärän muodossa VVVV-KK-PP. Huomisen hinnat julkaistaan noin klo 14.15 Suomen aikaa. Parametrilla vat=0 saat hinnat ilman arvonlisäveroa, ja zone vaihtaa hinta-alueen: Suomen lisäksi mukana ovat muun muassa Viro (EE), Ruotsin alueet SE1–SE4, Norjan alueet, Tanska ja Saksa. Pelkän hinnan voi testata avaamalla osoitteen selaimessa tai komennolla curl "https://api.xn--shknhintanyt-gcb8w.org/v1/now.txt?zone=FI".
Esimerkki: päivän keskihinta ja halvin kolmen tunnin jakso Pythonilla
Alla oleva skripti hakee päivän tuntikeskiarvot, laskee niistä keskihinnan ja etsii halvimman yhtenäisen kolmen tunnin jakson. Se tarvitsee vain requests-kirjaston (pip install requests).
import requests
URL = "https://api.xn--shknhintanyt-gcb8w.org/v1/prices"
data = requests.get(URL, params={"zone": "FI", "day": "today"}, timeout=10).json()
hinnat = [h["price"] for h in data["hours"]] # 24 tuntikeskiarvoa, snt/kWh sis. ALV
print("Päivän keskihinta:", round(sum(hinnat) / len(hinnat), 2), "snt/kWh")
# Halvin yhtenäinen kolmen tunnin jakso
jaksot = [(sum(hinnat[i:i + 3]) / 3, i) for i in range(len(hinnat) - 2)]
keskiarvo, alku = min(jaksot)
print(f"Halvin 3 h: klo {alku}–{alku + 3}, keskimäärin {keskiarvo:.2f} snt/kWh")Tiistain 27.10.2026 tuntihinnoilla tulos on tämä (sis. ALV 25,5 %, laskettu omasta hintadatastamme klo 9.23):
| Luku | Arvo |
|---|---|
| Päivän keskihinta | 0,83 snt/kWh |
| Halvin 3 tunnin jakso | klo 2–5, 0,32 snt/kWh |
| Kallein 3 tunnin jakso | klo 12–15, 1,39 snt/kWh |
| Kallein tunti | klo 9–10, 1,58 snt/kWh |
| Halvin vartti | klo 23.45–24.00, 0,25 snt/kWh |
Tuntikeskiarvoihin perustuva laskelma on helppo ymmärtää, mutta pörssisähkö hinnoitellaan nykyään vartin tarkkuudella. Jos laite tai mittaus toimii varteittain, käytä points-listaa ja laske ikkuna 12 vartista. Valmis /v1/cheapest-päätepiste tekee saman laskun rajapinnan päässä.
Sähkön kustannukseksi hinta muuttuu kertomalla se kulutuksella. Esimerkiksi 10 kilowattitunnin kulutus tiistain halvimmassa jaksossa maksoi energian osalta noin 0,03 euroa ja kalleimmassa noin 0,14 euroa. Siirto, sähkövero ja myyjän marginaali tulevat päälle; laajempi esimerkki laitekohtaisesta laskusta on jutussamme laske laitteen sähkökulu itse.
Pidempi aikasarja tutkimukseen
Opinnäytetyössä tai projektissa tarvitaan usein pidempää historiaa. /v1/daily palauttaa enintään 400 päivän päiväkeskiarvot. Omasta datastamme laskettuna 28.8.–26.10.2026 välisenä 60 päivän jaksona sähkön päiväkeskihinta jäi alle yhden sentin kahdeksana päivänä, ja kallein päivä oli 30.9.2026, jolloin keskihinta oli 17,26 snt/kWh. Lokakuun 1.–26. päivän keskihinta oli 4,43 snt/kWh. Kuukausittaiset luvut löytyvät myös sivulta sähkön keskihinta kuukausittain, ja hintajakauman tunnusluvut on avattu jutussamme pörssisähkön hintatilastoista.
Milloin kannattaa käyttää ENTSO-E:tä, Fingridiä tai Nord Poolia
Meidän rajapintamme on koottu valmiiksi kuluttajan näkökulmasta: hinnat ovat valmiiksi snt/kWh ja verollisina. Raakadatan ja pidempien aikasarjojen lähteet ovat seuraavat.
- ENTSO-E Transparency Platform on eurooppalaisten kantaverkkoyhtiöiden avoin tietopalvelu, josta saa day-ahead-hinnat koko Euroopasta euroina megawattitunnilta. Rajapinnan käyttö vaatii rekisteröitymisen ja hyväksynnän, jonka jälkeen saat henkilökohtaisen tunnisteen (security token). Myös meidän pörssihintamme tulevat ENTSO-E:n kautta.
- Fingridin avoin data (data.fingrid.fi) sisältää Suomen sähköntuotannon, kulutuksen, tuonnin ja viennin aikasarjat. API-avain tilataan kehittäjäportaalista, ja se lähetetään
x-api-key-otsakkeessa. Fingridin ohjeen mukaan avaimella saa tehdä 10 000 pyyntöä vuorokaudessa ja enintään yhden pyynnön kahdessa sekunnissa. - Nord Pool on pörssi, jossa hinta syntyy. Sen Data Portal -palvelu on maksullinen: halvin yhden käyttäjän tilaus maksaa Nord Poolin sivun mukaan 1 200 euroa kalenterivuodessa. Opiskelijoille ja tutkijoille on sivun mukaan erityisehdot, joita ei kerrota julkisesti.
Meidän rajapintamme lähdetiedot ja laskentatavat on kuvattu lähteet ja menetelmät -sivulla. Kotiautomaatioon, kuten Home Assistantiin, Shellyyn ja Node-REDiin, on valmiit ohjeet integraatiosivulla.
Rajoitukset ja käyttöehdot
- Hinnat ovat day-ahead-pörssihintoja. Niissä ei ole siirtoa, sähköveroa eikä myyjän marginaalia, joten ne eivät suoraan vastaa sähkölaskua.
- Verollinen hinta lasketaan Suomen 25,5 prosentin arvonlisäverolla. Tutkimuksessa kannattaa usein käyttää verotonta hintaa (
vat=0), jotta vertailu muihin maihin ja aiempiin vuosiin on reilu. - Hinnat ovat 1.10.2025 alkaen vartin tarkkuudella. Sitä vanhemmat tunnihinnat eivät ole suoraan verrattavissa varttihintoihin.
- Rajapinta tarjotaan sellaisenaan ilman saatavuustakuuta. Käyttöehtojen mukaan sitä saa käyttää maksutta myös kaupallisesti, mutta julkisesti näytettäessä lähteeksi on mainittava sähkönhintanyt.org linkin kera.
Lähteet
Näin juttu tehtiin. Luvut ovat Sähkön hinta nyt -palvelun omasta hinta- ja tuotantodatasta sekä yllä mainituista lähteistä. Osa jutuista tuotetaan tekoälyn avulla toimituksen sääntöjen mukaan. Näin toimimme · Huomasitko virheen? Kerro meille.
