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
| Method | Description |
|---|---|
Bearer | Authorization: Bearer its_… — recommended for Home Assistant, Node-RED, evcc and custom code. |
Basic | API 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
- /vyhled.json — 7-day price outlook
- /ted.json — Current price and nearest windows
- /okna.json — Cheapest and most expensive windows
- /loxone.txt — Output for Loxone
- /evcc.json — Custom tariff for evcc
- /schedule.json — Consumption schedule
- /export.json — When to limit grid export
- /baterie.json — Recommended battery plan
- /stav.json — Data status (no API key)
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.
| Parameter | Type | Description |
|---|---|---|
krok | 15 | 60 (default 60) | Slot length in minutes. Quarter-hours only for published prices; the forecast value is repeated. |
hodin | integer (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. |
| Response | Description |
|---|---|
200 | Series of slots. Schema: Vyhled. |
401 | API key missing, malformed, invalid or revoked. |
422 | Unknown parameter or value out of range. |
429 | Limit exceeded: per API key (hour, day), per IP address, or too many invalid API key attempts from a single address. Header Retry-After. |
503 | Temporary outage (data or database). Header Retry-After. |
{
"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.
| Parameter | Type | Description |
|---|---|---|
n | integer (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. |
| Response | Description |
|---|---|
200 | Current status. Schema: Ted. |
401 | API key missing, malformed, invalid or revoked. |
422 | Unknown parameter or value out of range. |
429 | Limit exceeded: per API key (hour, day), per IP address, or too many invalid API key attempts from a single address. Header Retry-After. |
503 | Temporary outage (data or database). Header Retry-After. |
{
"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.
| Parameter | Type | Description |
|---|---|---|
delka | integer (1–12, default 3) | Window length in hours. |
pocet | integer (1–5, default 3) | How many windows to return. |
do | string | Search 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. |
| Response | Description |
|---|---|
200 | Windows. Schema: Okna. |
401 | API key missing, malformed, invalid or revoked. |
422 | Unknown parameter or value out of range. |
429 | Limit exceeded: per API key (hour, day), per IP address, or too many invalid API key attempts from a single address. Header Retry-After. |
503 | Temporary outage (data or database). Header Retry-After. |
{
"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.
| Parameter | Type | Description |
|---|---|---|
n | integer (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. |
| Response | Description |
|---|---|
200 | Text for Virtual HTTP Input. |
401 | API key missing, malformed, invalid or revoked. |
422 | Unknown parameter or value out of range. |
429 | Limit exceeded: per API key (hour, day), per IP address, or too many invalid API key attempts from a single address. Header Retry-After. |
503 | Temporary outage (data or database). Header Retry-After. |
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.
| Parameter | Type | Description |
|---|---|---|
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. |
| Response | Description |
|---|---|
200 | Prices for evcc. Schema: EvccSlot[]. |
401 | API key missing, malformed, invalid or revoked. |
422 | Unknown parameter or value out of range. |
429 | Limit exceeded: per API key (hour, day), per IP address, or too many invalid API key attempts from a single address. Header Retry-After. |
503 | Temporary outage (data or database). Header Retry-After. |
[
{
"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.
| Parameter | Type | Description |
|---|---|---|
hodin | integer (0–24, default 4) | How many cheapest hours to select in each day (default 4, or 0 when pod is given). |
pod | number (-10–50) | Add every hour with a price below this threshold (CZK/kWh, price for the user). |
kwh | number (0.1–500) | Target charging: how many kWh to deliver. Requires kw. |
kw | number (0.1–100) | Charging power in kW (for the kwh parameter). |
do | string | Target charging deadline. ISO 8601; without an offset = local time in Prague. |
ucinnost | number (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. |
| Response | Description |
|---|---|
200 | Schedule. Schema: Rozvrh. |
401 | API key missing, malformed, invalid or revoked. |
422 | Unknown parameter or value out of range. |
429 | Limit exceeded: per API key (hour, day), per IP address, or too many invalid API key attempts from a single address. Header Retry-After. |
503 | Temporary outage (data or database). Header Retry-After. |
{
"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.
| Parameter | Type | Description |
|---|---|---|
poplatek | number (0–10) | Feed-in buyer fee in CZK/kWh. Defaults to the API key's tariff, otherwise 0. |
prah | number (-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. |
| Response | Description |
|---|---|
200 | Grid export limiting. Schema: Export. |
401 | API key missing, malformed, invalid or revoked. |
422 | Unknown parameter or value out of range. |
429 | Limit exceeded: per API key (hour, day), per IP address, or too many invalid API key attempts from a single address. Header Retry-After. |
503 | Temporary outage (data or database). Header Retry-After. |
{
"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.
| Parameter | Type | Description |
|---|---|---|
kapacita | number (0.5–500) | Usable battery capacity in kWh. |
vykon | number (0.1–100) | Charging and discharging power in kW (on the grid and household side). |
soc | number (0–100) | Current state of charge in %. |
soc_min | number (0–99, default 10) | Minimum allowed state of charge in %. |
soc_max | number (1–100, default 100) | Maximum allowed state of charge in %. |
soc_konec | number (0–100) | State of charge the battery should have at the end of the horizon (default = soc, clipped to soc_min–soc_max). |
ucinnost | number (0.5–1, default 0.9) | Round-trip efficiency of the charge and discharge cycle. |
opotrebeni | number (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. |
hodin | integer (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. |
| Response | Description |
|---|---|
200 | Recommended battery plan. Schema: Baterie. |
401 | API key missing, malformed, invalid or revoked. |
422 | Unknown parameter or value out of range. |
429 | Limit exceeded: per API key (hour, day), per IP address, or too many invalid API key attempts from a single address. Header Retry-After. |
503 | Temporary outage (data or database). Header Retry-After. |
{
"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).
| Response | Description |
|---|---|
200 | Status. Schema: Stav. |
429 | Limit exceeded: per API key (hour, day), per IP address, or too many invalid API key attempts from a single address. Header Retry-After. |
503 | Data not available. Header Retry-After. |
{
"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).
| Field | Type | Required | Description |
|---|---|---|---|
verze | "1" | yes | Major API version. |
beta | true | yes | The API is in beta. |
stav | "ok" | "stara_data" | yes | stara_data (stale data) when the data is older than 30 hours. |
vydano | string (date-time) | null | yes | When we released the outlook (ISO 8601 with the Europe/Prague offset). |
vytvoreno | string (date-time) | yes | When the document the response is computed from was created. |
dalsi_aktualizace | string (date-time) | yes | Next scheduled data refresh. An earlier request brings nothing new. |
stari_min | integer (0–…) | yes | Data age in minutes. |
mena | "CZK" | yes | |
jednotka | "Kc/kWh" | yes | |
kurz_eur | number | yes | EUR/CZK exchange rate (Czech National Bank) used to convert market prices. |
uroven_klice | "beta" | "zdarma" | "placeny" | yes | API key tier. zdarma (free) gets the forecast only 48 h beyond the last published hour and without the band. |
strategie | Strategie | yes | |
tarif | object | yes | 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).
| Field | Type | Required | Description |
|---|---|---|---|
od | string (date-time) | yes | Start. |
do | string (date-time) | yes | End. |
zdroj | "trh" | "predpoved" | yes | trh (market) = published day-ahead market price, predpoved (forecast) = our estimate. |
spot | number | yes | Spot price excluding VAT and distribution (CZK/kWh); for the forecast according to the strategy. |
p10 | number | no | Lower edge of the forecast band. Only for the forecast and not on the Free tier. |
p50 | number | no | Middle of the forecast. Only for the forecast and not on the Free tier. |
p90 | number | no | Upper edge of the forecast band. Only for the forecast and not on the Free tier. |
koncova | number | no | End-user price according to the API key's tariff. Only when the API key has a tariff. |
koncova_p10 | number | no | End-user price from p10. Only with a tariff and the band. |
koncova_p90 | number | no | End-user price from p90. Only with a tariff and the band. |
vykup | number | no | Feed-in/export price = spot − feed-in buyer fee. Only when the API key's tariff includes a feed-in fee. |
p_vykup_zaporny | number | null (0–1) | no | Probability of a negative feed-in/export price. Only with a feed-in fee. |
uroven | Uroven | yes | |
poradi_dne | integer | null (1–…) | yes | Rank of the hour within the day by price, 1 = cheapest. |
p_zaporna | number | null (0–1) | yes | Probability 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.
| Field | Type | Required | Description |
|---|---|---|---|
od | string (date-time) | yes | Window start. |
do | string (date-time) | yes | Window end. |
cena | number | yes | Average spot price of the window (CZK/kWh). |
cena_p10 | number | yes | Average p10 of the window's hours. |
cena_p90 | number | yes | Average p90 of the window's hours. |
jistota | "vysoka" | "stredni" | "nizka" | yes | vysoka (high) = all hours published, stredni (medium) = within 3 days, nizka (low) = further out. |
koncova | number | no | Average end-user price. Only when the API key has a tariff. |
za_min | integer (0–…) | yes | Minutes until the window starts (0 = running now). |
Pockat
“Charge now, or wait?” Verbal only during the beta.
| Field | Type | Required | Description |
|---|---|---|---|
beta | true | yes | |
delka | integer | yes | Window length in hours. |
rozdil | number | yes | By how much (CZK/kWh) a later window must be cheaper. |
nejlepsi_znama | object | null | yes | |
levneji_pozdeji | "nizka" | "stredni" | "vysoka" | yes | How likely it is that a window cheaper than the best known one will appear in the coming days. |
Intervaly
| Field | Type | Required | Description |
|---|---|---|---|
aktivni_ted | boolean | yes | The selected interval is running right now. |
aktivni_do | string (date-time) | null | yes | End of the running interval. |
dalsi_od | string (date-time) | null | yes | Start of the next interval. |
intervaly | object[] | yes | |
unix | [integer, integer][] | yes | The same intervals as [start, end] pairs in Unix seconds (Shelly scripts). |
Vyhled
Contains all fields of Hlavicka plus:
| Field | Type | Required | Description |
|---|---|---|---|
krok | 15 | 60 | yes | Slot length in minutes. |
rozliseni_predpovedi | 60 | yes | The forecast is hourly; with krok=15 the value is repeated for each quarter-hour. |
sloty | Slot[] | yes |
Ted
Contains all fields of Hlavicka plus:
| Field | Type | Required | Description |
|---|---|---|---|
ted | Slot | null | yes | |
cena_ted | number | null | yes | Current price: end-user price if the API key has a tariff, otherwise spot. |
spot_ted | number | null | yes | Current spot price. |
uroven_ted | Uroven | yes | |
levno_ted | boolean | null | yes | Cheap or negative hour. |
zmena_urovne_v | string (date-time) | null | yes | When the level changes. |
okno_3h | Okno | null | yes | |
nejdrazsi_3h | Okno | null | yes | |
p_zaporna_dnes | number | null | yes | Highest probability of a negative price until the end of the day. |
pockat | Pockat | null | yes | |
poradi_ted | integer | null | yes | v1.1: rank of the current hour within the day by your price, 1 = cheapest. |
n | integer | yes | v1.1: N used for v_n_nejlevnejsich. |
v_n_nejlevnejsich | boolean | null | yes | v1.1: is the current hour among the day's N cheapest hours? |
nejlevnejsi_hodina | object | yes | v1.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:
| Field | Type | Required | Description |
|---|---|---|---|
delka | integer | yes | Window length in hours. |
do | string (date-time) | null | yes | Search only up to this time (parameter do). |
nejlevnejsi | Okno[] | yes | |
nejdrazsi | Okno[] | yes |
Rozvrh
Contains all fields of Hlavicka and Intervaly plus:
| Field | Type | Required | Description |
|---|---|---|---|
rezim | "hodiny_denne" | "nabijeni" | yes | nabijeni (charging) when kwh is given, otherwise N hours per day. |
hodin_vybrano | integer (0–…) | yes | |
hodiny | object[] | yes |
Export
Contains all fields of Hlavicka and Intervaly plus:
| Field | Type | Required | Description |
|---|---|---|---|
poplatek | number | yes | Feed-in buyer fee used. |
prah | number | yes | Feed-in/export price threshold used. |
hodiny | object[] | yes |
EvccSlot
| Field | Type | Required | Description |
|---|---|---|---|
start | string (date-time) | yes | Start in UTC with Z. |
end | string (date-time) | yes | End in UTC with Z. |
value | number | yes | Price for the user (CZK/kWh). |
Stav
| Field | Type | Required | Description |
|---|---|---|---|
verze | "1" | yes | |
beta | true | yes | |
stav | "ok" | "stara_data" | yes | |
vydano | string (date-time) | null | yes | When we released the outlook. |
vytvoreno | string (date-time) | yes | When the document was created. |
dalsi_aktualizace | string (date-time) | yes | Next scheduled refresh. |
stari_min | integer (0–…) | yes | |
znama_do | string (date-time) | null | yes | End of the last published hour. |
predpoved_do | string (date-time) | yes | End of the forecast. |
Chyba
| Field | Type | Required | Description |
|---|---|---|---|
verze | "1" | yes | |
stav | "neplatny_klic" | "limit" | "neplatny_parametr" | "nedostupne" | "nenalezeno" | yes | |
chyba | string | no | Error 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:
| Field | Type | Required | Description |
|---|---|---|---|
jen_doporuceni | true | yes | Always true: a recommendation, not control. The user is responsible for its use. |
upozorneni | string | yes | A sentence on what the plan does not know (household consumption, PV production, grid status). |
parametry | object | yes | Parameters used (after filling in defaults); hodin = actual plan length. |
akce_ted | "nabijet" | "vybijet" | "drzet" | null | yes | Recommendation for the current hour. |
hodiny | object[] | yes | |
ekonomika | object | yes | Fields: uspora, naklad_nabijeni, hodnota_vybiti, opotrebeni, srovnani, cil_splnen. |