Dokumentace API

curl https://api.spotovky.cz/v2/prices/today

mosquitto_sub -h spotovky.cz -t "v2/current/json"

{
  "version": 2,
  "date": "2026-10-25",          // den dodávky (Europe/Prague)
  "resolution": "PT15M",         // 15minutové intervaly
  "complete": true,              // den má všechny intervaly (92 / 96 / 100)
  "negative": false,             // den obsahuje zápornou cenu
  "rate": 24.335,                // kurz EUR/CZK (ČNB, jak ho používá OTE)
  "slots": [
    { "start": "2026-10-25T02:00:00+02:00", "czk": 4.07, "eur": 167.25, "rank": 12 },
    // … letní čas končí ve 3:00, hodina 02:00–02:59 se opakuje v zimním čase:
    { "start": "2026-10-25T02:00:00+01:00", "czk": 3.95, "eur": 162.32, "rank": 9 }
    // … celkem 92, 96 nebo 100 intervalů
  ]
}

{
  "version": 2,
  "month": "2026-10",
  "days": [
    {
      "date": "2026-10-09",
      "periods": 96,
      "complete": true,
      "avg": 2.38,
      "min": -0.11,
      "max": 5.04,
      "min_start": "2026-10-09T23:45:00+02:00",
      "max_start": "2026-10-09T10:00:00+02:00",
      "negative_periods": 1,
      "avg_eur": 97.87
    },
    …
  ]
}

{
  "version": 2,
  "date": "2026-10-23",
  "valid_from": "2026-01-01",
  "valid_to": null,
  "vat_included": false,
  "source": { "name": "ERÚ, cenové rozhodnutí — ceny distribuce NN", "url": "https://eru.gov.cz/…/ceny-nn260.xlsx", … },
  "regulated": {
    "system_services": { "value": 164.24, "unit": "Kč/MWh" },
    "poze":            { "value": 8.32,   "unit": "Kč/A/měsíc" },
    "poze_cap":        { "value": 495,    "unit": "Kč/MWh" },
    "non_grid":        { "value": 12.87,  "unit": "Kč/měsíc" }
  },
  "distributors": {
    "cez": {
      "name": "ČEZ Distribuce",
      "rates": {
        "D57d": {
          "category": "D",
          "title": "Dvoutarifová sazba pro vytápění topným elektrickým spotřebičem …",
          "two_tariff": true,
          "energy_czk_mwh": { "VT": 754.77, "NT": 116.5 },
          "fixed": [
            { "kind": "band", "phases": 3, "from_a": 0, "to_a": 10, "czk_month": 222, "label": "jistič do 3x10 A a do 1x25 A včetně" },
            …
            { "kind": "per_amp", "phases": 3, "from_a": 160, "to_a": null, "czk_month": 122.49, "label": "jistič nad 3x160 A za každou 1A" }
          ]
        }
      }
    }
  }
}

{
  "status": "ok",
  "time": "2026-10-23T14:20:00+02:00",
  "checks": {
    "today":    { "ok": true, "periods": 96, "expected": 96 },
    "tomorrow": { "ok": true, "periods": 100, "due": true },
    "fetch":    { "ok": true, "last_success_min_ago": 5, "last_error": null },
    "publish":  { "ok": true, "last_min_ago": 5, "last_error": null }
  }
}

# mosquitto_sub
mosquitto_sub -h spotovky.cz -p 1883 -t "v2/today/json"

# Python (paho-mqtt)
import paho.mqtt.client as mqtt
client = mqtt.Client(mqtt.CallbackAPIVersion.VERSION2)
client.connect("spotovky.cz", 1883)
client.subscribe("v2/current/json")

{
  "version": 2,
  "start": "2026-10-23T14:15:00+02:00",   // začátek intervalu
  "end": "2026-10-23T14:30:00+02:00",     // konec intervalu
  "czk": 1.82,                            // Kč/kWh bez DPH
  "eur": 74.79,                           // EUR/MWh
  "rank": 12,                             // pořadí v rámci dne
  "periods": 96                           // počet intervalů dne
}

// v2/current/bin — 16 bytů, little-endian
if (len < 16 || data[0] != 2) return;   // verze formátu 2

uint64_t start;
int16_t  halere;            // se znaménkem — záporné ceny
uint16_t rate_x1000;

memcpy(&start,      data + 2,  8);
memcpy(&halere,     data + 10, 2);
uint8_t rank    = data[12];
memcpy(&rate_x1000, data + 13, 2);
uint8_t periods = data[15];

bool  negative_day = data[1] & 0x02;
float czk     = halere     / 100.0f;
float eur_czk = rate_x1000 / 1000.0f;

Serial.printf("%.2f Kč/kWh, pořadí %d/%d, kurz %.3f\n", czk, rank, periods, eur_czk);

import struct, datetime, zoneinfo

def decode_day_v2(data: bytes):
    version, flags, midnight, rate_x1000, n = struct.unpack_from("<BBQHB", data, 0)
    assert version == 2
    prices = struct.unpack_from(f"<{n}h", data, 13)          # h = int16 se znaménkem
    ranks  = struct.unpack_from(f"<{n}B", data, 13 + n * 2)

    tz = zoneinfo.ZoneInfo("Europe/Prague")
    for i, (halere, rank) in enumerate(zip(prices, ranks)):
        if halere == -32768:
            continue                                   # cena chybí
        dt = datetime.datetime.fromtimestamp(midnight + i * 900, tz)
        print(f"{dt:%H:%M}  {halere / 100:6.2f} Kč/kWh  rank {rank}/{n}")

{
  "date": "2026-03-13",       // datum (Europe/Prague)
  "rate": 24.43,              // kurz EUR/CZK z ČNB
  "slots": [
    {
      "t":    "00:00",           // začátek intervalu (SEČ/SELČ)
      "czk":  2.60,             // cena v Kč/kWh (zaokrouhleno na 2 des. místa)
      "rank": 55               // pořadí od nejlevnější (1 = nejlevnější)
    },
    {
      "t":    "00:15",
      "czk":  2.31,
      "rank": 52
    },
    // ... celkem 92, 96 nebo 100 slotů (viz sekce Letní/zimní čas)
  ]
}

// current/bin — 13 bytů
uint64_t timestamp;
uint16_t halere, rate_x100;
uint8_t  rank;

memcpy(&timestamp,  data + 0,  8);
memcpy(&halere,     data + 8,  2);
rank = data[10];
memcpy(&rate_x100,  data + 11, 2);

float czk     = halere    / 100.0f;
float eur_czk = rate_x100 / 100.0f;

Serial.printf("%.2f Kč/kWh, rank %d, kurz %.2f\n", czk, rank, eur_czk);

import struct, datetime, zoneinfo

def decode_day_bin(data: bytes):
    midnight, rate_x100, n = struct.unpack_from("<QHB", data, 0)
    prices = struct.unpack_from(f"<{n}H", data, 11)
    ranks  = struct.unpack_from(f"<{n}B", data, 11 + n * 2)

    eur_czk = rate_x100 / 100
    tz = zoneinfo.ZoneInfo("Europe/Prague")

    for i, (halere, rank) in enumerate(zip(prices, ranks)):
        slot_ts = midnight + i * 900
        dt = datetime.datetime.fromtimestamp(slot_ts, tz)
        czk = halere / 100
        print(f"{dt:%H:%M}  {czk:.2f} Kč/kWh  rank {rank}/{n}")