ITex Services s.r.o.

[ ITexSpot API · reference ]

Reference API v1

Všechny endpointy, parametry a pole odpovědí, vykreslené přímo ze specifikace OpenAPI 3.1.

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

Specifikace

Verze 1.0.0-beta, OpenAPI 3.1.0, základní adresa https://www.itexservices.cz/api/spot/v1. Specifikaci si stáhněte a otevřete v Postmanu, Insomnii nebo generátoru klienta: openapi.json. Návody a ukázky jsou v dokumentaci API, historie verzí v přehledu změn.

Vyhlášené ceny denního trhu na dnešek a zítřek a za nimi naše předpověď na zbytek týdne po hodinách, s pásmem nejistoty p10–p90. Ceny v Kč/kWh, časy ISO 8601 s posunem Europe/Prague, názvy polí česky bez diakritiky.

Limity: 60 dotazů za hodinu a 500 za den na klíč (úroveň Zdarma 100 za den); navíc 30 dotazů za minutu z jedné IP adresy napříč klíči (i pro stav.json) a nejvýš 10 neplatných pokusů o klíč za 10 minut z jedné adresy. Překročení vrátí 429 s hlavičkou Retry-After. Data se mění několikrát denně — doporučený interval: Loxone 300 s, Home Assistant 15 min, evcc 1 h.

Verzování: přidání pole není změna verze; odebrání pole nebo změna významu znamená /v2 a /v1 poběží dál nejméně 12 měsíců.

Beta provoz zdarma. Předpověď je orientační údaj, ne záruka.

Autentizace

ZpůsobPopis
BearerAuthorization: Bearer its_… — doporučeno pro Home Assistant, Node-RED, evcc a vlastní kód.
BasicKlíč jako uživatel NEBO heslo (druhé pole libovolné). Pro Loxone: https://its_…@www.itexservices.cz/….
/k/{klic}/…API klíč přímo v cestě (pro Loxone a jednoduché skripty). Odpověď smí cachovat i CDN.

Endpointy

GET/vyhled.json

Výhled ceny na 7 dní

Hodinová řada: vyhlášené ceny denního trhu, za nimi naše předpověď s pásmem p10–p90.

Autentizace: Authorization: Bearer nebo Basic Auth, případně klíč v cestě /k/{klic}/vyhled.json.

ParametrTypPopis
krok15 | 60 (výchozí 60)Délka slotu v minutách. Čtvrthodiny jen u vyhlášených cen; předpověď se opakuje.
hodininteger (1–200, výchozí 200)Kolik hodin řady vrátit.
strategie"p10" | "p50" | "p90" | "aggressive" | "balanced" | "conservative" (výchozí p50)Hodnota předpovědi: p10, p50 (výchozí), p90. Přijímá i aliasy aggressive = p10, balanced = p50, conservative = p90.
strategy"p10" | "p50" | "p90" | "aggressive" | "balanced" | "conservative"Anglický alias parametru strategie.
OdpověďPopis
200Řada slotů. Schéma: Vyhled.
401Chybí klíč, má špatný tvar, nebo je neplatný či zrušený.
422Neznámý parametr nebo hodnota mimo rozsah.
429Překročený limit: na klíč (hodina, den), podle IP adresy, nebo příliš mnoho neplatných pokusů o klíč z jedné adresy. Hlavička Retry-After.
503Dočasný výpadek (data nebo databáze). Hlavička Retry-After.
Příklad odpovědi (application/json)
{
  "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
  },
  "krok": 60,
  "rozliseni_predpovedi": 60,
  "sloty": [
    {
      "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,
      "uroven": "levna",
      "poradi_dne": 1,
      "p_zaporna": 0.1
    }
  ]
}

GET/ted.json

Cena teď a nejbližší okna

Cena a úroveň běžící hodiny, nejlevnější a nejdražší 3h okno, riziko záporné ceny a „počkat“.

Autentizace: Authorization: Bearer nebo Basic Auth, případně klíč v cestě /k/{klic}/ted.json.

ParametrTypPopis
strategie"p10" | "p50" | "p90" | "aggressive" | "balanced" | "conservative" (výchozí p50)Hodnota předpovědi: p10, p50 (výchozí), p90. Přijímá i aliasy aggressive = p10, balanced = p50, conservative = p90.
strategy"p10" | "p50" | "p90" | "aggressive" | "balanced" | "conservative"Anglický alias parametru strategie.
OdpověďPopis
200Stav teď. Schéma: Ted.
401Chybí klíč, má špatný tvar, nebo je neplatný či zrušený.
422Neznámý parametr nebo hodnota mimo rozsah.
429Překročený limit: na klíč (hodina, den), podle IP adresy, nebo příliš mnoho neplatných pokusů o klíč z jedné adresy. Hlavička Retry-After.
503Dočasný výpadek (data nebo databáze). Hlavička Retry-After.
Příklad odpovědi (application/json)
{
  "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
  },
  "ted": {
    "od": "2026-11-18T15:00:00+01:00",
    "do": "2026-11-18T16:00:00+01:00",
    "zdroj": "trh",
    "spot": 2.31,
    "koncova": 4.012,
    "uroven": "levna",
    "poradi_dne": 6,
    "p_zaporna": 0
  },
  "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": 1245
  },
  "nejdrazsi_3h": {
    "od": "2026-11-18T17:00:00+01:00",
    "do": "2026-11-18T20:00:00+01:00",
    "cena": 4.6,
    "cena_p10": 4.6,
    "cena_p90": 4.6,
    "jistota": "vysoka",
    "koncova": 6.9,
    "za_min": 105
  },
  "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"
  }
}

GET/okna.json

Nejlevnější a nejdražší okna

Nepřekrývající se souvislá okna dané délky od běžící hodiny.

Autentizace: Authorization: Bearer nebo Basic Auth, případně klíč v cestě /k/{klic}/okna.json.

ParametrTypPopis
delkainteger (1–12, výchozí 3)Délka okna v hodinách.
pocetinteger (1–5, výchozí 3)Kolik oken vrátit.
dostringHledat jen okna končící do tohoto času. ISO 8601; bez posunu = místní čas v Praze. V budoucnosti, nejvýš 9 dní dopředu.
strategie"p10" | "p50" | "p90" | "aggressive" | "balanced" | "conservative" (výchozí p50)Hodnota předpovědi: p10, p50 (výchozí), p90. Přijímá i aliasy aggressive = p10, balanced = p50, conservative = p90.
strategy"p10" | "p50" | "p90" | "aggressive" | "balanced" | "conservative"Anglický alias parametru strategie.
OdpověďPopis
200Okna. Schéma: Okna.
401Chybí klíč, má špatný tvar, nebo je neplatný či zrušený.
422Neznámý parametr nebo hodnota mimo rozsah.
429Překročený limit: na klíč (hodina, den), podle IP adresy, nebo příliš mnoho neplatných pokusů o klíč z jedné adresy. Hlavička Retry-After.
503Dočasný výpadek (data nebo databáze). Hlavička Retry-After.
Příklad odpovědi (application/json)
{
  "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
  },
  "delka": 3,
  "do": null,
  "nejlevnejsi": [
    {
      "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": 1245
    }
  ],
  "nejdrazsi": [
    {
      "od": "2026-11-18T17:00:00+01:00",
      "do": "2026-11-18T20:00:00+01:00",
      "cena": 4.6,
      "cena_p10": 4.6,
      "cena_p90": 4.6,
      "jistota": "vysoka",
      "koncova": 6.9,
      "za_min": 105
    }
  ]
}

GET/loxone.txt

Výstup pro Loxone

Totéž co ted.json jako řádky nazev=hodnota + ceny na 48 h (h00 = běžící hodina). Desetinná tečka, chybějící hodnota = -999, stav_kod vždy první. Rozpoznání v Loxone: \icena_ted=\i\v.

Autentizace: Authorization: Bearer nebo Basic Auth, případně klíč v cestě /k/{klic}/loxone.txt.

ParametrTypPopis
strategie"p10" | "p50" | "p90" | "aggressive" | "balanced" | "conservative" (výchozí p50)Hodnota předpovědi: p10, p50 (výchozí), p90. Přijímá i aliasy aggressive = p10, balanced = p50, conservative = p90.
strategy"p10" | "p50" | "p90" | "aggressive" | "balanced" | "conservative"Anglický alias parametru strategie.
OdpověďPopis
200Text pro Virtual HTTP Input.
401Chybí klíč, má špatný tvar, nebo je neplatný či zrušený.
422Neznámý parametr nebo hodnota mimo rozsah.
429Překročený limit: na klíč (hodina, den), podle IP adresy, nebo příliš mnoho neplatných pokusů o klíč z jedné adresy. Hlavička Retry-After.
503Dočasný výpadek (data nebo databáze). Hlavička Retry-After.
Příklad odpovědi (text/plain)
stav_kod=0
stav=ok
cena_ted=4.012
spot_ted=2.31
levno_ted=1
uroven_ted=1
okno3_za_min=185
okno3_cena=3.41
drahe3_za_min=125
drahe3_cena=6.9
pockat_uroven=1
zaporna_dnes_p=0
stari_min=42
h00=4.012
h01=4.105
…
h47=3.88

GET/evcc.json

Vlastní tarif pro evcc

Pole {start, end, value} od běžící hodiny, časy v UTC se Z. value je koncová cena, má-li klíč tarif, jinak spot.

Autentizace: Authorization: Bearer nebo Basic Auth, případně klíč v cestě /k/{klic}/evcc.json.

ParametrTypPopis
strategie"p10" | "p50" | "p90" | "aggressive" | "balanced" | "conservative" (výchozí p50)Hodnota předpovědi: p10, p50 (výchozí), p90. Přijímá i aliasy aggressive = p10, balanced = p50, conservative = p90.
strategy"p10" | "p50" | "p90" | "aggressive" | "balanced" | "conservative"Anglický alias parametru strategie.
OdpověďPopis
200Ceny pro evcc. Schéma: EvccSlot[].
401Chybí klíč, má špatný tvar, nebo je neplatný či zrušený.
422Neznámý parametr nebo hodnota mimo rozsah.
429Překročený limit: na klíč (hodina, den), podle IP adresy, nebo příliš mnoho neplatných pokusů o klíč z jedné adresy. Hlavička Retry-After.
503Dočasný výpadek (data nebo databáze). Hlavička Retry-After.
Příklad odpovědi (application/json)
[
  {
    "start": "2026-11-18T14:00:00Z",
    "end": "2026-11-18T15:00:00Z",
    "value": 4.012
  }
]

GET/schedule.json

Rozvrh spotřeby

N nejlevnějších hodin v každém dni, nebo cílové nabíjení (kwh + kw, volitelně do a ucinnost). pod přidá každou hodinu pod hranicí.

Autentizace: Authorization: Bearer nebo Basic Auth, případně klíč v cestě /k/{klic}/schedule.json.

ParametrTypPopis
hodininteger (0–24, výchozí 4)Kolik nejlevnějších hodin v každém dni vybrat (výchozí 4, se zadaným pod 0).
podnumber (-10–50)Přidat každou hodinu s cenou pod touto hranicí (Kč/kWh, cena pro uživatele).
kwhnumber (0.1–500)Cílové nabíjení: kolik kWh dodat. Vyžaduje kw.
kwnumber (0.1–100)Výkon nabíjení v kW (k parametru kwh).
dostringTermín cílového nabíjení. ISO 8601; bez posunu = místní čas v Praze.
ucinnostnumber (0.5–1, výchozí 0.9)Účinnost nabíjení.
strategie"p10" | "p50" | "p90" | "aggressive" | "balanced" | "conservative" (výchozí p50)Hodnota předpovědi: p10, p50 (výchozí), p90. Přijímá i aliasy aggressive = p10, balanced = p50, conservative = p90.
strategy"p10" | "p50" | "p90" | "aggressive" | "balanced" | "conservative"Anglický alias parametru strategie.
OdpověďPopis
200Rozvrh. Schéma: Rozvrh.
401Chybí klíč, má špatný tvar, nebo je neplatný či zrušený.
422Neznámý parametr nebo hodnota mimo rozsah.
429Překročený limit: na klíč (hodina, den), podle IP adresy, nebo příliš mnoho neplatných pokusů o klíč z jedné adresy. Hlavička Retry-After.
503Dočasný výpadek (data nebo databáze). Hlavička Retry-After.
Příklad odpovědi (application/json)
{
  "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
  },
  "rezim": "hodiny_denne",
  "hodin_vybrano": 2,
  "aktivni_ted": false,
  "aktivni_do": null,
  "dalsi_od": "2026-11-19T12:00:00+01:00",
  "intervaly": [
    {
      "od": "2026-11-19T12:00:00+01:00",
      "do": "2026-11-19T14:00:00+01:00"
    }
  ],
  "unix": [
    [
      1795086000,
      1795093200
    ]
  ],
  "hodiny": [
    {
      "od": "2026-11-19T12:00:00+01:00",
      "cena": 3.3,
      "zdroj": "trh"
    },
    {
      "od": "2026-11-19T13:00:00+01:00",
      "cena": 3.4,
      "zdroj": "trh"
    }
  ]
}

GET/export.json

Kdy omezit přetoky

Hodiny, kdy výkupní cena (spot − poplatek) klesne pod práh.

Autentizace: Authorization: Bearer nebo Basic Auth, případně klíč v cestě /k/{klic}/export.json.

ParametrTypPopis
poplateknumber (0–10)Poplatek výkupce v Kč/kWh. Výchozí z tarifu klíče, jinak 0.
prahnumber (-10–10, výchozí 0)Omezit přetoky, když výkupní cena klesne pod tuto hodnotu (Kč/kWh).
strategie"p10" | "p50" | "p90" | "aggressive" | "balanced" | "conservative" (výchozí p50)Hodnota předpovědi: p10, p50 (výchozí), p90. Přijímá i aliasy aggressive = p10, balanced = p50, conservative = p90.
strategy"p10" | "p50" | "p90" | "aggressive" | "balanced" | "conservative"Anglický alias parametru strategie.
OdpověďPopis
200Omezení přetoků. Schéma: Export.
401Chybí klíč, má špatný tvar, nebo je neplatný či zrušený.
422Neznámý parametr nebo hodnota mimo rozsah.
429Překročený limit: na klíč (hodina, den), podle IP adresy, nebo příliš mnoho neplatných pokusů o klíč z jedné adresy. Hlavička Retry-After.
503Dočasný výpadek (data nebo databáze). Hlavička Retry-After.
Příklad odpovědi (application/json)
{
  "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
  },
  "poplatek": 0.5,
  "prah": 0,
  "aktivni_ted": false,
  "aktivni_do": null,
  "dalsi_od": "2026-11-22T12:00:00+01:00",
  "intervaly": [
    {
      "od": "2026-11-22T12:00:00+01:00",
      "do": "2026-11-22T13:00:00+01:00"
    }
  ],
  "unix": [
    [
      1795345200,
      1795348800
    ]
  ],
  "hodiny": [
    {
      "od": "2026-11-22T12:00:00+01:00",
      "vykup": -0.12,
      "zdroj": "predpoved",
      "p_vykup_pod_prahem": 0.6
    }
  ]
}

GET/stav.json

Stav dat (bez klíče)

Čas posledního vydání a stáří dat. Bez klíče, ale limit podle IP platí.

Autentizace: bez klíče (limit podle IP platí).

OdpověďPopis
200Stav. Schéma: Stav.
429Překročený limit: na klíč (hodina, den), podle IP adresy, nebo příliš mnoho neplatných pokusů o klíč z jedné adresy. Hlavička Retry-After.
503Data nejsou k dispozici. Hlavička Retry-After.
Příklad odpovědi (application/json)
{
  "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,
  "znama_do": "2026-11-20T00:00:00+01:00",
  "predpoved_do": "2026-11-26T00:00:00+01:00"
}

Schémata

Hlavicka

Společná hlavička všech JSON odpovědí s klíčem (kromě evcc.json).

PoleTypPovinnéPopis
verze"1"anoHlavní verze API.
betatrueanoAPI je v beta provozu.
stav"ok" | "stara_data"anostara_data, když jsou data starší než 30 hodin.
vydanostring (date-time) | nullanoKdy jsme výhled vydali (ISO 8601 s posunem Europe/Prague).
vytvorenostring (date-time)anoKdy vznikl dokument, ze kterého odpověď počítáme.
dalsi_aktualizacestring (date-time)anoNejbližší plánovaná obnova dat. Dřívější dotaz nic nového nepřinese.
stari_mininteger (0–…)anoStáří dat v minutách.
mena"CZK"ano
jednotka"Kc/kWh"ano
kurz_eurnumberanoKurz EUR/CZK (ČNB), kterým jsme přepočetli ceny trhu.
uroven_klice"beta" | "zdarma" | "placeny"anoÚroveň klíče. zdarma dostane předpověď jen 48 h za poslední vyhlášenou hodinou a bez pásma.
strategieStrategieano
tarifobjectano Pole: pouzit, dph.

Strategie

Která hodnota předpovědi se bere jako „cena“: p10 (optimisticky nízko), p50 (střed), p90 (opatrně vysoko).

Typ: "p10" | "p50" | "p90"

Uroven

levna = nejlevnější třetina hodin dne, draha = nejdražší třetina, zaporna = cena pod nulou.

Typ: "zaporna" | "levna" | "bezna" | "draha" | null

Slot

Jedna hodina (nebo čtvrthodina u krok=15).

PoleTypPovinnéPopis
odstring (date-time)anoZačátek.
dostring (date-time)anoKonec.
zdroj"trh" | "predpoved"anotrh = vyhlášená cena denního trhu, predpoved = náš odhad.
spotnumberanoSpotová cena bez DPH a distribuce (Kč/kWh); u předpovědi podle strategie.
p10numberneDolní okraj pásma předpovědi. Jen u předpovědi a ne u úrovně Zdarma.
p50numberneStřed předpovědi. Jen u předpovědi a ne u úrovně Zdarma.
p90numberneHorní okraj pásma předpovědi. Jen u předpovědi a ne u úrovně Zdarma.
koncovanumberneKoncová cena podle tarifu klíče. Jen když má klíč tarif.
koncova_p10numberneKoncová cena z p10. Jen s tarifem a pásmem.
koncova_p90numberneKoncová cena z p90. Jen s tarifem a pásmem.
vykupnumberneVýkupní cena = spot − poplatek výkupce. Jen když tarif klíče nese poplatek za výkup.
p_vykup_zapornynumber | null (0–1)nePravděpodobnost záporné výkupní ceny. Jen s poplatkem za výkup.
urovenUrovenano
poradi_dneinteger | null (1–…)anoPořadí hodiny ve dni podle ceny, 1 = nejlevnější.
p_zapornanumber | null (0–1)anoPravděpodobnost záporné ceny po desetinách; u vyhlášených hodin 0 nebo 1. 0.1 = nejvýš 10 %, 0.9 = aspoň 90 %.

Okno

Souvislé okno hodin; okna se nepřekrývají.

PoleTypPovinnéPopis
odstring (date-time)anoZačátek okna.
dostring (date-time)anoKonec okna.
cenanumberanoPrůměrný spot okna (Kč/kWh).
cena_p10numberanoPrůměr p10 hodin okna.
cena_p90numberanoPrůměr p90 hodin okna.
jistota"vysoka" | "stredni" | "nizka"anovysoka = všechny hodiny vyhlášené, stredni = do 3 dnů, nizka = dál.
koncovanumbernePrůměrná koncová cena. Jen když má klíč tarif.
za_mininteger (0–…)anoZa kolik minut okno začne (0 = právě běží).

Pockat

„Nabít teď, nebo počkat?“ V betě jen slovně.

PoleTypPovinnéPopis
betatrueano
delkaintegeranoDélka okna v hodinách.
rozdilnumberanoO kolik (Kč/kWh) musí být pozdější okno levnější.
nejlepsi_znamaobject | nullano
levneji_pozdeji"nizka" | "stredni" | "vysoka"anoJak pravděpodobné je, že v příštích dnech vyjde okno levnější než nejlepší známé.

Intervaly

PoleTypPovinnéPopis
aktivni_tedbooleananoBěží právě teď vybraný interval.
aktivni_dostring (date-time) | nullanoKonec běžícího intervalu.
dalsi_odstring (date-time) | nullanoZačátek dalšího intervalu.
intervalyobject[]ano
unix[integer, integer][]anoTytéž intervaly jako dvojice [začátek, konec] v unixových sekundách (Shelly skripty).

Vyhled

Obsahuje všechna pole z Hlavicka a navíc:

PoleTypPovinnéPopis
krok15 | 60anoDélka slotu v minutách.
rozliseni_predpovedi60anoPředpověď je hodinová; u krok=15 se hodnota opakuje po čtvrthodinách.
slotySlot[]ano

Ted

Obsahuje všechna pole z Hlavicka a navíc:

PoleTypPovinnéPopis
tedSlot | nullano
cena_tednumber | nullanoCena teď: koncová, má-li klíč tarif, jinak spot.
spot_tednumber | nullanoSpot teď.
uroven_tedUrovenano
levno_tedboolean | nullanoLevná nebo záporná hodina.
zmena_urovne_vstring (date-time) | nullanoKdy se úroveň změní.
okno_3hOkno | nullano
nejdrazsi_3hOkno | nullano
p_zaporna_dnesnumber | nullanoNejvyšší pravděpodobnost záporné ceny do konce dne.
pockatPockat | nullano

Okna

Obsahuje všechna pole z Hlavicka a navíc:

PoleTypPovinnéPopis
delkaintegeranoDélka oken v hodinách.
dostring (date-time) | nullanoHledá se jen do tohoto času (parametr do).
nejlevnejsiOkno[]ano
nejdrazsiOkno[]ano

Rozvrh

Obsahuje všechna pole z Hlavicka a Intervaly a navíc:

PoleTypPovinnéPopis
rezim"hodiny_denne" | "nabijeni"anonabijeni při zadaném kwh, jinak N hodin denně.
hodin_vybranointeger (0–…)ano
hodinyobject[]ano

Export

Obsahuje všechna pole z Hlavicka a Intervaly a navíc:

PoleTypPovinnéPopis
poplateknumberanoPoužitý poplatek výkupce.
prahnumberanoPoužitý práh výkupní ceny.
hodinyobject[]ano

EvccSlot

PoleTypPovinnéPopis
startstring (date-time)anoZačátek v UTC se Z.
endstring (date-time)anoKonec v UTC se Z.
valuenumberanoCena pro uživatele (Kč/kWh).

Stav

PoleTypPovinnéPopis
verze"1"ano
betatrueano
stav"ok" | "stara_data"ano
vydanostring (date-time) | nullanoKdy jsme výhled vydali.
vytvorenostring (date-time)anoKdy vznikl dokument.
dalsi_aktualizacestring (date-time)anoNejbližší plánovaná obnova.
stari_mininteger (0–…)ano
znama_dostring (date-time) | nullanoKonec poslední vyhlášené hodiny.
predpoved_dostring (date-time)anoKonec předpovědi.

Chyba

PoleTypPovinnéPopis
verze"1"ano
stav"neplatny_klic" | "limit" | "neplatny_parametr" | "nedostupne" | "nenalezeno"ano
chybastringnePopis chyby česky.
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.