TapHome

CNB CZK Výmenné kurzy

Packet Parser → HTTP
Pridal
Posledná aktualizácia: 03. 2026

Česká národná banka (ČNB) publikuje oficiálne výmenné kurzy CZK denne pre 30 zahraničných mien. Tieto kurzy sú oficiálne fixingové kurzy používané ako referencia v celom českom finančnom systéme.

Šablóna TapHome načítava všetkých 30 výmenných kurzov z verejného REST API ČNB (api.cnb.cz) cez HTTP Packet Parser. Každá mena je vystavená ako samostatný senzor na čítanie, ktorý zobrazuje aktuálny kurz CZK. API je úplne verejné — nevyžaduje autentifikáciu, API kľúč ani registráciu. Kurzy sa aktualizujú každú hodinu.

Konfigurácia

Šablóna sa pripája k api.cnb.cz cez HTTPS (port 443). Nie je potrebná žiadna IP adresa, prihlasovacie údaje ani API kľúč — koncový bod je plne verejné štátne API.

Neexistujú žiadne používateľsky konfigurovateľné premenné. Jediná vlastná premenná (responsejson) je interná vyrovnávacia pamäť HTTP odpovede používaná skriptmi šablóny — nie je potrebné ju upravovať.

Ako to funguje

Modul odosiela jeden HTTP GET požiadavok raz za hodinu (interval dotazovania 3 600 000 ms):

1

GET /cnbapi/exrates/daily?date={today}&lang=CZ

Odpoveď je objekt JSON obsahujúci pole rates[] so všetkými 30 položkami mien. Každá položka obsahuje kód meny, názov krajiny, množstvo a kurz. Modul uloží celú JSON odpoveď do premennej responsejson.

Každé zariadenie meny potom analyzuje svoj kurz z uloženej odpovede pomocou PARSEJSON(responsejson, "$.rates[N].rate"), kde N je fixný index poľa pre danú menu. Interval dotazovania zariadenia je 15 sekúnd, ale keďže všetky zariadenia čítajú z uloženej responsejson, medzi hodinovými obnoveniami sa nevykonávajú žiadne ďalšie volania API.

Šablóna používa lang=CZ v požiadavke na API. Je to kritické, pretože pole rates[] je zoradené abecedne podľa názvu krajiny vo vybranom jazyku. Zmena na lang=EN by vytvorila iné poradie a narušila všetky mapovania indexov poľa.

Schopnosti zariadení

Šablóna poskytuje 30 senzorov na čítanie, jeden pre každú menu. Všetky hodnoty sú v CZK.

Hlavné meny

Najčastejšie sledované kurzy zahŕňajú EUR (Euro), USD (Americký dolár), GBP (Britská libra), CHF (Švajčiarsky frank) a PLN (Poľský zlotý). Tieto sú kotované za 1 jednotku cudzej meny — napríklad kurz USD 21,315 znamená 1 USD = 21,315 CZK.

Meny s viacnásobnou jednotkou

Osem mien používa kurzy za viacnásobné jednotky kvôli nízkej hodnote za jednotku CZK:

MenaMnožstvoVýznam
HUF (Maďarský forint)100Kurz za 100 HUF
INR (Indická rupia)100Kurz za 100 INR
ISK (Islandská koruna)100Kurz za 100 ISK
JPY (Japonský jen)100Kurz za 100 JPY
KRW (Juhokórejský won)100Kurz za 100 KRW
PHP (Filipínske peso)100Kurz za 100 PHP
THB (Thajský baht)100Kurz za 100 THB
TRY (Turecká líra)100Kurz za 100 TRY
IDR (Indonézska rupia)1000Kurz za 1000 IDR

Šablóna číta surovú hodnotu rate z API bez delenia hodnotou amount. Napríklad kurz JPY 13,328 v TapHome znamená 100 JPY = 13,328 CZK, nie 1 JPY = 13,328 CZK.

Kompletný zoznam mien

Všetkých 30 mien: AUD, BRL, CAD, CHF, CNY, DKK, EUR, GBP, HKD, HUF, IDR, ILS, INR, ISK, JPY, KRW, MXN, MYR, NOK, NZD, PHP, PLN, RON, SEK, SGD, THB, TRY, USD, XDR (Zvláštne práva čerpania MMF), ZAR.

Príklady automatizácie

Upozornenie pri prekročení prahu kurzu

Použite senzor meny v podmienke smart rule na prijímanie upozornení, keď kurz prekročí prah:

  • Podmienka: Hodnota EUR prekročí 25,00
  • Akcia: Odoslať push notifikáciu
Prepínanie na základe kurzu

Spustite akcie na základe pohybov výmenných kurzov — napríklad prepnite indikátory displeja alebo ovládajte výstupy, keď sledovaná mena dosiahne cieľový rozsah.

Riešenie problémov

Všetky zariadenia zobrazujú nulu alebo žiadne dáta
  1. Skontrolujte internetové pripojenie TapHome Core — šablóna vyžaduje odchádzajúci prístup HTTPS na api.cnb.cz
  2. Overte, že API odpovedá — otvorte https://api.cnb.cz/cnbapi/exrates/daily?date=2026-03-28&lang=CZ v prehliadači
  3. Nové výmenné kurzy sa publikujú každý pracovný deň okolo 14:30 CET. Počas víkendov a sviatkov API vracia posledné platné kurzy
Hodnoty sa zdajú nesprávne pre niektoré meny

Skontrolujte tabuľku kurzov s viacnásobnou jednotkou vyššie. Meny ako JPY, HUF, KRW a IDR sú kotované za 100 alebo 1000 jednotiek, nie za 1 jednotku. Toto je štandardná konvencia ČNB, nie chyba šablóny.

Dáta sa prestanú aktualizovať

Šablóna dotazuje API raz za hodinu. Ak sa kurzy zdajú zastarané, overte, že TapHome Core má prístup na internet a že API ČNB je dostupné. API nemá zdokumentované limity požiadaviek, ale dlhodobé problémy s pripojením zabránia aktualizáciám.

Dostupné zariadenia

CNB CZK Výmenné kurzy Modul
Vlastné premenné

Kurzy ČNB

Čítanie (modul)
VAR today := tostring(NOW(), "yyyy-MM-dd");
VAR response := SENDHTTPREQUEST("/cnbapi/exrates/daily?date=" + today + "&lang=CZ");
IF response.IsSuccess
    responsejson := response.Content;
ELSE
    ADDERROR(response.StatusCode + " (" + response.ReasonPhrase + ")");
END
Austrálsky dolár (AUD) Premenná Len na čítanie
string Jednotka: CZK json_path

Austrálsky dolár (AUD)

Čítanie
PARSEJSON(responsejson, "$.rates[0].rate");
Brazílsky real (BRL) Premenná Len na čítanie
string Jednotka: CZK json_path

Brazílsky real (BRL)

Čítanie
PARSEJSON(responsejson, "$.rates[1].rate");
Kanadský dolár (CAD) Premenná Len na čítanie
string Jednotka: CZK json_path

Kanadský dolár (CAD)

Čítanie
PARSEJSON(responsejson, "$.rates[13].rate");
Čínsky jüan (CNY) Premenná Len na čítanie
string Jednotka: CZK json_path

Čínsky jüan (CNY)

Čítanie
PARSEJSON(responsejson, "$.rates[2].rate");
Dánska koruna (DKK) Premenná Len na čítanie
string Jednotka: CZK json_path

Dánska koruna (DKK)

Čítanie
PARSEJSON(responsejson, "$.rates[3].rate");
Euro (EUR) Premenná Len na čítanie
string Jednotka: CZK json_path

Euro (EUR)

Čítanie
PARSEJSON(responsejson, "$.rates[4].rate");
Britská libra (GBP) Premenná Len na čítanie
string Jednotka: CZK json_path

Britská libra (GBP)

Čítanie
PARSEJSON(responsejson, "$.rates[29].rate");
Hongkonský dolár (HKD) Premenná Len na čítanie
string Jednotka: CZK json_path

Hongkonský dolár (HKD)

Čítanie
PARSEJSON(responsejson, "$.rates[6].rate");
Maďarský forint (HUF) Premenná Len na čítanie

Kurz za 100 HUF

string Jednotka: CZK json_path

Maďarský forint (HUF)

Čítanie
PARSEJSON(responsejson, "$.rates[15].rate");
Švajčiarsky frank (CHF) Premenná Len na čítanie
string Jednotka: CZK json_path

Švajčiarsky frank (CHF)

Čítanie
PARSEJSON(responsejson, "$.rates[25].rate");
Indonézska rupia (IDR) Premenná Len na čítanie

Kurz za 1000 IDR

string Jednotka: CZK json_path

Indonézska rupia (IDR)

Čítanie
PARSEJSON(responsejson, "$.rates[8].rate");
Izraelský šekel (ILS) Premenná Len na čítanie
string Jednotka: CZK json_path

Izraelský šekel (ILS)

Čítanie
PARSEJSON(responsejson, "$.rates[10].rate");
Indická rupia (INR) Premenná Len na čítanie

Kurz za 100 INR

string Jednotka: CZK json_path

Indická rupia (INR)

Čítanie
PARSEJSON(responsejson, "$.rates[7].rate");
Islandská koruna (ISK) Premenná Len na čítanie

Kurz za 100 ISK

string Jednotka: CZK json_path

Islandská koruna (ISK)

Čítanie
PARSEJSON(responsejson, "$.rates[9].rate");
Japonský jen (JPY) Premenná Len na čítanie

Kurz za 100 JPY

string Jednotka: CZK json_path

Japonský jen (JPY)

Čítanie
PARSEJSON(responsejson, "$.rates[11].rate");
Juhokórejský won (KRW) Premenná Len na čítanie

Kurz za 100 KRW

string Jednotka: CZK json_path

Juhokórejský won (KRW)

Čítanie
PARSEJSON(responsejson, "$.rates[14].rate");
Mexické peso (MXN) Premenná Len na čítanie
string Jednotka: CZK json_path

Mexické peso (MXN)

Čítanie
PARSEJSON(responsejson, "$.rates[17].rate");
Malajzijský ringgit (MYR) Premenná Len na čítanie
string Jednotka: CZK json_path

Malajzijský ringgit (MYR)

Čítanie
PARSEJSON(responsejson, "$.rates[16].rate");
Nórska koruna (NOK) Premenná Len na čítanie
string Jednotka: CZK json_path

Nórska koruna (NOK)

Čítanie
PARSEJSON(responsejson, "$.rates[19].rate");
Novozélandský dolár (NZD) Premenná Len na čítanie
string Jednotka: CZK json_path

Novozélandský dolár (NZD)

Čítanie
PARSEJSON(responsejson, "$.rates[20].rate");
Filipínske peso (PHP) Premenná Len na čítanie

Kurz za 100 PHP

string Jednotka: CZK json_path

Filipínske peso (PHP)

Čítanie
PARSEJSON(responsejson, "$.rates[5].rate");
Poľský zlotý (PLN) Premenná Len na čítanie
string Jednotka: CZK json_path

Poľský zlotý (PLN)

Čítanie
PARSEJSON(responsejson, "$.rates[21].rate");
Rumunský leu (RON) Premenná Len na čítanie
string Jednotka: CZK json_path

Rumunský leu (RON)

Čítanie
PARSEJSON(responsejson, "$.rates[22].rate");
Švédska koruna (SEK) Premenná Len na čítanie
string Jednotka: CZK json_path

Švédska koruna (SEK)

Čítanie
PARSEJSON(responsejson, "$.rates[24].rate");
Singapurský dolár (SGD) Premenná Len na čítanie
string Jednotka: CZK json_path

Singapurský dolár (SGD)

Čítanie
PARSEJSON(responsejson, "$.rates[23].rate");
Thajský baht (THB) Premenná Len na čítanie

Kurz za 100 THB

string Jednotka: CZK json_path

Thajský baht (THB)

Čítanie
PARSEJSON(responsejson, "$.rates[26].rate");
Turecká líra (TRY) Premenná Len na čítanie

Kurz za 100 TRY

string Jednotka: CZK json_path

Turecká líra (TRY)

Čítanie
PARSEJSON(responsejson, "$.rates[27].rate");
Americký dolár (USD) Premenná Len na čítanie
string Jednotka: CZK json_path

Americký dolár (USD)

Čítanie
PARSEJSON(responsejson, "$.rates[28].rate");
MMF SDR (XDR) Premenná Len na čítanie

Zvláštne práva čerpania MMF — kompozitné rezervné aktívum

string Jednotka: CZK json_path

MMF SDR (XDR)

Čítanie
PARSEJSON(responsejson, "$.rates[18].rate");
Juhoafrický rand (ZAR) Premenná Len na čítanie
string Jednotka: CZK json_path

Juhoafrický rand (ZAR)

Čítanie
PARSEJSON(responsejson, "$.rates[12].rate");
Pripojenie: Packet Parser → HTTP

Zdroje

  • CNB API — OpenAPI Specification
    api.cnb.cz 2026-03-28
  • CNB Exchange Rate Format & Currency List
    www.cnb.cz 2026-03-28