Az OKTE (Organizátor krátkodobého trhu s elektrinou) a szlovák villamosenergia-piaci szervező. Másnapi piaci (DAM) spotárakat tesz közzé — az előző napi aukción meghatározott óránkénti nagykereskedelmi villamosenergia-árat EUR/MWh-ban.
A TapHome sablon ezeket az árakat az OKTE nyilvános API-jából (isot.okte.sk) kéri le HTTP Packet Parser segítségével. Biztosítja az aktuális óra árát, árrangsorolást, min/max/átlag számításokat és időablak-elemzést — minden automatikusan frissül óránként. Nincs szükség hitelesítésre.
Konfiguráció
A sablon az isot.okte.sk-hoz csatlakozik HTTPS-en (443-as port). Nem szükséges IP-cím vagy hitelesítő adat — a végpont nyilvános API.
A sablon importálásakor két opcionális egyéni változó állítható be:
- Tól — egyéni időablak kezdő órája (0–23, alapértelmezett: 9)
- Ig — egyéni időablak záró órája (0–23, alapértelmezett: 17)
Ezek a változók vezérlik az „időablakban" eszközvariánsokat. Az alapértékek (9–17) a szokásos munkaidőt fedik le. Ha nem szükségesek, hagyd az alapértékeken — az egész napos eszközök függetlenül működnek.
Működés
A modul óránként egyszer kérdezi le az OKTE DAM API-t (3600 s intervallum). Az API-kérés a mai dátumot használja:
| |
A válasz árobjelekumok tömbjét tartalmazza, mindegyik egy period számmal és egy price értékkel EUR/MWh-ban. A napszaktól és az OKTE közzétételi ütemtervétől függően a válasz tartalmazhat árakat csak a mai napra (24 periódus) vagy akár 3 napra (72 periódus).
Minden eszközszkript ezt a JSON tömböt a PARSEJSON(output, "$..price") segítségével elemzi, és rendezési, szűrési vagy aggregálási függvényeket alkalmaz az érték kinyeréséhez.
Eszközképességek
A sablon 13 szenzoreszközt tesz elérhetővé. Mindegyik csak olvasható — az értékeket ugyanabból az API-válaszból származtatják.
Aktuális ár és rangsor
- Aktuális ár — az aktuális óra spotára EUR/MWh-ban. A szkript a
NOW()függvényből határozza meg az aktuális periódusindexet, és a tömbből a megfelelő árat adja vissza. - Aktuális periódus rangja — az aktuális óra árának rangja az összes elérhető periódus között (1 = legolcsóbb). Hasznos automatizálási szabályokhoz, mint például „a hőszivattyú csak akkor működjön, ha az aktuális óra a 8 legolcsóbb között van."
- Aktuális periódus rangja időablakban — ugyanaz, mint fent, de a felhasználó által meghatározott Tól–Ig ablakra korlátozva. NaN-t ad vissza, ha az aktuális óra az ablakon kívül esik, vagy ha Tól >= Ig.
Árszélsőségek
- Nap legmagasabb ára — a maximális spotár az összes elérhető periódusban
- Nap legalacsonyabb ára — a minimális spotár az összes elérhető periódusban
- Legmagasabb ár az időablakban — maximális ár a Tól–Ig ablakon belül
- Legalacsonyabb ár az időablakban — minimális ár a Tól–Ig ablakon belül
Átlagok
- Nap átlagos ára — az összes elérhető periódusár számtani átlaga
- Átlagos ár az időablakban — számtani átlag a Tól–Ig ablakon belül
Periódus azonosítás
- Nap legolcsóbb periódusa — a legolcsóbb óra 1-alapú periódusszáma (pl. 3 = 02:00–03:00)
- Legolcsóbb hátralévő periódus — a legolcsóbb óra az aktuális órától kezdve. Dinamikusan frissül a nap folyamán.
Darabszámok
- Periódusszám — az API-válaszban elérhető árperiódusok összesített száma (jellemzően 24 vagy 72)
- Periódusszám az időablakban — periódusok száma a Tól–Ig ablakon belül
Szolgáltatás attribútumok
A modul legfeljebb 96 szolgáltatás attribútumot tesz elérhetővé (1. periódus – 96. periódus), mindegyik az adott óra spotárát mutatja „EUR" utótaggal. A gyakorlatban egy napra 24, három napra 72 attribútum van kitöltve.
Ezek az attribútumok teljes áridőtervet biztosítanak, amely a TapHome modul részletes nézetében látható.
Egyéni változók (Tól / Ig)
Több eszköznek van „időablakban" variánsa, amely az áradatokat az órák egy részhalmazára szűri. Az ablakot két, a sablonimportálás során beállított egyéni változó határozza meg:
- Tól — a kezdő óra (beleértve), érték 0–23
- Ig — a záró óra (nem beleértve), érték 0–23
Például a Tól=8 és Ig=16 beállítás csak a 08:00 és 16:00 közötti árakat elemzi. Ez hasznos, ha bizonyos órákban szeretnéd optimalizálni az energiafelhasználást — például csak a munkanapod legolcsóbb óráiban futtatni a háztartási gépeket.
Ha Tól >= Ig, minden ablakos eszköz NaN-t ad vissza.
Automatizálási példák
Eszközök futtatása a legolcsóbb órákban
Használd az Aktuális periódus rangja eszközt egy smart rule feltételben. Például egy medenceszivattyú futtatásához csak a nap 6 legolcsóbb órájában:
- Feltétel: Aktuális periódus rangja <= 6
- Művelet: Medenceszivattyú bekapcsolása
Csúcsárak elkerülése
Használd az Aktuális ár eszközt küszöbértékkel:
- Feltétel: Aktuális ár > 150 (EUR/MWh)
- Művelet: Nem létfontosságú fogyasztók kikapcsolása
Időablak-optimalizálás
Állítsd be Tól=22, Ig=6 egy éjszakai ablak meghatározásához, majd használd a Legalacsonyabb ár az időablakban vagy Aktuális periódus rangja időablakban eszközt az akkumulátortöltés vagy a vízmelegítő üzemeltetésének ütemezéséhez a legolcsóbb éjszakai órákban.
Hibaelhárítás
Minden eszköz nullát vagy semmilyen adatot nem mutat
- Ellenőrizd a TapHome Core internetkapcsolatát — a sablon kimenő HTTPS-hozzáférést igényel az
isot.okte.sk-hoz - Ellenőrizd, hogy az API válaszol-e — nyisd meg a
https://isot.okte.sk/api/v1/dam/results?deliveryDayFrom=2026-03-28&deliveryDayTo=2026-03-28címet a böngészőben - A másnapi DAM-árak jellemzően 12:45 CET után kerülnek közzétételre. Közzététel előtt a holnapi dátumra vonatkozó kérések üres eredményt adnak.
Az ablakos eszközök NaN-t adnak vissza
- Ellenőrizd, hogy Tól < Ig a sablon import paramétereiben
- Ellenőrizd, hogy az aktuális óra a Tól–Ig tartományba esik-e (az Aktuális periódus rangja időablakban esetében)
- Ne feledd, hogy a Tól és Ig 24 órás formátumot használ (0–23)
Az árértékek tévesnek tűnnek
Az OKTE az árakat EUR/MWh-ban teszi közzé. EUR/kWh-ra (háztartási léptékre) való átváltáshoz oszd el 1000-rel. A sablon az API nyers értékeit jeleníti meg konverzió nélkül.