ITex Services s.r.o.

[ ITexSpot API ]

API předpovědi spotové ceny elektřiny

Výhled ceny elektřiny v Česku na 7 dní pro Loxone, Home Assistant, evcc, Node-RED i vlastní skript. Jedna adresa, krátké odpovědi, česky.

Beta · zdarma · klíč jen ke čtení

Přehled

Úplný popis všech endpointů a polí je v referenci API (specifikace OpenAPI 3.1), historie verzí v přehledu změn.

API vrací vyhlášené ceny denního trhu na dnešek a zítřek a za nimi naši předpověď na zbytek týdne po hodinách, s pásmem nejistoty (p10–p90). K tomu úroveň hodiny (levná, běžná, drahá), nejlevnější a nejdražší okna, pravděpodobnost záporné ceny a odpověď na otázku „nabít teď, nebo počkat“.

Základní adresa je https://www.itexservices.cz/api/spot/v1. Ceny jsou v Kč/kWh, časy ve formátu ISO 8601 s posunem pro Prahu (2026-11-18T12:00:00+01:00). Názvy polí jsou česky bez diakritiky. Klíč je jen ke čtení a v beta provozu je zdarma — vytvoříte si ho v aplikaci ITexLink (Můj účet), nebo o něj požádejte formulářem na stránce ITexSpot.

Data se mění třikrát denně: ráno kolem 6:30, po vyhlášení zítřejších cen kolem 13:45 a po hlavním výpočtu předpovědi kolem 14:35. Každá odpověď nese dalsi_aktualizace — častější dotazy nic nového nepřinesou.

Autentizace

Klíč má tvar its_ a 40 znaků. Předat ho jde třemi způsoby, vyberte, co váš systém umí:

ZpůsobPříkladPro koho
Klíč v cestěhttps://www.itexservices.cz/api/spot/v1/k/<klic>/ted.jsonLoxone, jednoduché skripty
Hlavička BearerAuthorization: Bearer <klic>Home Assistant, Node-RED, evcc, vlastní kód
Basic Authhttps://<klic>@www.itexservices.cz/…Loxone (pole Uživatel nebo Heslo)

U Basic Auth stačí klíč jako uživatel, nebo jako heslo — druhé pole může být prázdné nebo cokoli. Kde to jde, posílejte klíč v hlavičce: adresa s klíčem se může objevit v historii a lozích. Klíč kdykoli zrušíte a vytvoříte nový.

Endpointy

AdresaCo vracíParametry
vyhled.jsonŘada na 7 dní: vyhlášené ceny, dál předpověď s pásmem.krok=60|15, hodin=1–200, strategie
ted.jsonCena teď, úroveň, nejbližší levné a drahé 3h okno, riziko záporné ceny, „počkat“.strategie
okna.jsonNejlevnější a nejdražší okna dané délky, nepřekrývající se.delka=1–12, pocet=1–5, do=ISO, strategie
loxone.txtTotéž co ted.json jako řádky nazev=hodnota + ceny na 48 h.strategie
evcc.jsonPole start/end/value pro vlastní tarif v evcc.strategie
schedule.jsonRozvrh spotřeby: N nejlevnějších hodin denně, nebo cílové nabíjení.hodin, pod, kwh+kw+do+ucinnost
export.jsonKdy omezit přetoky do sítě podle výkupní ceny.poplatek, prah
stav.jsonBez klíče: čas posledního vydání a stáří dat.—

strategie vybírá, kterou hodnotu předpovědi berete jako „cenu“: p50 (výchozí, střed), p10 (optimisticky nízko) nebo p90 (opatrně vysoko). Vyhlášené hodiny se tím nemění. Neznámý parametr nebo hodnota mimo rozsah vrátí 422.

Koncová cena. Když má klíč uložený tarif (přirážka obchodníka, distribuce VT/NT a hodiny VT, poplatky, DPH, poplatek za výkup), odpovědi nesou navíc koncova a vykup a pole „cena“ v textových výstupech a v evcc je koncová cena. Tarif se nastavuje u klíče, ne v adrese.

Co znamenají pole

Jeden slot z vyhled.json (předpověď, klíč s tarifem)
{
  "od": "2026-11-21T12:00:00+01:00", "do": "2026-11-21T13:00:00+01:00",
  "zdroj": "predpoved",
  "spot": 1.95, "p10": 1.1, "p50": 1.95, "p90": 2.9,
  "koncova": 3.57, "koncova_p10": 2.54, "koncova_p90": 4.72,
  "vykup": 1.45, "p_vykup_zaporny": 0.1,
  "uroven": "levna", "poradi_dne": 1, "p_zaporna": 0.1
}
  • zdroj — trh = vyhlášená cena denního trhu, predpoved = náš odhad.
  • p10, p90 — pásmo nejistoty předpovědi. Čím širší, tím je výhled nejistější.
  • uroven — levna (nejlevnější třetina hodin dne), bezna, draha (nejdražší třetina), zaporna (cena pod nulou). poradi_dne = 1 je nejlevnější hodina dne.
  • p_zaporna — pravděpodobnost záporné ceny po desetinách. U vyhlášených hodin 0 nebo 1. Hodnota 0.1 znamená „nejvýš 10 %“, 0.9 „aspoň 90 %“.
  • pockat.levneji_pozdeji — jak pravděpodobné je, že v příštích dnech vyjde okno levnější než nejlepší známé okno aspoň o 0,30 Kč/kWh: nizka, stredni, vysoka. V betě jen slovně (beta: true), číslo doplníme, až bude ověřené na delším provozu.
  • jistota u okna — vysoka (všechny hodiny vyhlášené), stredni (do 3 dnů), nizka (dál).
  • stav — ok, nebo stara_data, když jsou data starší než 30 hodin. stari_min = stáří v minutách.
ted.json (zkráceně)
{
  "verze": "1",
  "beta": true,
  "stav": "ok",
  "vydano": "2026-11-18T14:15:00+01:00",
  "vytvoreno": "2026-11-18T14:21:10+01:00",
  "dalsi_aktualizace": "2026-11-19T06:30:00+01:00",
  "stari_min": 42,
  "mena": "CZK",
  "jednotka": "Kc/kWh",
  "kurz_eur": 24.38,
  "uroven_klice": "beta",
  "strategie": "p50",
  "tarif": { "pouzit": true, "dph": true },
  "cena_ted": 4.012,
  "spot_ted": 2.31,
  "uroven_ted": "levna",
  "levno_ted": true,
  "zmena_urovne_v": "2026-11-18T16:00:00+01:00",
  "okno_3h": {
    "od": "2026-11-19T12:00:00+01:00", "do": "2026-11-19T15:00:00+01:00",
    "cena": 1.84, "cena_p10": 1.84, "cena_p90": 1.84,
    "jistota": "vysoka", "koncova": 3.41, "za_min": 1305
  },
  "p_zaporna_dnes": 0,
  "pockat": {
    "beta": true, "delka": 3, "rozdil": 0.3,
    "nejlepsi_znama": { "od": "2026-11-19T12:00:00+01:00", "do": "2026-11-19T15:00:00+01:00", "cena": 1.84 },
    "levneji_pozdeji": "stredni"
  }
}

Ukázky

curl
curl -H "Authorization: Bearer its_…" https://www.itexservices.cz/api/spot/v1/ted.json

# nejlevnější 4h okno do zítřejšího rána
curl -H "Authorization: Bearer its_…" "https://www.itexservices.cz/api/spot/v1/okna.json?delka=4&do=2026-11-20T06:00"

# Loxone styl: Basic Auth a text
curl -u "its_…:" https://www.itexservices.cz/api/spot/v1/loxone.txt
Python
import requests

r = requests.get(
    "https://www.itexservices.cz/api/spot/v1/ted.json",
    headers={"Authorization": "Bearer its_…"},
    timeout=10,
)
r.raise_for_status()
d = r.json()
print(d["cena_ted"], d["uroven_ted"], d["okno_3h"]["od"])
JavaScript (Node.js 18+)
const r = await fetch("https://www.itexservices.cz/api/spot/v1/schedule.json?hodin=3", {
  headers: { Authorization: "Bearer its_…" },
});
if (!r.ok) throw new Error(`ITexSpot ${r.status}`);
const { aktivni_ted, unix } = await r.json();
// unix = [[začátek, konec], …] v sekundách — např. pro Shelly skript

Rozvrh a přetoky

schedule.json?hodin=4 vybere v každém dni čtyři nejlevnější hodiny. Pro cílové nabíjení zadejte kwh=10&kw=3.7&do=2026-11-20T06:00 (volitelně ucinnost=0.9) — vybere se tolik nejlevnějších hodin před termínem, kolik nabití potřebuje. pod=1.5 přidá každou hodinu s cenou pod hranicí. Odpověď nese aktivni_ted, dalsi_od, intervaly v ISO i jako dvojice unix pro Shelly.

export.json?poplatek=0.5&prah=0 vrátí hodiny, kdy výkupní cena (spot − poplatek) klesne pod práh — tehdy se nevyplatí posílat přebytek do sítě. Poplatek se jinak bere z tarifu klíče.

Chyby

KódstavKdy
401neplatny_klicChybí klíč, má špatný tvar nebo je zrušený.
422neplatny_parametrNeznámý parametr nebo hodnota mimo rozsah.
429limitPřekročený limit. Hlavička Retry-After říká, za kolik sekund to zkusit znovu.
503nedostupneDočasný výpadek. Zkuste za pár minut (Retry-After).

JSON chyby vypadá jako {"verze":"1","stav":"limit","chyba":"…"}. Textový výstup pro Loxone nese i při chybě řádky stav_kod=… a stav=…, aby se chyba neschovala za nulu.

Limity a slušné chování

  • 60 dotazů za hodinu a 500 za den na klíč (úroveň Zdarma 100 za den), nejvýš 3 aktivní klíče na účet.
  • Navíc platí limit 30 dotazů za minutu z jedné IP adresy, ať posíláte jakýkoli klíč (i pro stav.json). Po 10 neplatných pokusech o klíč za 10 minut z jedné adresy odpovídáme 429 do konce té doby.
  • Doporučený interval: Loxone 300 s, Home Assistant 15 min, evcc 1 h. Data se mění třikrát denně, rychleji to nepomůže.
  • Odpovědi lze cachovat podle hlavičky Cache-Control; adresa s klíčem v cestě se cachuje i u nás.
  • Zrušený klíč přestane fungovat nejpozději do 30 minut.
  • Verze 1 je stabilní: nová pole mohou přibýt, ale žádné nezmizí ani nezmění význam. Změna by přišla jako /v2 a /v1 by běžela dál nejméně 12 měsíců.
Předpověď je orientační údaj, ne záruka. Řízení u vás doma musí počítat s tím, že API chvíli neodpoví — nastavte rozumnou výchozí hodnotu a hlídejte stáří dat. Podrobnosti jsou v podmínkách API.