Kehittäjille

Pörssisähkön hinnan rajapinta

Avoin JSON-rajapinta Suomen pörssisähkön tuntihintoihin. Ei rekisteröitymistä, ei API-avainta, ei maksua. Sama aineisto, jolla tämän sivuston hinnat ja laskurit toimivat: Nord Poolin day-ahead-hinnat ENTSO-E:n kautta.

Endpoint

GET https://porssisahkon.fi/api/v1/prices

Käyttö on sallittua myös kaupallisesti. Ainoa ehto on, että mainitset lähteeksi Pörssisähkön.fi ja linkität osoitteeseen porssisahkon.fi siellä, missä hintoja näytetään.

Parametrit

Kyselyparametrit

Ilman parametreja rajapinta palauttaa kuluvan ja seuraavan vuorokauden tunnit. Huomisen hinnat ovat mukana vasta, kun Nord Pool on julkaissut ne, arkisin noin klo 14.

Parametri	Muoto	Pakollinen	Kuvaus
start	YYYY-MM-DD	Ei	Ensimmäinen haettava vuorokausi Suomen aikaa. Oletus: kuluva päivä.
end	YYYY-MM-DD	Ei	Viimeinen haettava vuorokausi, mukaan luettuna. Oletus: seuraava päivä. Enintään 366 vuorokautta yhdellä pyynnöllä.

Vastaus

Vastauksen rakenne

Kenttä	Tyyppi	Kuvaus
date	string	Vuorokausi Suomen aikaa, YYYY-MM-DD.
hour	number	Tunti Suomen aikaa, 0–23.
start_utc	string	Toimitusjakson alku UTC-ajassa, ISO 8601.
price_cents_kwh	number	Kuluttajahinta snt/kWh, sisältää alv 25,5 %.
price_eur_mwh	number	Veroton tukkuhinta €/MWh, Nord Poolin noteeraus.

{
  "area": "FI",
  "timezone": "Europe/Helsinki",
  "currency": "EUR",
  "vat_included_in_cents_kwh": true,
  "vat_rate": 0.255,
  "source": "Nord Pool via ENTSO-E Transparency Platform",
  "licence": "Free to use, including commercially. Attribution required: link to https://porssisahkon.fi",
  "range": { "start": "2026-09-05", "end": "2026-09-06" },
  "count": 48,
  "prices": [
    {
      "date": "2026-09-05",
      "hour": 0,
      "start_utc": "2026-09-04T21:00:00Z",
      "price_cents_kwh": 1.83,
      "price_eur_mwh": 14.58
    }
  ]
}

Esimerkit

Koodiesimerkit

JavaScript: kuukauden halvin tunti

const res = await fetch(
  "https://porssisahkon.fi/api/v1/prices?start=2026-09-01&end=2026-09-30"
);
const { prices } = await res.json();

const cheapest = prices.reduce((a, b) =>
  b.price_cents_kwh < a.price_cents_kwh ? b : a
);
console.log(cheapest.date, cheapest.hour, cheapest.price_cents_kwh);

Python: kuukauden keskihinta

import requests

r = requests.get(
    "https://porssisahkon.fi/api/v1/prices",
    params={"start": "2026-09-01", "end": "2026-09-30"},
    timeout=10,
)
r.raise_for_status()

prices = r.json()["prices"]
avg = sum(p["price_cents_kwh"] for p in prices) / len(prices)
print(f"Keskihinta {avg:.2f} snt/kWh")

Usein kysyttyä

Kysymyksiä rajapinnasta

Tarvitseeko rajapinta API-avaimen?: Ei. Rajapinta on avoin eikä vaadi rekisteröitymistä, avainta tai tunnistautumista. Riittää, että teet GET-pyynnön osoitteeseen.
Saako dataa käyttää kaupallisessa palvelussa?: Saa. Ainoa ehto on lähdemerkintä: mainitse Pörssisähkön.fi ja linkitä osoitteeseen porssisahkon.fi siellä, missä hintoja näytetään.
Sisältyykö hintoihin arvonlisävero?: Kenttä price_cents_kwh sisältää arvonlisäveron 25,5 %. Kenttä price_eur_mwh on veroton tukkuhinta, sellaisena kuin se on Nord Poolissa noteerattu.
Milloin huomisen hinnat ilmestyvät rajapintaan?: Nord Pool julkaisee seuraavan vuorokauden hinnat arkisin noin klo 14.00 Suomen aikaa. Ne ovat rajapinnassa muutaman minuutin sisällä julkaisusta. Ennen sitä huomisen tunteja ei palauteta lainkaan.
Onko pyyntömäärää rajoitettu?: Käytössä ei ole kovaa kiintiötä. Vastaukset ovat välimuistissa viisi minuuttia, joten hintoja ei kannata hakea tätä tiheämmin. Yhdellä pyynnöllä voi hakea enintään 366 vuorokautta.

Jatka tästä

Pörssisähkön hinta nyt Hintahistoria Medialle Metodologia

Pörssisähkön hinnan rajapinta

Endpoint

GET https://porssisahkon.fi/api/v1/prices

Käyttö on sallittua myös kaupallisesti. Ainoa ehto on, että mainitset lähteeksi Pörssisähkön.fi ja linkität osoitteeseen porssisahkon.fi siellä, missä hintoja näytetään.

Kyselyparametrit

Ilman parametreja rajapinta palauttaa kuluvan ja seuraavan vuorokauden tunnit. Huomisen hinnat ovat mukana vasta, kun Nord Pool on julkaissut ne, arkisin noin klo 14.

Parametri	Muoto	Pakollinen	Kuvaus
start	YYYY-MM-DD	Ei	Ensimmäinen haettava vuorokausi Suomen aikaa. Oletus: kuluva päivä.
end	YYYY-MM-DD	Ei	Viimeinen haettava vuorokausi, mukaan luettuna. Oletus: seuraava päivä. Enintään 366 vuorokautta yhdellä pyynnöllä.

Vastauksen rakenne

Kenttä	Tyyppi	Kuvaus
date	string	Vuorokausi Suomen aikaa, YYYY-MM-DD.
hour	number	Tunti Suomen aikaa, 0–23.
start_utc	string	Toimitusjakson alku UTC-ajassa, ISO 8601.
price_cents_kwh	number	Kuluttajahinta snt/kWh, sisältää alv 25,5 %.
price_eur_mwh	number	Veroton tukkuhinta €/MWh, Nord Poolin noteeraus.

{ "area": "FI", "timezone": "Europe/Helsinki", "currency": "EUR", "vat_included_in_cents_kwh": true, "vat_rate": 0.255, "source": "Nord Pool via ENTSO-E Transparency Platform", "licence": "Free to use, including commercially. Attribution required: link to https://porssisahkon.fi", "range": { "start": "2026-09-05", "end": "2026-09-06" }, "count": 48, "prices": [ { "date": "2026-09-05", "hour": 0, "start_utc": "2026-09-04T21:00:00Z", "price_cents_kwh": 1.83, "price_eur_mwh": 14.58 } ] }

Koodiesimerkit

JavaScript: kuukauden halvin tunti

const res = await fetch( "https://porssisahkon.fi/api/v1/prices?start=2026-09-01&end=2026-09-30" ); const { prices } = await res.json(); const cheapest = prices.reduce((a, b) => b.price_cents_kwh < a.price_cents_kwh ? b : a ); console.log(cheapest.date, cheapest.hour, cheapest.price_cents_kwh);

Python: kuukauden keskihinta

import requests r = requests.get( "https://porssisahkon.fi/api/v1/prices", params={"start": "2026-09-01", "end": "2026-09-30"}, timeout=10, ) r.raise_for_status() prices = r.json()["prices"] avg = sum(p["price_cents_kwh"] for p in prices) / len(prices) print(f"Keskihinta {avg:.2f} snt/kWh")

Kysymyksiä rajapinnasta

Tarvitseeko rajapinta API-avaimen?

Ei. Rajapinta on avoin eikä vaadi rekisteröitymistä, avainta tai tunnistautumista. Riittää, että teet GET-pyynnön osoitteeseen.

Saako dataa käyttää kaupallisessa palvelussa?

Saa. Ainoa ehto on lähdemerkintä: mainitse Pörssisähkön.fi ja linkitä osoitteeseen porssisahkon.fi siellä, missä hintoja näytetään.

Sisältyykö hintoihin arvonlisävero?

Kenttä price_cents_kwh sisältää arvonlisäveron 25,5 %. Kenttä price_eur_mwh on veroton tukkuhinta, sellaisena kuin se on Nord Poolissa noteerattu.

Milloin huomisen hinnat ilmestyvät rajapintaan?

Nord Pool julkaisee seuraavan vuorokauden hinnat arkisin noin klo 14.00 Suomen aikaa. Ne ovat rajapinnassa muutaman minuutin sisällä julkaisusta. Ennen sitä huomisen tunteja ei palauteta lainkaan.

Onko pyyntömäärää rajoitettu?

Käytössä ei ole kovaa kiintiötä. Vastaukset ovat välimuistissa viisi minuuttia, joten hintoja ei kannata hakea tätä tiheämmin. Yhdellä pyynnöllä voi hakea enintään 366 vuorokautta.