Sähkön hinnat.
Sinun käyttöösi.
Tuo Suomen pörssisähkön hinnat omaan sovellukseesi tai automaatioon. Tai katso vain, mitä rajapinta palauttaa.
Nykyhinta, historia tai ennuste.
Tee valinnat ja paina painiketta.
Kopioi osoite omaan käyttöön.
Mitä haluat hakea?
Avaa haku nähdäksesi valinnat ja kokeillaksesi sitä.
GET Sähkön hinta juuri nyt/api/v1/current
Saat tämän hetken julkaistun pörssisähkön hinnan Suomessa.
Hinta koskee parhaillaan voimassa olevaa jaksoa. Se ei sisällä sähkönsiirtoa tai sähköyhtiösi marginaalia.
Vastaus näkyy tässä, kun kokeilet hakua.
Kehittäjälle: kentät ja curl
price.valueSähkön hinta sentteinä kilowattitunnilta (snt/kWh).
price.start / price.endHintajakson alku ja loppu UTC-ajassa.
vatIncludedtrue tarkoittaa, että arvonlisävero on mukana hinnassa.
curl 'https://xn--ps-wia4e.com/api/v1/current?vat=true'GET Hinnat ja hintahistoria/api/v1/prices
Hae julkaistut hinnat ja vertaile tunteja tai päiviä. Historia ulottuu vuoteen 2010; varhaisessa aineistossa on puutteita.
Voit hakea enintään 366 päivää kerralla. Tyhjällä aikavälillä saat hinnat eilisestä huomisen loppuun UTC-ajassa, jos ne on julkaistu. Loppupäivä ei sisälly hakuun.
Vastaus näkyy tässä, kun kokeilet hakua.
Kehittäjälle: kentät ja curl
pricesLista hintajaksoista: start, end ja value (snt/kWh).
countPalautettujen hintajaksojen määrä.
resolutionnative = alkuperäiset jaksot, hour = tunnit, day = päivät.
curl 'https://xn--ps-wia4e.com/api/v1/prices?vat=true&resolution=hour'GET Hintaennuste/api/v1/forecast Kokeellinen
Katso, millaisia tuntihintoja seuraaville 1–7 päivälle arvioidaan.
Ennuste on kokeellinen arvio. Se voi poiketa toteutuneesta hinnasta. Ala- ja ylärajat kuvaavat epävarmuutta, eivät takaa hintaa.
Vastaus näkyy tässä, kun kokeilet hakua.
Kehittäjälle: kentät ja curl
pricesTuntiennusteet: value sekä alaraja lower ja yläraja upper (snt/kWh).
maeKeskimääräinen ennustevirhe historiatestissä (snt/kWh). Pienempi on parempi.
fallbacktrue tarkoittaa, että käytössä on varamalli.
curl 'https://xn--ps-wia4e.com/api/v1/forecast?vat=true&days=7'GET Ennustemallin tiedot/api/v1/model
Tutustu käytössä olevaan malliin ja sen historiatestien tuloksiin.
Tämä on teknisempi raportti ennusteesta kiinnostuneille. Se sisältää mallin tiedot ja testitulokset, mutta ei opetusdataa tai mallin painoja. Parametreja ei tarvita.
Vastaus näkyy tässä, kun kokeilet hakua.
Kehittäjälle: kentät ja curl
deployedModelPalveluun viedyn ennustemallin nimi.
trainedAtMilloin malli on koulutettu.
validUntilMallin voimassaoloaika. Vanhentuneen mallin tilalla käytetään varamallia.
curl 'https://xn--ps-wia4e.com/api/v1/model'GET Sähköuutisten arkisto/api/v1/news
Hae arkistoidut otsikot sähkön hinnasta ja sähkömarkkinaan vaikuttavista tekijöistä.
Hakuehdot: q, topic, provider, publisher, days (1–36500), limit (1–250) ja cursor. Jatka sivutusta vastauksen cursor-arvolla. Julkaisijoiden oikeudet säilyvät; artikkelien koko tekstiä ei palauteta.
Vastaus näkyy tässä, kun kokeilet hakua.
Kehittäjälle: kentät ja curl
articlesOtsikot, julkaisijat, lähdelinkit ja päiväykset. dateKind=seen tarkoittaa löytöaikaa.
cursorSeuraavan sivun tunniste tai null. Säilytä samat suodattimet sivuttaessa.
sourcesViimeisimmän tuonnin lähdetilat.
curl 'https://xn--ps-wia4e.com/api/v1/news'GET Sähköoppaat/api/v1/articles
Lue Pösän omat oppaat ja niiden alkuperäislähteet.
Ilman parametreja palautetaan kaikki oppaat. slug rajaa yhden oppaan; tuntematon slug palauttaa 404. Esimerkkiluvut eivät ole tämänhetkisiä tarjouksia.
Vastaus näkyy tässä, kun kokeilet hakua.
Kehittäjälle: kentät ja curl
articlesOppaan otsikko, kuvaus, osiot, kuva, päivityspäivä ja lähteet.
urlOppaan sivun osoite.
curl 'https://xn--ps-wia4e.com/api/v1/articles'Hyvä tietää
Hinta on snt/kWh
Esimerkiksi value: 5.2 tarkoittaa 5,2 senttiä kilowattitunnilta. Sähkönsiirto ja myyjän marginaali eivät sisälly hintaan. API:n oletus on ilman ALV:tä; tämä opas valitsee ALV:n mukaan.
Ajat ovat UTC-aikaa
Suomen aika on UTC +2 tai +3 vuodenajasta riippuen. Päiväkeskiarvot muodostetaan Suomen aikaa. Negatiiviset hinnat säilytetään; puuttuvia hintoja ei korvata nollilla.
Kuinka usein tietoja kannattaa hakea?
Hae hintadata enintään kerran viidessä minuutissa ja säilytä vastaus omassa välimuistissasi. Palvelussa on 120 pyynnön minuuttiraja IP-osoitetta kohden. Palvelulla ei ole saatavuustakuuta.
Mitä virheilmoitukset tarkoittavat?
400Tarkista valinnat. Parametri tai aikaväli on virheellinen.
429Liian monta pyyntöä. Odota 60 sekuntia ennen uutta hakua.
503Tietoja ei ole saatavilla. Lähde tai ennuste on tilapäisesti poissa käytöstä. Kokeile uudelleen 60 sekunnin kuluttua.
Tarkat parametrit kehittäjälle
| Parametri | Arvot | Oletus |
|---|---|---|
vat | true / false · current, prices, forecast | false |
start, end | ISO 8601, UTC tai aikavyöhykesiirtymä · prices. Alku sisältyy, loppu ei. | Eilisestä huomisen loppuun UTC-ajassa |
resolution | native / hour / day · prices. Keskiarvot painotetaan jakson kestolla. | native |
days | 1–7 · forecast | 7 |
Ennusteen value, lower, upper ja mae ilmoitetaan sentteinä kilowattitunnilta. mae kuvaa virhettä historiatestissä.
Hintalähde: Elering / Nord Pool. Rajapinnan käyttö on maksutonta. Hintadatan alkuperäiset käyttö- ja edelleenjakeluoikeudet ovat erillisiä; API ei myönnä lisenssiä Nord Poolin dataan. Lue tietolähteistä