API sähkön hinnan suunnitteluun

Miksi laitteen pitää tietää seuraavan tunnin hinta?

Jotta verkkoon saadaan lisää uusiutuvaa sähköä, kysynnän on seurattava tuotantoa eikä toisin päin. Se tehtävä lankeaa ohjattaville laitteille: latauslaitteelle, lämminvesivaraajalle, kotiakulle tai sovelluksella ohjattavalle lämmitykselle. Pörssisähkössä juuri ajoitus ratkaisee, mitä maksat.

Signaali, joka yhdistää tarjonnan ja kysynnän, on hinta — mutta laitteen on kyettävä lukemaan se. Lämminvesivaraaja ei osaa tulkita sähkösopimusta, eikä sen valmistaja voi pitää kaikkia suomalaisia sopimuksia ajan tasalla, saati viidentoista maan. Juuri tämän aukon täyttää tämä API: se muuttaa kaupallisen sopimuksen vaihtoehtoineen ja paikallisine erityispiirteineen sarjaksi hinnoiteltuja jaksoja, joita kone voi käyttää.

Mitä Selectran suunnittelu-API tekee?

Se määrittää kuluttajan ja näyttää sitten hinnan tuleville jaksoille. Kolme päätepistettä, kutsuttuna tässä järjestyksessä:

Tarkennus määrittelyyn: API rakentaa kyselyn itse, markkina kerrallaan. Se palauttaa seuraavan kysymyksen ja sallitut vastaukset, ja integroija vain näyttää ne. Kenenkään asiakaspuolella ei tarvitse ylläpitää suomalaisten myyjien tai heidän vaihtoehtojensa listaa, joka muuttuu jatkuvasti.

Mitä tietoa API palauttaa?

Vastaus on taulukko peräkkäisistä jaksoista. Jokaisessa on alku- ja loppupäivä, kWh-hinta, portaan nimi niin kuin myyjä sen ilmoittaa, ja viittaus vastaavan sähkömittarin indeksiin. Vastaus kertoo myös valuutan ja sen, milloin suunnitelma päivittyy seuraavan kerran.

{
  "prices": [
    {
      "name": "Päivä",
      "price": 0.1420,
      "start": "2026-09-10T07:00:00+03:00",
      "end": "2026-09-10T22:00:00+03:00",
      "distributor_reference": "1"
    },
    {
      "name": "Yö",
      "price": 0.0910,
      "start": "2026-09-10T22:00:00+03:00",
      "end": "2026-09-11T07:00:00+03:00",
      "distributor_reference": "2"
    }
  ],
  "next_update": "2026-09-11T08:00:00+03:00",
  "currency": "EUR"
}

Esimerkkivastaus Selectran sähkön hinnan suunnittelun API:sta. Peräkkäiset jaksot, joilla on sama hinta ja porras, yhdistetään.

Mitkä maat katetaan?

Selectran sähkön hinnan suunnittelun API on nyt live yli 200 maassa. Euroopassa se kattaa 99 % kaikista julkaistuista sopimuksista — kiinteistä hinnoista ja aikatariffeista dynaamisiin hintoihin ja kysyntäjoustoon — ja ulottuu kauas Euroopan ulkopuolelle Amerikkaan, Aasiaan, Afrikkaan, Lähi-itään ja Oseaniaan. Suomi on täysin integroitu.

Maailmanlaajuisesti API kattaa yli 3 300 myyjää ja yli 60 000 tariffia, ja uusia markkinoita tulee säännöllisesti. Kattavuus koskee kotitalouksia ja pieniä yrityksiä — ainoat segmentit, joiden hinnat julkaistaan — kun taas suuremmat tehotarpeet hinnoitellaan yleensä tapauskohtaisesti.

Ja tarkemmin Suomesta?

Suomessa API kattaa suurimpien myyjien julkaistut kotitaloussopimukset. Se käsittelee:

• pörssisähkösopimukset, jotka seuraavat Nord Poolin hintaa tunneittain;
• määräaikaiset kiinteähintaiset sopimukset, myyjän marginaaleineen ja kiinteine maksuineen;
• yösähkön ja kausisähkön kaksiaikahinnat, joiden ajat verkkoyhtiö määrää;
• syöttöhinnan, aurinkopaneeleita käyttävälle asiakkaalle.

Julkaistut kotitalouksien sähkösopimukset, jotka Selectran suunnittelu-API kattaa, myyjittäin, aakkosjärjestyksessä. Lähde: Selectra (energy-core). Luvut päivittyvät automaattisesti.

Miten API:in pääsee ja mitä se maksaa?

Pääsy käy katalogin kautta osoitteessa api.selectra.com, jossa on dokumentaatio, testikonsoli ja tilaus. Ilmainen taso, ilman korttia, avaa kaikki kolme päätepistettä jokaisella katetulla markkinalla — riittävästi ensimmäisen integraation rakentamiseen ja datan arviointiin ennen sopimusta.

Sen lisäksi laskutus koostuu kolmesta osasta: kuukausitilaus tarvitsemillesi markkinoille (markkinakohtaisesti tai Eurooppa-pakettina), kutsukohtainen hinta, joka laskee volyymin myötä, ja käyttöönottomaksu, joka sisältää teknisen tuen tuotantoon asti. Ajantasaiset summat näkyvät livenä katalogin hintasivulla, koska ne luetaan suoraan laskutuksesta.

Kenelle API on tarkoitettu?

API:n integroijat jakautuvat neljään perheeseen: ohjattavien laitteiden valmistajat ja energianhallintajärjestelmien (HEMS) toimittajat, jotka tarvitsevat hinnan päättääkseen, milloin kytkeä päälle; sähkönmyyjät, jotka haluavat tarjota älyohjausta rakentamatta omaa tariffitietokantaa; joustoon ja kysyntäjoustoon keskittyvät toimijat, jotka punnitsevat vähittäishintaa vastaan verkkosignaalia; ja latausinfrastruktuurin operaattorit, joiden arvo on juuri latauksen siirtämisessä muutamalla tunnilla.

Yhteistä heille: kukaan ei halua ryhtyä tariffitiedon julkaisijaksi. Yhdenkin maan tariffien ylläpito vaatii jo kokopäiväisen tiimin, eikä vaikeus ole myyjien määrä vaan se nopeus, jolla vaihtoehdot muuttuvat.

Miksi Selectra tarjoaa tämän API:n?

Selectra on vertaillut sähkösopimuksia vuodesta 2007. Perustajat Xavier Pinon ja Aurian de Maupeou näkivät varhain, että sopimukset monimutkaistuisivat ja että kuluttajat tarvitsisivat parempaa, hintatietoon perustuvaa tietoa. Suunnittelu-API noudattaa samaa logiikkaa: yksinkertaistaa monimutkaista aihetta energiankäytön sähköistämisen palveluksessa.

Selectra toimii 15 maassa 50 energiamarkkina-asiantuntijan tiimillä, joka pitää verkkosivut ja tietokannat ajan tasalla reaaliajassa. Yli 100 miljoonan euron liikevaihdolla vuonna 2024 ja 2 000 työntekijällä yrityksellä on keinot ylläpitää tätä pitkällä aikavälillä — ainoa kysymys, jolla on todella merkitystä, kun uskot tariffitiedon kolmannelle osapuolelle.

Usein kysytyt kysymykset