Huomisen hinnat julkaistaan noin klo 14.15.Katso huominen →
Integraatiot ja automaatio

Home Assistant

Pörssisähkön hinta Home Assistantiin: hinta nyt, päivän halvimmat tunnit, huomisen hinnat, valmiit automaatiot ja oma hintakortti. Asennus HACSilla, ilman API-avainta.

Avaa HACSissaGitHub: integraatioGitHub: hintakorttiKeskustelu HA-foorumilla

Mitä saat

OsaMitä se tekee
sensor.sahkon_hinta_nytPörssisähkön hinta nyt (snt/kWh, sis. ALV 25,5 %). Attribuuteissa tämän päivän ja huomisen hinnat, päivän alin, keskihinta ja ylin sekä halvin 3 tunnin jakso.
binary_sensor.sahko_halpaaPäällä (on) vuorokauden halvimpina tunteina – oletuksena 4 tuntia, määrän voi valita itse.
Blueprint: halvimmat tunnitKytkee laitteen (varaaja, latauslaite, lattialämmitys) päälle halvimpina tunteina ja muuten pois.
Blueprint: hintailmoitusIlmoitus puhelimeen, kun hinta alittaa tai ylittää valitsemasi rajan.
HintakorttiValmis kortti kojelaudalle: hinta nyt, hintataso, tämän päivän ja huomisen pylväskaavio sekä hälytysten ja ohjausten luonti suoraan kortista.

Ei API-avainta, ei rekisteröitymistä eikä maksuja. Hinnat tulevat tämän palvelun rajapinnasta (ENTSO-E / Nord Pool day-ahead, 15 minuutin tarkkuus).

Valitse asennustapa

Suositus

A: HACS-integraatio

Asennus muutamalla klikkauksella ilman YAMLia. Halvimpien tuntien määrää voi muuttaa myöhemmin integraation Määritä-painikkeesta.

Avaa HACSissa Lisää integraatio

B: YAML-paketti

Jos et käytä HACSia: kopioi alla oleva paketti tiedostoon config/packages/sahkon_hinta_nyt.yaml ja käynnistä Home Assistant uudelleen. Käyttää Home Assistantin omaa REST-integraatiota.

Näytä YAML-paketti

Käytä joko A:ta tai B:tä, älä molempia – ne luovat samat anturit.

Hintakortti kojelaudalle

Sähkön hinta -kortti Home Assistantissa: hinta nyt, hintataso ja tämän päivän hinnat pylväinä

Kortti näyttää hinnan nyt, hintatason, tämän päivän ja huomisen hinnat pylväinä (negatiiviset hinnat nollaviivan alla), halvimman 3 tunnin jakson sekä päivän alimman, keskimääräisen ja ylimmän hinnan. Ylläpitäjä voi luoda kortista suoraan hintailmoituksen, laiteohjauksen halvimmille tunneille tai tallentaa laitteiden tilan sceneksi. Kaikki kortin luomat asiat ovat tavallisia Home Assistantin automaatioita tai scenejä (merkitty ⚡), joten niitä voi muokata myöhemmin asetuksista.

Asenna kortti HACSista Kortti GitHubissa

Valmiit automaatiot (blueprintit)

Tuo blueprint yhdellä klikkauksella ja valitse laite – YAMLia ei tarvita.

Tuo: halvimmat tunnit → laite päälle Tuo: hintailmoitus

Avoin lähdekoodi

Integraatio, blueprintit ja kortti ovat avointa lähdekoodia (MIT-lisenssi) GitHubissa: sahkon-hinta-nyt-ha ja sahkon-hinta-card. Virheilmoitukset ja kehitysideat voi jättää GitHubin Issues-osioon.

Kysymyksiä, kokemuksia ja käyttöesimerkkejä voi jakaa Home Assistant Community -foorumin keskustelussa: Finnish spot electricity price (pörssisähkö). Sieltä löytyy myös muiden käyttäjien vinkkejä.

Näin otat sen käyttöön

  1. Avaa HACS ja valitse ⋮ → Custom repositories. Lisää osoite https://github.com/sahkonhintanyt-ha/sahkon-hinta-nyt-ha tyypillä Integration (tai paina yllä olevaa Avaa HACSissa -painiketta).
  2. Lataa Sähkön hinta nyt ja käynnistä Home Assistant uudelleen.
  3. Asetukset → Laitteet ja palvelut → Lisää integraatio → Sähkön hinta nyt. Valitse halvimpien tuntien määrä (oletus 4).
  4. Valinnaisesti: tuo blueprintit ja lisää hintakortti kojelaudalle.

Koodi: YAML-paketti (vaihtoehto B)

# 1) configuration.yaml – ota paketit käyttöön (jos ei jo ole):
#    homeassistant:
#      packages: !include_dir_named packages
#
# 2) Tallenna tämä tiedostoksi config/packages/sahkon_hinta_nyt.yaml
#    ja käynnistä Home Assistant uudelleen.
rest:
  - resource: https://api.xn--shknhintanyt-gcb8w.org/v1/ha?zone=FI
    scan_interval: 300
    sensor:
      - name: "Sähkön hinta nyt"
        unique_id: sahkon_hinta_nyt
        unit_of_measurement: "snt/kWh"
        state_class: measurement
        icon: mdi:flash
        value_template: "{{ value_json.state }}"
        json_attributes_path: "$.attributes"
        json_attributes:
          - level
          - min
          - max
          - average
          - cheapest_3h_start
          - cheapest_3h_avg
          - tomorrow_valid
          - raw_today
          - raw_tomorrow
  - resource: https://api.xn--shknhintanyt-gcb8w.org/v1/is-cheap?zone=FI&hours=4
    scan_interval: 300
    binary_sensor:
      - name: "Sähkö halpaa"
        unique_id: sahko_halpaa
        icon: mdi:piggy-bank
        value_template: "{{ value_json.cheap }}"

Koodi: Hintakortti (Lovelace)

type: custom:sahkon-hinta-card
entity: sensor.sahkon_hinta_nyt
# valinnaiset:
# name: Sähkön hinta nyt
# cheap_entity: binary_sensor.sahko_halpaa
# thresholds: [5, 10, 15]     # halpa / normaali / kallis, snt/kWh
# show_actions: true          # Ilmoitus / Ohjaus / Scene -painikkeet
# show_source: true
# time_zone: Europe/Helsinki

Koodi: Automaatio YAMLilla

# Esimerkki: lämminvesivaraaja päälle halvimpina tunteina
automation:
  - alias: "Varaaja halvimpina tunteina"
    trigger:
      - platform: state
        entity_id: binary_sensor.sahko_halpaa
    action:
      - service: "switch.turn_{{ 'on' if trigger.to_state.state == 'on' else 'off' }}"
        target:
          entity_id: switch.lamminvesivaraaja

Koodi: ApexCharts-kaavio

# Pylväskaavio ApexChartsilla (vaatii HACSista apexcharts-cardin)
type: custom:apexcharts-card
header:
  show: true
  title: Sähkön hinta
graph_span: 2d
span:
  start: day
now:
  show: true
series:
  - entity: sensor.sahkon_hinta_nyt
    type: column
    data_generator: |
      return [...entity.attributes.raw_today, ...entity.attributes.raw_tomorrow]
        .map((p) => [new Date(p.start).getTime(), p.value]);

Mihin tätä voi käyttää?

  • Lämminvesivaraaja lämpenee vain vuorokauden halvimpina tunteina.
  • Sähköauton lataus alkaa, kun hinta laskee valitun rajan alle.
  • Ilmoitus puhelimeen, kun huomisen hinnat julkaistaan tai hinta on negatiivinen.
  • Kojelaudalla näkyy tämän päivän ja huomisen hintakäyrä sekä halvimmat tunnit.

Hyvä tietää

  • Anturit päivittyvät 5 minuutin välein; tiheämpi päivitys ei tuo uutta tietoa, koska hinta vaihtuu 15 minuutin välein.
  • Hinnat sisältävät ALV:n 25,5 %. Marginaali, sähkövero ja siirto eivät ole mukana.
  • Jos anturi näyttää ”unavailable”, tarkista Asetukset → Järjestelmä → Lokit. YAML-paketissa yleisin syy on sisennysvirhe.
  • Hintakortti tarvitsee anturin sensor.sahkon_hinta_nyt – asenna ensin integraatio tai YAML-paketti.

Usein kysyttyä: Home Assistant

Pitääkö asentaa sekä HACS-integraatio että YAML-paketti?

Ei. Valitse toinen: HACS-integraatio (helpoin) tai YAML-paketti. Molemmat luovat samat anturit, joten yhdessä ne menisivät päällekkäin.

Voinko muuttaa halvimpien tuntien määrää?

Voit. HACS-integraatiossa valitse integraation Määritä-painike, YAML-paketissa muuta osoitteen hours-arvo (esim. hours=6).

Mistä hintakortin saa?

Kortti asennetaan HACSista tyypillä Dashboard osoitteesta https://github.com/sahkonhintanyt-ha/sahkon-hinta-card tai käsin kopioimalla sahkon-hinta-card.js kansioon config/www.

Tarvitaanko ApexCharts-korttia?

Ei. Oma hintakortti näyttää pylväskaavion ilman lisäosia. ApexCharts-esimerkki on vaihtoehto niille, jotka käyttävät sitä jo muuten.

Onko integraatio avointa lähdekoodia?

Kyllä. Koodi on GitHubissa MIT-lisenssillä, ja virheilmoitukset voi tehdä GitHubin Issues-osioon. Kysymyksiä voi esittää myös Home Assistant Community -foorumin keskustelussa: https://community.home-assistant.io/t/finnish-spot-electricity-price-porssisahko-cheapest-hours-switch-price-alert/

Maksaako rajapinnan käyttö jotain?

Ei. Rajapinta on maksuton eikä vaadi rekisteröitymistä tai API-avainta. Pyydämme vain mainitsemaan lähteen linkillä, jos näytät hintoja julkisesti.

Kuinka usein hinnat päivittyvät?

Pörssihinnat ovat 15 minuutin jaksoissa. Rajapinta tarkistaa uudet tiedot viiden minuutin välein, ja huomisen hinnat tulevat yleensä noin klo 14.15 Suomen aikaa.

Rajapinnat

Hinta nyt (JSON)/v1/now?zone=FI
Hinta nyt (pelkkä luku)/v1/now.txt?zone=FI
Onko nyt halpaa? (on/off)/v1/is-cheap.txt?zone=FI&hours=4
Halvin 3 tunnin jakso/v1/cheapest?zone=FI&hours=3
Home Assistant -muoto/v1/ha?zone=FI
Päivän hinnat vartteina/v1/prices?zone=FI&day=today

Base: https://api.xn--shknhintanyt-gcb8w.org · CORS · JSON · Lähde: ENTSO-E / Nord Pool day-ahead

← Kaikki integraatiot