Popis veřejného API aplikace Elektrárna

Zjednodušená spotová cena Kč/kWh v aktuální čtvrthodině.
https://elektrarna-api.hostmania.eu/api/v1/currentprice/simple
Nejjednodušší možná verze, kterou nemusíte složitě zpracovávat, výstupem je pouze číslo zaokrouhlené na dvě desetinná místa. Příklad:
3.97

Kompletní údaje ke spotové ceně v aktuální čtvrthodině.
https://elektrarna-api.hostmania.eu/api/v1/currentprice
Údaje jsou ve formátu JSON, příklad:
{
  "hour":20,              //začátek čtvrthodiny platnosti
  "minute":15,
  "priceEur":163.19,      //cena v EUR za 1 MWh
  "priceCzk":3971.23,      //cena v Kč za 1 MWh
  "priceCzkVat":4805.19,   //cena v Kč za 1 MWh + 21% DPH
  "priceCzkKwh":3.97,      //cena v Kč za 1 kWh
  "exchRateCzkEur":24.335, //kurz ČNB použitý pro přepočet z EUR na Kč
  "priceLevel":"high"      //do jaké třetiny cen patří: "low", "medium", "high".
}

---

Zjednodušená spotová cena Kč/kWh v příští čtvrthodině.
https://elektrarna-api.hostmania.eu/api/v1/nextprice/simple
Nejjednodušší možná verze, kterou nemusíte složitě zpracovávat, výstupem je pouze číslo zaokrouhlené na dvě desetinná místa. Příklad:
4.14

Kompletní údaje ke spotové ceně v příští čtvrthodině.
https://elektrarna-api.hostmania.eu/api/v1/nextprice
Údaje jsou ve formátu JSON, příklad:
{
  "hour":20,              //začátek čtvrthodiny platnosti
  "minute":30,
  "priceEur":170.21,      //cena v EUR za 1 MWh
  "priceCzk":4142.06,      //cena v Kč za 1 MWh
  "priceCzkVat":5011.89,   //cena v Kč za 1 MWh + 21% DPH
  "priceCzkKwh":4.14,      //cena v Kč za 1 kWh
  "exchRateCzkEur":24.335, //kurz ČNB použitý pro přepočet z EUR na Kč
  "priceLevel":"high"      //do jaké třetiny cen patří: "low", "medium", "high".
}

---

Nejlevnější časové bloky - dnes
https://elektrarna-api.hostmania.eu/api/v1/cheapest-intervals/today
Pokud potřebujete nejlevnější časový úsek o délce 1-8hodin v aktuálním dni.
Údaje jsou ve formátu JSON, příklad:
{
  "1h":{                    //délka úseku
    "startHour":3,          //hodina začátku
    "startMinute":30,         //minuta začátku
    "endHour":4,            //hodina konce
    "endMinute":30,          //minuta konce
    "averagePriceCzkKwh":2.24    //průměrná cena bloku
  },
  "2h":{
    "startHour":3,
    "startMinute":30,
    "endHour":5,
    "endMinute":30,
    "averagePriceCzkKwh":2.24
  },
  "3h":{
    "startHour":2,
    "startMinute":30,
    "endHour":5,
    "endMinute":30,
    "averagePriceCzkKwh":2.25
  },
  "4h":{
    "startHour":1,
    "startMinute":45,
    "endHour":5,
    "endMinute":45,
    "averagePriceCzkKwh":2.26
  },
  "5h":{
    "startHour":1,
    "startMinute":45,
    "endHour":6,
    "endMinute":45,
    "averagePriceCzkKwh":2.27
  },
  "6h":{
    "startHour":1,
    "startMinute":30,
    "endHour":7,
    "endMinute":30,
    "averagePriceCzkKwh":2.28
  },
  "7h":{
    "startHour":0,
    "startMinute":30,
    "endHour":7,
    "endMinute":30,
    "averagePriceCzkKwh":2.29
  },
  "8h":{
    "startHour":0,
    "startMinute":15,
    "endHour":8,
    "endMinute":15,
    "averagePriceCzkKwh":2.31
  }
}


Nejlevnější časové bloky - dnes od 14:00 + zítra (10+24hod)
https://elektrarna-api.hostmania.eu/api/v1/cheapest-intervals/today34h
Totéž jako předchozí endpoint, ale přes dva dny (14-24:00 dnes + celý zítřek). Pokud tedy nejlevnější časový blok je přes půlnoc, nabídne ho.
POZOR: tento endpoint vrací data pouze v době od dostupnosti cen (od ~15hod) do půlnoci. Pokud se budete ptát v jiné časy, dostanete HTTP status 404 - nejsou data.
Je to pochopitelné - pokud ještě nezná ceny na zítra, nemůže je spočítat a po půlnoci už nabízí nejlevnější bloky na nový "dnešek".
Údaje jsou ve formátu JSON, příklad:
{
  "1h":{                    //délka úseku
    "startHour":3,          //hodina začátku
    "startMinute":30,         //minuta začátku
    "endHour":4,            //hodina konce
    "endMinute":30,          //minuta konce
    "averagePriceCzkKwh":2.24    //průměrná cena bloku
    "startIsTomorrow":false,    //zda je začátek dnes nebo zítra
    "endIsTomorrow":false    //zda je konec dnes nebo zítra
  },
  "2h":{
    "startHour":12,
    "startMinute":30,
    "endHour":14,
    "endMinute":30,
    "averagePriceCzkKwh":1.64,
    "startIsTomorrow":true,
    "endIsTomorrow":true
  },
  "3h":{
    "startHour":12,
    "startMinute":30,
    "endHour":15,
    "endMinute":30,
    "averagePriceCzkKwh":1.67,
    "startIsTomorrow":true,
    "endIsTomorrow":true
  },
  "4h":{
    "startHour":11,
    "startMinute":30,
    "endHour":15,
    "endMinute":30,
    "averagePriceCzkKwh":1.71,
    "startIsTomorrow":true,
    "endIsTomorrow":true
  },
  "5h":{
    "startHour":10,
    "startMinute":45,
    "endHour":15,
    "endMinute":45,
    "averagePriceCzkKwh":1.77,
    "startIsTomorrow":true,
    "endIsTomorrow":true
  },
  "6h":{
    "startHour":23,
    "startMinute":00,
    "endHour":05,
    "endMinute":00,
    "averagePriceCzkKwh":1.83,
    "startIsTomorrow":false,
    "endIsTomorrow":true
  },
  "7h":{
    "startHour":9,
    "startMinute":30,
    "endHour":16,
    "endMinute":30,
    "averagePriceCzkKwh":1.9,
    "startIsTomorrow":true,
    "endIsTomorrow":true
  },
  "8h":{
    "startHour":8,
    "startMinute":45,
    "endHour":16,
    "endMinute":45,
    "averagePriceCzkKwh":1.98,
    "startIsTomorrow":true,
    "endIsTomorrow":true
  }
}


---

API využívá cachování na několika úrovních. V případě, že ho budete využívat k automatizaci, doporučujeme dotazy neodesílat častěji než jednou za minutu.

Pokud musíte něco zbytečně dopočítávat a domníváte se, že by to API mohlo poskytovat v odpovědi, napište email.

---

---

Zpět na domovskou stránku Elektrárna