Electree API
Rozhraní Electree API
Electree API poskytuje aktuální ceny spotového trhu a další důležitá energetická data. Díky tomu můžete lépe řídit spotřebu, optimalizovat náklady na energii a pracovat s daty v reálném čase.
Přístup k API
Služba je dostupná pro zákazníky 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.
GET https://api.electree.cz/VALIDNI_EAN/price
[
{
"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.
GET https://api.electree.cz/VALIDNI_EAN/prices/H10
GET https://api.electree.cz/VALIDNI_EAN/prices/H10
[
{
"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 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.
GET https://api.electree.cz/VALIDNI_EAN/prices/L10
[
{
"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 QT (Quarter Time - 15minutové intervaly)
Vrací ceny pro dnešní a následující den v 15minutových intervalech. Pokud jsou ceny pro následující den dostupné, vrací 192 intervalů (48h × 4), jinak 96 intervalů (24h × 4). V GET dotazu je třeba zadat validní číslo EAN.
GET https://api.electree.cz/VALIDNI_EAN/prices_qt
[
{
"marked":false,
"period":"15min",
"priceCZK":1139.4522,
"priceEUR":46.92,
"timeLocalStart":"2025-11-13, 00:00:00",
"timeUtcStart":"2025-11-12, 23:00:00"
},
{
"marked":false,
"period":"15min",
"priceCZK":795.33375,
"priceEUR":32.75,
"timeLocalStart":"2025-11-13, 00:15:00",
"timeUtcStart":"2025-11-12, 23:15:00"
},
…
]
Prices QT H (Quarter Time - nejvyšší ceny)
Vrací ceny pro dnešní a následující den v 15minutových intervalech s označenými intervaly s nejvyšší cenou. Pokud jsou ceny pro následující den dostupné, vrací 192 intervalů (48h × 4), jinak 96 intervalů (24h × 4). V GET dotazu je třeba zadat validní číslo EAN a požadované množství 15minutových intervalů s nejvyšší cenou v každém dni.
GET https://api.electree.cz/VALIDNI_EAN/prices_qt/H10
[
{
"marked":true,
"period":"15min",
"priceCZK":1139.4522,
"priceEUR":46.92,
"timeLocalStart":"2025-11-13, 00:00:00",
"timeUtcStart":"2025-11-12, 23:00:00"
},
{
"marked":false,
"period":"15min",
"priceCZK":795.33375,
"priceEUR":32.75,
"timeLocalStart":"2025-11-13, 00:15:00",
"timeUtcStart":"2025-11-12, 23:15:00"
},
…
]
Prices QT L (Quarter Time - nejnižší ceny)
Vrací ceny pro dnešní a následující den v 15minutových intervalech s označenými intervaly s nejnižší cenou. Pokud jsou ceny pro následující den dostupné, vrací 192 intervalů (48h × 4), jinak 96 intervalů (24h × 4). V GET dotazu je třeba zadat validní číslo EAN a požadované množství 15minutových intervalů s nejnižší cenou v každém dni.
GET https://api.electree.cz/VALIDNI_EAN/prices_qt/L10
[
{
"marked":true,
"period":"15min",
"priceCZK":1139.4522,
"priceEUR":46.92,
"timeLocalStart":"2025-11-13, 00:00:00",
"timeUtcStart":"2025-11-12, 23:00:00"
},
{
"marked":false,
"period":"15min",
"priceCZK":795.33375,
"priceEUR":32.75,
"timeLocalStart":"2025-11-13, 00:15:00",
"timeUtcStart":"2025-11-12, 23:15: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.
- Příklad pro nejnižších 20 intervalů (15min): L20. Hodnota je omezena na 0 ‑ 96.
- Příklad pro nejvyšších 40 intervalů (15min): H40. Hodnota je omezena na 0 ‑ 96
[
{
"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 tomto intervalu vyhodnocena jako jedna z nejnižších v daném dni.
"period": "1h", //STRING - Hodnota 1h značí interval v trvání jedné hodiny, hodnota 15min značí interval v trvání 15 minut
"priceCZK": 3168.27, //NUMBER($FLOAT) - Cena v daném intervalu v českých korunách
"priceEUR": 126.05, //NUMBER($FLOAT) - Cena v daném intervalu 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)
}
]