OKTE (Organizátor krátkodobého trhu s elektrinou) to słowacki operator rynku energii elektrycznej. Publikuje ceny spot na rynku dnia następnego (DAM) — godzinową cenę hurtową energii elektrycznej w EUR/MWh, ustalaną na aukcji dnia poprzedniego.
Szablon TapHome pobiera te ceny z publicznego API OKTE (isot.okte.sk) przez HTTP Packet Parser. Udostępnia cenę za bieżącą godzinę, rankingi cen, obliczenia min/max/średniej oraz analizę okna czasowego — wszystko aktualizowane automatycznie co godzinę. Nie jest wymagane żadne uwierzytelnianie.
Konfiguracja
Szablon łączy się z isot.okte.sk przez HTTPS (port 443). Nie jest potrzebny adres IP ani dane logowania — endpoint jest publicznym API.
Podczas importu szablonu można ustawić dwie opcjonalne zmienne niestandardowe:
- Od — godzina początkowa niestandardowego okna czasowego (0–23, domyślnie: 9)
- Do — godzina końcowa niestandardowego okna czasowego (0–23, domyślnie: 17)
Te zmienne kontrolują warianty urządzeń „w oknie czasowym". Wartości domyślne (9–17) obejmują standardowe godziny pracy. Jeśli nie są potrzebne, pozostaw wartości domyślne — urządzenia całodzienne działają niezależnie.
Jak to działa
Moduł odpytuje API OKTE DAM raz na godzinę (interwał 3600 s). Żądanie API używa dzisiejszej daty:
| |
Odpowiedź zawiera tablicę obiektów cenowych, każdy z numerem period i ceną price w EUR/MWh. W zależności od pory dnia i harmonogramu publikacji OKTE, odpowiedź może zawierać ceny tylko za dzisiaj (24 okresy) lub za maksymalnie 3 dni (72 okresy).
Każdy skrypt urządzenia parsuje tę tablicę JSON za pomocą PARSEJSON(output, "$..price") i stosuje funkcje sortowania, filtrowania lub agregacji do wyprowadzenia wartości.
Możliwości urządzeń
Szablon udostępnia 13 urządzeń sensorowych. Wszystkie są tylko do odczytu — wartości wyprowadzają z tej samej odpowiedzi API.
Aktualna cena i ranking
- Aktualna cena — cena spot za bieżący okres godzinowy w EUR/MWh. Skrypt określa aktualny indeks okresu z
NOW()i zwraca odpowiednią cenę z tablicy. - Ranking aktualnego okresu — pozycja ceny bieżącej godziny wśród wszystkich dostępnych okresów (1 = najtańsza). Przydatne do reguł automatyzacji, takich jak „uruchom pompę ciepła tylko gdy bieżąca godzina jest wśród 8 najtańszych."
- Ranking aktualnego okresu w oknie czasowym — tak samo jak wyżej, ale ograniczone do zdefiniowanego przez użytkownika okna Od–Do. Zwraca NaN, jeśli bieżąca godzina jest poza oknem lub jeśli Od >= Do.
Ekstrema cenowe
- Najwyższa cena dnia — maksymalna cena spot ze wszystkich dostępnych okresów
- Najniższa cena dnia — minimalna cena spot ze wszystkich dostępnych okresów
- Najwyższa cena w oknie czasowym — maksymalna cena w ramach okna Od–Do
- Najniższa cena w oknie czasowym — minimalna cena w ramach okna Od–Do
Średnie
- Średnia cena dnia — średnia arytmetyczna wszystkich dostępnych cen okresów
- Średnia cena w oknie czasowym — średnia arytmetyczna w ramach okna Od–Do
Identyfikacja okresów
- Najtańszy okres dnia — numer okresu oparty na 1 dla najtańszej godziny (np. 3 oznacza 02:00–03:00)
- Najtańszy pozostały okres — najtańsza godzina od bieżącej godziny wzwyż. Aktualizuje się dynamicznie w ciągu dnia.
Liczniki
- Liczba okresów — łączna liczba okresów cenowych w odpowiedzi API (zazwyczaj 24 lub 72)
- Liczba okresów w oknie czasowym — liczba okresów w ramach okna Od–Do
Atrybuty usługi
Moduł udostępnia do 96 atrybutów usługi (Okres 1 do Okres 96), każdy pokazujący cenę spot dla danego okresu godzinowego jako ciąg znaków z przyrostkiem „EUR". W praktyce 24 atrybuty są wypełnione dla jednego dnia lub 72 dla trzech dni.
Te atrybuty zapewniają pełny harmonogram cenowy widoczny w widoku szczegółowym modułu TapHome.
Zmienne niestandardowe (Od / Do)
Kilka urządzeń ma warianty „w oknie czasowym", które filtrują dane cenowe do podzbioru godzin. Okno jest definiowane przez dwie zmienne niestandardowe ustawiane podczas importu szablonu:
- Od — godzina początkowa (włącznie), wartość 0–23
- Do — godzina końcowa (wyłącznie), wartość 0–23
Na przykład ustawienie Od=8 i Do=16 analizuje ceny tylko między 08:00 a 16:00. Jest to przydatne, gdy chcesz zoptymalizować zużycie energii w określonych godzinach — na przykład uruchamiać urządzenia tylko w najtańszych godzinach dnia roboczego.
Jeśli Od >= Do, wszystkie urządzenia okienkowe zwracają NaN.
Przykłady automatyzacji
Uruchamianie urządzeń w najtańszych godzinach
Użyj urządzenia Ranking aktualnego okresu w warunku smart rule. Na przykład, aby uruchomić pompę basenową tylko w 6 najtańszych godzinach dnia:
- Warunek: Ranking aktualnego okresu <= 6
- Akcja: Włącz pompę basenową
Unikanie cen szczytowych
Użyj urządzenia Aktualna cena z wartością progową:
- Warunek: Aktualna cena > 150 (EUR/MWh)
- Akcja: Wyłącz nieistotne odbiorniki
Optymalizacja okna czasowego
Ustaw Od=22, Do=6, aby zdefiniować okno nocne, następnie użyj Najniższa cena w oknie czasowym lub Ranking aktualnego okresu w oknie czasowym, aby zaplanować ładowanie baterii lub pracę podgrzewacza wody w najtańszych godzinach nocnych.
Rozwiązywanie problemów
Wszystkie urządzenia pokazują zero lub brak danych
- Sprawdź połączenie internetowe na TapHome Core — szablon wymaga wychodzącego dostępu HTTPS do
isot.okte.sk - Sprawdź, czy API odpowiada — otwórz
https://isot.okte.sk/api/v1/dam/results?deliveryDayFrom=2026-03-28&deliveryDayTo=2026-03-28w przeglądarce - Ceny DAM na następny dzień są zazwyczaj publikowane po 12:45 CET. Przed publikacją żądania dla jutrzejszej daty zwracają puste wyniki.
Urządzenia okienkowe zwracają NaN
- Sprawdź, że Od < Do w parametrach importu szablonu
- Sprawdź, czy bieżąca godzina mieści się w zakresie Od–Do (dla Rankingu aktualnego okresu w oknie czasowym)
- Pamiętaj, że Od i Do używają formatu 24-godzinnego (0–23)
Wartości cen wydają się nieprawidłowe
OKTE publikuje ceny w EUR/MWh. Aby przeliczyć na EUR/kWh (skala gospodarstwa domowego), podziel przez 1000. Szablon wyświetla surowe wartości z API bez przeliczania.