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ůsob | Příklad | Pro koho |
|---|---|---|
| Klíč v cestě | https://www.itexservices.cz/api/spot/v1/k/<klic>/ted.json | Loxone, jednoduché skripty |
| Hlavička Bearer | Authorization: Bearer <klic> | Home Assistant, Node-RED, evcc, vlastní kód |
| Basic Auth | https://<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
| Adresa | Co 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.json | Cena teď, úroveň, nejbližší levné a drahé 3h okno, riziko záporné ceny, „počkat“. | strategie |
okna.json | Nejlevnější a nejdražší okna dané délky, nepřekrývající se. | delka=1–12, pocet=1–5, do=ISO, strategie |
loxone.txt | Totéž co ted.json jako řádky nazev=hodnota + ceny na 48 h. | strategie |
evcc.json | Pole start/end/value pro vlastní tarif v evcc. | strategie |
schedule.json | Rozvrh spotřeby: N nejlevnějších hodin denně, nebo cílové nabíjení. | hodin, pod, kwh+kw+do+ucinnost |
export.json | Kdy omezit přetoky do sítě podle výkupní ceny. | poplatek, prah |
stav.json | Bez 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
{
"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. Hodnota0.1znamená „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.jistotau okna —vysoka(všechny hodiny vyhlášené),stredni(do 3 dnů),nizka(dál).stav—ok, nebostara_data, když jsou data starší než 30 hodin.stari_min= stáří v minutách.
{
"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 -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.txtimport 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"])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 skriptRozvrh 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ód | stav | Kdy |
|---|---|---|
| 401 | neplatny_klic | Chybí klíč, má špatný tvar nebo je zrušený. |
| 422 | neplatny_parametr | Neznámý parametr nebo hodnota mimo rozsah. |
| 429 | limit | Překročený limit. Hlavička Retry-After říká, za kolik sekund to zkusit znovu. |
| 503 | nedostupne | Doč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
/v2a/v1by běžela dál nejméně 12 měsíců.