ITex Services s.r.o.

[ ITexSpot API · reference ]

API v1 reference

All endpoints, parameters and response fields, rendered directly from the OpenAPI 3.1 specification.

Beta · free · read-only key

Czech bidding zone (CZ) only — prices in CZK, Czech distribution tariffs.

Specification

Version 1.1.0-beta, OpenAPI 3.1.0, base URL https://api.itexservices.cz/v1. Download the specification and open it in Postman, Insomnia or a client generator: openapi.json. Guides and examples are in the API documentation, version history in the changelog. Field names, parameters and values stay in Czech (without diacritics) — they are part of the API contract; their meaning is described below.

Published day-ahead market prices for today and tomorrow, followed by our hourly forecast for the rest of the week, with a p10–p90 uncertainty band. Czech bidding zone (CZ) only — prices in CZK, Czech distribution tariffs. Prices in CZK/kWh, times in ISO 8601 with the Europe/Prague offset, field names in Czech without diacritics.

Limits: 60 requests per hour and 500 per day per key (Free tier 300 per day); in addition, 30 requests per minute from a single IP address across keys (including stav.json) and at most 10 invalid key attempts per 10 minutes from a single address. Exceeding a limit returns 429 with a Retry-After header. Data changes several times a day — recommended polling interval: Loxone 300 s, Home Assistant 20 min, evcc 1 h.

The API key in the path is the primary method. A response to /k/<klic>/… goes through our cache (CDN), so it is faster and not every repeated request counts toward the limit. The Authorization header (Bearer and Basic Auth) works too, but such a response is never stored in the cache — every request goes all the way to the computation.

During an API outage your control must stay in a safe state: watch stav_kod / stav and stari_min and keep a fallback window (see the documentation, section “Safe behavior during an API outage”).

Versioning: adding a field is not a version change; removing a field or changing its meaning means /v2, and /v1 will keep running for at least 12 months.

Free beta. The forecast is indicative, not a guarantee.

Authentication

MethodDescription
BearerAuthorization: Bearer its_… — recommended for Home Assistant, Node-RED, evcc and custom code.
BasicAPI key as the username OR password (the other field is arbitrary). For Loxone: https://its_…@api.itexservices.cz/v1/….
/k/{klic}/…API key directly in the path (for Loxone and simple scripts). The response may also be cached by the CDN.

Endpoints

GET/vyhled.json

7-day price outlook

Hourly series: published day-ahead market prices, followed by our forecast with a p10–p90 band.

Authentication: Authorization: Bearer or Basic Auth, or the key in the path /k/{klic}/vyhled.json.

ParameterTypeDescription
krok15 | 60 (default 60)Slot length in minutes. Quarter-hours only for published prices; the forecast value is repeated.
hodininteger (1–200, default 200)How many hours of the series to return.
strategie"p10" | "p50" | "p90" | "aggressive" | "balanced" | "conservative" (default p50)Forecast value: p10, p50 (default), p90. Also accepts the aliases aggressive = p10, balanced = p50, conservative = p90.
strategy"p10" | "p50" | "p90" | "aggressive" | "balanced" | "conservative"English alias of the strategie parameter.
ResponseDescription
200Series of slots. Schema: Vyhled.
401API key missing, malformed, invalid or revoked.
422Unknown parameter or value out of range.
429Limit exceeded: per API key (hour, day), per IP address, or too many invalid API key attempts from a single address. Header Retry-After.
503Temporary outage (data or database). Header Retry-After.
Example response (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

Current price and nearest windows

Price and level of the current hour, cheapest and most expensive 3-hour window, negative price risk and “wait”.

Authentication: Authorization: Bearer or Basic Auth, or the key in the path /k/{klic}/ted.json.

ParameterTypeDescription
ninteger (1–24, default 4)How many cheapest hours of the day v_n_nejlevnejsich tracks.
strategie"p10" | "p50" | "p90" | "aggressive" | "balanced" | "conservative" (default p50)Forecast value: p10, p50 (default), p90. Also accepts the aliases aggressive = p10, balanced = p50, conservative = p90.
strategy"p10" | "p50" | "p90" | "aggressive" | "balanced" | "conservative"English alias of the strategie parameter.
ResponseDescription
200Current status. Schema: Ted.
401API key missing, malformed, invalid or revoked.
422Unknown parameter or value out of range.
429Limit exceeded: per API key (hour, day), per IP address, or too many invalid API key attempts from a single address. Header Retry-After.
503Temporary outage (data or database). Header Retry-After.
Example response (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"
  },
  "poradi_ted": 3,
  "n": 4,
  "v_n_nejlevnejsich": true,
  "nejlevnejsi_hodina": {
    "dnes": {
      "base": 13,
      "peak": 13,
      "offpeak": 3,
      "zdroj": "trh"
    },
    "zitra": {
      "base": 12,
      "peak": 12,
      "offpeak": 2,
      "zdroj": "trh"
    }
  }
}

GET/okna.json

Cheapest and most expensive windows

Non-overlapping contiguous windows of the given length starting from the current hour.

Authentication: Authorization: Bearer or Basic Auth, or the key in the path /k/{klic}/okna.json.

ParameterTypeDescription
delkainteger (1–12, default 3)Window length in hours.
pocetinteger (1–5, default 3)How many windows to return.
dostringSearch only for windows ending by this time. ISO 8601; without an offset = local time in Prague. Must be in the future, at most 9 days ahead.
strategie"p10" | "p50" | "p90" | "aggressive" | "balanced" | "conservative" (default p50)Forecast value: p10, p50 (default), p90. Also accepts the aliases aggressive = p10, balanced = p50, conservative = p90.
strategy"p10" | "p50" | "p90" | "aggressive" | "balanced" | "conservative"English alias of the strategie parameter.
ResponseDescription
200Windows. Schema: Okna.
401API key missing, malformed, invalid or revoked.
422Unknown parameter or value out of range.
429Limit exceeded: per API key (hour, day), per IP address, or too many invalid API key attempts from a single address. Header Retry-After.
503Temporary outage (data or database). Header Retry-After.
Example response (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

Output for Loxone

Same as ted.json as nazev=hodnota (name=value) lines + prices for 48 h (h00 = current hour). Decimal point, missing value = -999, stav_kod always first. Recognition in Loxone: \icena_ted=\i\v. v1.1: day signals (poradi_ted, v_n_nejlevnejsich, nejl_dnes_base|peak|offpeak, nejl_zitra_base|peak|offpeak; hour 0–23, unknown day -999) and lines r00…r23 for the Spot Price Optimizer block in relative mode (inputs +0…+23). For r00…r23 a missing hour is 999, not -999 — the block would treat -999 as the cheapest hour.

Authentication: Authorization: Bearer or Basic Auth, or the key in the path /k/{klic}/loxone.txt.

ParameterTypeDescription
ninteger (1–24, default 4)How many cheapest hours of the day v_n_nejlevnejsich tracks.
strategie"p10" | "p50" | "p90" | "aggressive" | "balanced" | "conservative" (default p50)Forecast value: p10, p50 (default), p90. Also accepts the aliases aggressive = p10, balanced = p50, conservative = p90.
strategy"p10" | "p50" | "p90" | "aggressive" | "balanced" | "conservative"English alias of the strategie parameter.
ResponseDescription
200Text for Virtual HTTP Input.
401API key missing, malformed, invalid or revoked.
422Unknown parameter or value out of range.
429Limit exceeded: per API key (hour, day), per IP address, or too many invalid API key attempts from a single address. Header Retry-After.
503Temporary outage (data or database). Header Retry-After.
Example response (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
poradi_ted=3
v_n_nejlevnejsich=1
nejl_dnes_base=13
nejl_dnes_peak=13
nejl_dnes_offpeak=3
nejl_zitra_base=12
nejl_zitra_peak=12
nejl_zitra_offpeak=2
h00=4.012
h01=4.105
…
h47=3.88
r00=4.012
r01=4.105
…
r23=3.95

GET/evcc.json

Custom tariff for evcc

Array of {start, end, value} from the current hour, times in UTC with Z. value is the end-user price if the API key has a tariff, otherwise spot.

Authentication: Authorization: Bearer or Basic Auth, or the key in the path /k/{klic}/evcc.json.

ParameterTypeDescription
strategie"p10" | "p50" | "p90" | "aggressive" | "balanced" | "conservative" (default p50)Forecast value: p10, p50 (default), p90. Also accepts the aliases aggressive = p10, balanced = p50, conservative = p90.
strategy"p10" | "p50" | "p90" | "aggressive" | "balanced" | "conservative"English alias of the strategie parameter.
ResponseDescription
200Prices for evcc. Schema: EvccSlot[].
401API key missing, malformed, invalid or revoked.
422Unknown parameter or value out of range.
429Limit exceeded: per API key (hour, day), per IP address, or too many invalid API key attempts from a single address. Header Retry-After.
503Temporary outage (data or database). Header Retry-After.
Example response (application/json)
[
  {
    "start": "2026-11-18T14:00:00Z",
    "end": "2026-11-18T15:00:00Z",
    "value": 4.012
  }
]

GET/schedule.json

Consumption schedule

N cheapest hours in each day, or target charging (kwh + kw, optionally do and ucinnost). pod adds every hour below the threshold.

Authentication: Authorization: Bearer or Basic Auth, or the key in the path /k/{klic}/schedule.json.

ParameterTypeDescription
hodininteger (0–24, default 4)How many cheapest hours to select in each day (default 4, or 0 when pod is given).
podnumber (-10–50)Add every hour with a price below this threshold (CZK/kWh, price for the user).
kwhnumber (0.1–500)Target charging: how many kWh to deliver. Requires kw.
kwnumber (0.1–100)Charging power in kW (for the kwh parameter).
dostringTarget charging deadline. ISO 8601; without an offset = local time in Prague.
ucinnostnumber (0.5–1, default 0.9)Charging efficiency.
strategie"p10" | "p50" | "p90" | "aggressive" | "balanced" | "conservative" (default p50)Forecast value: p10, p50 (default), p90. Also accepts the aliases aggressive = p10, balanced = p50, conservative = p90.
strategy"p10" | "p50" | "p90" | "aggressive" | "balanced" | "conservative"English alias of the strategie parameter.
ResponseDescription
200Schedule. Schema: Rozvrh.
401API key missing, malformed, invalid or revoked.
422Unknown parameter or value out of range.
429Limit exceeded: per API key (hour, day), per IP address, or too many invalid API key attempts from a single address. Header Retry-After.
503Temporary outage (data or database). Header Retry-After.
Example response (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

When to limit grid export

Hours when the feed-in/export price (spot − fee) drops below the threshold.

Authentication: Authorization: Bearer or Basic Auth, or the key in the path /k/{klic}/export.json.

ParameterTypeDescription
poplateknumber (0–10)Feed-in buyer fee in CZK/kWh. Defaults to the API key's tariff, otherwise 0.
prahnumber (-10–10, default 0)Limit grid export when the feed-in/export price drops below this value (CZK/kWh).
strategie"p10" | "p50" | "p90" | "aggressive" | "balanced" | "conservative" (default p50)Forecast value: p10, p50 (default), p90. Also accepts the aliases aggressive = p10, balanced = p50, conservative = p90.
strategy"p10" | "p50" | "p90" | "aggressive" | "balanced" | "conservative"English alias of the strategie parameter.
ResponseDescription
200Grid export limiting. Schema: Export.
401API key missing, malformed, invalid or revoked.
422Unknown parameter or value out of range.
429Limit exceeded: per API key (hour, day), per IP address, or too many invalid API key attempts from a single address. Header Retry-After.
503Temporary outage (data or database). Header Retry-After.
Example response (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/baterie.json

Recommended battery plan

v1.1: recommends charging, discharging or holding hour by hour and computes the expected state of charge and savings versus “do nothing”. A simple model (dynamic programming over the state of charge) without household consumption or PV production: a discharged kWh is worth the price of its hour (it covers consumption you would otherwise buy), and wear is deducted for every kWh delivered from the battery. A recommendation only, not control — the user is responsible for its use. Computed on request from the same precomputed outlook, with the same limits and cache as the other endpoints.

Authentication: Authorization: Bearer or Basic Auth, or the key in the path /k/{klic}/baterie.json.

ParameterTypeDescription
kapacitanumber (0.5–500)Usable battery capacity in kWh.
vykonnumber (0.1–100)Charging and discharging power in kW (on the grid and household side).
socnumber (0–100)Current state of charge in %.
soc_minnumber (0–99, default 10)Minimum allowed state of charge in %.
soc_maxnumber (1–100, default 100)Maximum allowed state of charge in %.
soc_konecnumber (0–100)State of charge the battery should have at the end of the horizon (default = soc, clipped to soc_min–soc_max).
ucinnostnumber (0.5–1, default 0.9)Round-trip efficiency of the charge and discharge cycle.
opotrebeninumber (0–20, default 0)Battery wear cost in CZK per kWh delivered from the battery. The plan discharges only when it pays off even after deducting it.
hodininteger (1–48, default 24)Plan horizon in hours from the current hour.
strategie"p10" | "p50" | "p90" | "aggressive" | "balanced" | "conservative" (default p50)Forecast value: p10, p50 (default), p90. Also accepts the aliases aggressive = p10, balanced = p50, conservative = p90.
strategy"p10" | "p50" | "p90" | "aggressive" | "balanced" | "conservative"English alias of the strategie parameter.
ResponseDescription
200Recommended battery plan. Schema: Baterie.
401API key missing, malformed, invalid or revoked.
422Unknown parameter or value out of range.
429Limit exceeded: per API key (hour, day), per IP address, or too many invalid API key attempts from a single address. Header Retry-After.
503Temporary outage (data or database). Header Retry-After.
Example response (application/json)
{
  "verze": "1",
  "beta": true,
  "stav": "ok",
  "jen_doporuceni": true,
  "upozorneni": "Doporučení, ne řízení. Za použití plánu odpovídá uživatel; plán nezná spotřebu domu, výrobu FVE ani stav sítě.",
  "parametry": {
    "kapacita": 10,
    "vykon": 5,
    "soc": 50,
    "soc_min": 10,
    "soc_max": 100,
    "soc_konec": 50,
    "ucinnost": 0.9,
    "opotrebeni": 0.5,
    "hodin": 24
  },
  "akce_ted": "drzet",
  "hodiny": [
    {
      "od": "2026-11-18T02:00:00+01:00",
      "do": "2026-11-18T03:00:00+01:00",
      "zdroj": "trh",
      "cena": 1.2,
      "akce": "nabijet",
      "nabiti_kwh": 4.743,
      "vybiti_kwh": 0,
      "soc_konec": 100
    },
    {
      "od": "2026-11-18T08:00:00+01:00",
      "do": "2026-11-18T09:00:00+01:00",
      "zdroj": "trh",
      "cena": 5.4,
      "akce": "vybijet",
      "nabiti_kwh": 0,
      "vybiti_kwh": 4.981,
      "soc_konec": 47.5
    }
  ],
  "ekonomika": {
    "uspora": 12.66,
    "naklad_nabijeni": 5.69,
    "hodnota_vybiti": 26.9,
    "opotrebeni": 2.49,
    "srovnani": "nic_nedelat",
    "cil_splnen": true
  }
}

GET/stav.json

Data status (no API key)

Time of the last release and data age. No API key needed, but the per-IP limit applies.

Authentication: no key (the per-IP limit applies).

ResponseDescription
200Status. Schema: Stav.
429Limit exceeded: per API key (hour, day), per IP address, or too many invalid API key attempts from a single address. Header Retry-After.
503Data not available. Header Retry-After.
Example response (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"
}

Schemas

Hlavicka

Common header of all JSON responses with an API key (except evcc.json).

FieldTypeRequiredDescription
verze"1"yesMajor API version.
betatrueyesThe API is in beta.
stav"ok" | "stara_data"yesstara_data (stale data) when the data is older than 30 hours.
vydanostring (date-time) | nullyesWhen we released the outlook (ISO 8601 with the Europe/Prague offset).
vytvorenostring (date-time)yesWhen the document the response is computed from was created.
dalsi_aktualizacestring (date-time)yesNext scheduled data refresh. An earlier request brings nothing new.
stari_mininteger (0–…)yesData age in minutes.
mena"CZK"yes
jednotka"Kc/kWh"yes
kurz_eurnumberyesEUR/CZK exchange rate (Czech National Bank) used to convert market prices.
uroven_klice"beta" | "zdarma" | "placeny"yesAPI key tier. zdarma (free) gets the forecast only 48 h beyond the last published hour and without the band.
strategieStrategieyes
tarifobjectyes Fields: pouzit, dph.

Strategie

Which forecast value is taken as the “price”: p10 (optimistically low), p50 (middle), p90 (cautiously high).

Type: "p10" | "p50" | "p90"

Uroven

levna (cheap) = cheapest third of the day's hours, draha (expensive) = most expensive third, zaporna (negative) = price below zero.

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

Slot

One hour (or a quarter-hour with krok=15).

FieldTypeRequiredDescription
odstring (date-time)yesStart.
dostring (date-time)yesEnd.
zdroj"trh" | "predpoved"yestrh (market) = published day-ahead market price, predpoved (forecast) = our estimate.
spotnumberyesSpot price excluding VAT and distribution (CZK/kWh); for the forecast according to the strategy.
p10numbernoLower edge of the forecast band. Only for the forecast and not on the Free tier.
p50numbernoMiddle of the forecast. Only for the forecast and not on the Free tier.
p90numbernoUpper edge of the forecast band. Only for the forecast and not on the Free tier.
koncovanumbernoEnd-user price according to the API key's tariff. Only when the API key has a tariff.
koncova_p10numbernoEnd-user price from p10. Only with a tariff and the band.
koncova_p90numbernoEnd-user price from p90. Only with a tariff and the band.
vykupnumbernoFeed-in/export price = spot − feed-in buyer fee. Only when the API key's tariff includes a feed-in fee.
p_vykup_zapornynumber | null (0–1)noProbability of a negative feed-in/export price. Only with a feed-in fee.
urovenUrovenyes
poradi_dneinteger | null (1–…)yesRank of the hour within the day by price, 1 = cheapest.
p_zapornanumber | null (0–1)yesProbability of a negative price in tenths; 0 or 1 for published hours. 0.1 = at most 10 %, 0.9 = at least 90 %.

Okno

Contiguous window of hours; windows do not overlap.

FieldTypeRequiredDescription
odstring (date-time)yesWindow start.
dostring (date-time)yesWindow end.
cenanumberyesAverage spot price of the window (CZK/kWh).
cena_p10numberyesAverage p10 of the window's hours.
cena_p90numberyesAverage p90 of the window's hours.
jistota"vysoka" | "stredni" | "nizka"yesvysoka (high) = all hours published, stredni (medium) = within 3 days, nizka (low) = further out.
koncovanumbernoAverage end-user price. Only when the API key has a tariff.
za_mininteger (0–…)yesMinutes until the window starts (0 = running now).

Pockat

“Charge now, or wait?” Verbal only during the beta.

FieldTypeRequiredDescription
betatrueyes
delkaintegeryesWindow length in hours.
rozdilnumberyesBy how much (CZK/kWh) a later window must be cheaper.
nejlepsi_znamaobject | nullyes
levneji_pozdeji"nizka" | "stredni" | "vysoka"yesHow likely it is that a window cheaper than the best known one will appear in the coming days.

Intervaly

FieldTypeRequiredDescription
aktivni_tedbooleanyesThe selected interval is running right now.
aktivni_dostring (date-time) | nullyesEnd of the running interval.
dalsi_odstring (date-time) | nullyesStart of the next interval.
intervalyobject[]yes
unix[integer, integer][]yesThe same intervals as [start, end] pairs in Unix seconds (Shelly scripts).

Vyhled

Contains all fields of Hlavicka plus:

FieldTypeRequiredDescription
krok15 | 60yesSlot length in minutes.
rozliseni_predpovedi60yesThe forecast is hourly; with krok=15 the value is repeated for each quarter-hour.
slotySlot[]yes

Ted

Contains all fields of Hlavicka plus:

FieldTypeRequiredDescription
tedSlot | nullyes
cena_tednumber | nullyesCurrent price: end-user price if the API key has a tariff, otherwise spot.
spot_tednumber | nullyesCurrent spot price.
uroven_tedUrovenyes
levno_tedboolean | nullyesCheap or negative hour.
zmena_urovne_vstring (date-time) | nullyesWhen the level changes.
okno_3hOkno | nullyes
nejdrazsi_3hOkno | nullyes
p_zaporna_dnesnumber | nullyesHighest probability of a negative price until the end of the day.
pockatPockat | nullyes
poradi_tedinteger | nullyesv1.1: rank of the current hour within the day by your price, 1 = cheapest.
nintegeryesv1.1: N used for v_n_nejlevnejsich.
v_n_nejlevnejsichboolean | nullyesv1.1: is the current hour among the day's N cheapest hours?
nejlevnejsi_hodinaobjectyesv1.1: cheapest hour of the day for base, peak and offpeak — today and tomorrow (tomorrow if published or forecast). Fields: dnes, zitra.

Okna

Contains all fields of Hlavicka plus:

FieldTypeRequiredDescription
delkaintegeryesWindow length in hours.
dostring (date-time) | nullyesSearch only up to this time (parameter do).
nejlevnejsiOkno[]yes
nejdrazsiOkno[]yes

Rozvrh

Contains all fields of Hlavicka and Intervaly plus:

FieldTypeRequiredDescription
rezim"hodiny_denne" | "nabijeni"yesnabijeni (charging) when kwh is given, otherwise N hours per day.
hodin_vybranointeger (0–…)yes
hodinyobject[]yes

Export

Contains all fields of Hlavicka and Intervaly plus:

FieldTypeRequiredDescription
poplateknumberyesFeed-in buyer fee used.
prahnumberyesFeed-in/export price threshold used.
hodinyobject[]yes

EvccSlot

FieldTypeRequiredDescription
startstring (date-time)yesStart in UTC with Z.
endstring (date-time)yesEnd in UTC with Z.
valuenumberyesPrice for the user (CZK/kWh).

Stav

FieldTypeRequiredDescription
verze"1"yes
betatrueyes
stav"ok" | "stara_data"yes
vydanostring (date-time) | nullyesWhen we released the outlook.
vytvorenostring (date-time)yesWhen the document was created.
dalsi_aktualizacestring (date-time)yesNext scheduled refresh.
stari_mininteger (0–…)yes
znama_dostring (date-time) | nullyesEnd of the last published hour.
predpoved_dostring (date-time)yesEnd of the forecast.

Chyba

FieldTypeRequiredDescription
verze"1"yes
stav"neplatny_klic" | "limit" | "neplatny_parametr" | "nedostupne" | "nenalezeno"yes
chybastringnoError description in Czech.

NejlevnejsiDne

Cheapest hours of the day by your price (end-user price with a tariff, otherwise spot). null = the whole day is not known yet.

Type: object | null

Baterie

Contains all fields of Hlavicka plus:

FieldTypeRequiredDescription
jen_doporucenitrueyesAlways true: a recommendation, not control. The user is responsible for its use.
upozornenistringyesA sentence on what the plan does not know (household consumption, PV production, grid status).
parametryobjectyesParameters used (after filling in defaults); hodin = actual plan length.
akce_ted"nabijet" | "vybijet" | "drzet" | nullyesRecommendation for the current hour.
hodinyobject[]yes
ekonomikaobjectyes Fields: uspora, naklad_nabijeni, hodnota_vybiti, opotrebeni, srovnani, cil_splnen.
The forecast is indicative information, not a guarantee. Your home automation must cope with the API not responding for a while — set a sensible default and watch the age of the data. Details are in the API terms.