API zdarma

API spotových cen elektřiny

Spotové ceny z denního trhu OTE-CR jako REST JSON a přes MQTT, včetně binárního formátu pro ESP32 a jiné mikrokontroléry. Bez registrace, bez API klíče, zdarma.

Bez API klíče
REST JSON v2
MQTT JSON i binárně
Záporné ceny
15minutové intervaly

Živá ukázka

Tato část stránky právě teď volá GET https://api.spotovky.cz/v2/prices/today a z odpovědi vybírá aktuální 15minutový interval.

Načítám aktuální data z API…

Aktuální spotová cena

— Kč/kWh bez DPH

Začátek	Kč/kWh	EUR/MWh	Pořadí

Začátek odpovědi (zkráceno)

Co API nabízí

REST JSON v2

Ceny pro dnešek, zítřek, včerejšek i konkrétní den. Každý interval má přesný začátek v ISO 8601 s posunem, cenu v Kč/kWh i EUR/MWh a pořadí v rámci dne.

MQTT JSON

Broker spotovky.cz:1883 bez jména a hesla. Retain zprávy: data dostanete hned po přihlášení k odběru, aktuální interval se publikuje každých 15 minut.

MQTT binárně

Kompaktní formát pro ESP32 a jiné mikrokontroléry: aktuální interval má vždy 16 bytů, celý den 289 až 313 bytů. Little-endian, ceny jako int16 se znaménkem.

Důležité vlastnosti dat

Zdarma, bez registrace a bez API klíče. CORS je povolen pro všechny domény, API lze volat přímo z prohlížeče.
15minutové intervaly. Běžný den má 96 intervalů ("resolution": "PT15M").
Dny změny času. Při přechodu na letní čas má den 92 intervalů, při přechodu na zimní čas 100. V JSON má každý interval začátek s posunem (+01:00 / +02:00), takže opakovaná hodina 02:00 v říjnu je jednoznačná. Nikdy nepředpokládejte pevný počet 96.
Záporné ceny. Pole czk a eur mohou být záporná, v binárním formátu v2 jsou ceny int16 se znaménkem. Příznak negative říká, že den obsahuje aspoň jednu zápornou cenu.
Zítřejší ceny jsou obvykle k dispozici od 13:05, po 14:30 se ještě upřesní kurz ČNB. Do té doby vrací /v2/prices/tomorrow HTTP 404, nikdy data jiného dne.
Časy se řídí časovým pásmem Europe/Prague (SEČ/SELČ). Den dodávky v poli date je místní den.
Ceny jsou spotové, bez DPH a bez distribuce, daní a poplatků. Ceny distribuce a regulované složky podle ERÚ vrací zvlášť /v2/tariffs.

Rychlý přehled

REST — https://api.spotovky.cz

GET /v2/prices/today

GET /v2/prices/tomorrow

GET /v2/prices/yesterday

GET /v2/prices/2026-10-25

GET /v2/tariffs?distributor=cez&rate=D57d

GET /v2/health

MQTT — spotovky.cz:1883

SUB v2/current/json

SUB v2/current/bin

SUB v2/today/json

SUB v2/today/bin

SUB v2/tomorrow/json

SUB v2/tomorrow/bin

cURL

curl https://api.spotovky.cz/v2/prices/today
curl https://api.spotovky.cz/v2/prices/tomorrow   # HTTP 404, dokud OTE-CR nezveřejní výsledky

mosquitto_sub

mosquitto_sub -h spotovky.cz -p 1883 -t "v2/current/json"

Broker přijímá jen subscribe na konkrétní topicy z dokumentace. Publish a wildcardy (#, +) jsou zakázané a opakované pokusy o zakázané operace mohou vést k dočasnému zablokování IP adresy.

Návody na integraci

Hotové ukázky, které stačí zkopírovat. Všechny používají formát v2.

REST senzor s cenami dne, MQTT senzor aktuální ceny a šablony pro automatizace.

Otevřít návod

Aktuální cena v zařízení s ESPHome přes MQTT nebo z Home Assistantu.

Otevřít návod

ESP32 / Arduino

Binární MQTT zpráva v2 (16 bytů) a varianta přes HTTPS s ArduinoJson.

Otevřít návod

Flow k importu: MQTT JSON, dekódování binární zprávy a REST dotaz.

Otevřít návod

REST s knihovnou requests, nejlevnější blok dne a MQTT s paho-mqtt.

Otevřít návod

Dokumentace a specifikace

Úplný popis všech endpointů, polí JSON, binárního formátu, harmonogramu publikace a pravidel brokeru je v dokumentaci. Strojově čitelný popis REST API je ve formátu OpenAPI 3.1.

Dokumentace API OpenAPI specifikace (YAML) Časté dotazy

Služba je provozována bez záruky dostupnosti. Data jsou veřejná a jejich použití není omezeno; oceníme zmínku o zdrojích dat (OTE-CR, spotovky.cz). Dotazy a hlášení chyb: martin@lysek.cz.