Electree API

Přístup k cenám SPOTu a signálům pro regulační elektřinu

Vítejte v rozhraní Electree API, které vám poskytuje rychlý a spolehlivý přístup k aktuálním cenám SPOTového trhu a dalším důležitým energetickým datům. Naše API je určeno pro zákazníky, kteří chtějí efektivně spravovat svou spotřebu, optimalizovat náklady na energii a získat signály pro regulační elektřinu v reálném čase.

V budoucnu plánujeme rozšíření funkcionalit o pokročilé notifikace a analýzy, které vám umožní rychle reagovat na tržní změny a maximálně využít flexibilitu vaší výroby či spotřeby.

Přístup k API

Služba je dostupná zákazníkům Electree na adrese API Endpoint - https://api.electree.cz/

Seznam použitelných endpointů: API UI - https://api.electree.cz/ui

- Užití jednotlivých endpointů je vázáno na zadání a ověření EAN čísla zákazníka Electree.
- Na jeden EAN je možné zavolat maximálně 6 dotazů za hodinu!

Endpointy

Prices

Vrací ceny pro dnešní a následující den. Pokud jsou ceny pro následující den dostupné, vrací 48 hod, jinak 24 hod. V GET dotazu je třeba zadat validní číslo EAN.

Dotaz:

GET https://api.electree.cz/VALIDNI_EAN/prices

Odpověď:

[
    {
        "marked":false,
        "period":"1h",
        "priceCZK":3168.27,
        "priceEUR":126.05,
        "timeLocalStart":"2025-02-07, 00:00:00",
        "timeUtcStart":"2025-02-06, 23:00:00"
    },
    …
]

Prices H

Vrací ceny pro dnešní a následující den s označenými hodinami s nejvyšší cenou. Pokud jsou ceny pro následující den dostupné, vrací 48 hod, jinak 24 hod. V GET dotazu je třeba zadat validní číslo EAN a požadované množství hodin s nejvyšší cenou v každém dni.

Dotaz:

GET https://api.electree.cz/VALIDNI_EAN/prices/H10

Odpověď:

[
    {
        "marked":true,
        "period":"1h",
        "priceCZK":3168.27,
        "priceEUR":126.05,
        "timeLocalStart":"2025-02-07, 00:00:00",
        "timeUtcStart":"2025-02-06, 23:00:00"
    },
    …
]

Prices L

Vrací ceny pro dnešní a následující den s označenými hodinami s nejnižší cenou. Pokud jsou ceny pro následující den dostupné, vrací 48 hod, jinak 24 hod. V GET dotazu je třeba zadat validní číslo EAN a požadované množství hodin s nejnižší cenou v každém dni.

Dotaz:

GET https://api.electree.cz/VALIDNI_EAN/prices/L10

Odpověď:

[
    {
        "marked":true,
        "period":"1h",
        "priceCZK":3168.27,
        "priceEUR":126.05,
        "timeLocalStart":"2025-02-07, 00:00:00",
        "timeUtcStart":"2025-02-06, 23:00:00"
    },
    …
]

EAN a požadovaná čísla hodin

Je třeba zadat v číselném formátu.

Příklad pro EAN: 859182560612887219.

Příklad pro nejnižších 5 hodin: L5. Hodnota je omezena na 0 – 24.

Příklad pro nejvyšších 11 hodin: H11. Hodnota je omezena na 0 – 24.

Struktura odpovědi

[
    {
    "marked": true, //BOOLEAN - Nabývá hodnoty true nebo false, podle typu dotazu. V případě dotazu na nejnižší cenu bude „marked": true, pokud bude cena v této hodině vyhodnocena jako jedna z nejnižších v daném dni.
    "period": "1h", //STRING - Hodnota 1h, značí interval v trvání jedné hodiny
    "priceCZK": 3168.27, //NUMBER($FLOAT) - Cena v dané hodině v českých korunách
    "priceEUR": 126.05, //NUMBER($FLOAT) - Cena v dané hodině v euro
    "timeLocalStart": "2025-02-07, 00:00:00", //STRING($TIME) - Časová značka začátku intervalu ve formátu času středoevropského časového pásma (CET – Central European Time)
    "timeUtcStart": "2025-02-06, 23:00:00" //STRING($TIME) - Časová značka začátku intervalu ve formátu času koordinovaného světového času (Coordinated Universal Time)
    }
]