TapHome

CNB CZK Árfolyamok

Packet Parser → HTTP
Beküldő
Utoljára frissítve: 03. 2026

A Cseh Nemzeti Bank (ČNB) naponta közzéteszi a hivatalos CZK árfolyamokat 30 külföldi devizára. Ezek az árfolyamok a cseh pénzügyi rendszerben referenciaként használt hivatalos fixing árfolyamok.

A TapHome sablon mind a 30 árfolyamot lekérdezi a nyilvános CNB REST API-ról (api.cnb.cz) HTTP Packet Parser segítségével. Minden deviza külön csak olvasható szenzorként jelenik meg, amely az aktuális CZK árfolyamot mutatja. Az API teljesen nyilvános — nincs szükség hitelesítésre, API kulcsra vagy regisztrációra. Az árfolyamok óránként frissülnek.

Konfiguráció

A sablon HTTPS-en (443-as port) keresztül csatlakozik az api.cnb.cz-hez. Nem szükséges IP-cím, hitelesítő adat vagy API kulcs — a végpont teljesen nyilvános kormányzati API.

Nincsenek felhasználó által konfigurálható változók. Az egyetlen egyéni változó (responsejson) egy belső HTTP válasz gyorsítótár, amelyet a sablon szkriptek használnak — nem kell módosítani.

Működés

A modul óránként egyszer (3 600 000 ms lekérdezési intervallum) küld egy HTTP GET kérést:

1

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

A válasz egy JSON objektum, amely tartalmazza a rates[] tömböt mind a 30 devizabejegyzéssel. Minden bejegyzés tartalmazza a devizakódot, az ország nevét, a mennyiséget és az árfolyamot. A modul a teljes JSON választ a responsejson változóban tárolja.

Minden deviza eszköz ezután a gyorsítótárazott válaszból elemzi ki a saját árfolyamát a PARSEJSON(responsejson, "$.rates[N].rate") segítségével, ahol N az adott deviza fix tömbindexe. Az eszköz lekérdezési intervalluma 15 másodperc, de mivel minden eszköz a gyorsítótárazott responsejson-ból olvas, az óránkénti frissítések között nem történnek további API hívások.

A sablon lang=CZ paramétert használ az API kérésben. Ez kritikus, mert a rates[] tömb a kiválasztott nyelven az ország neve szerint van betűrendben rendezve. A lang=EN-re váltás eltérő rendezést eredményezne, és az összes tömbindex-hozzárendelést elrontaná.

Eszközfunkciók

A sablon 30 csak olvasható szenzor eszközt biztosít, egyet minden devizához. Minden érték CZK-ban van.

Fő devizák

A leggyakrabban követett árfolyamok: EUR (euró), USD (amerikai dollár), GBP (brit font), CHF (svájci frank) és PLN (lengyel zloty). Ezek 1 egység külföldi devizára vonatkoznak — például egy 21,315-ös USD árfolyam azt jelenti, hogy 1 USD = 21,315 CZK.

Többegységes devizák

Nyolc deviza többegységes árfolyamot használ az alacsony egységenkénti CZK értékük miatt:

DevizaMennyiségJelentés
HUF (magyar forint)100Árfolyam 100 HUF-ra
INR (indiai rúpia)100Árfolyam 100 INR-ra
ISK (izlandi korona)100Árfolyam 100 ISK-ra
JPY (japán jen)100Árfolyam 100 JPY-ra
KRW (dél-koreai von)100Árfolyam 100 KRW-ra
PHP (Fülöp-szigeteki peso)100Árfolyam 100 PHP-ra
THB (thai baht)100Árfolyam 100 THB-ra
TRY (török líra)100Árfolyam 100 TRY-ra
IDR (indonéz rúpia)1000Árfolyam 1000 IDR-ra

A sablon az API-ból a nyers rate értéket olvassa be, az amount-tal való osztás nélkül. Például egy 13,328-as JPY árfolyam a TapHome-ban azt jelenti, hogy 100 JPY = 13,328 CZK, nem 1 JPY = 13,328 CZK.

Teljes devizalista

Mind a 30 deviza: 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 (IMF Különleges Lehívási Jogok), ZAR.

Automatizálási példák

Értesítés árfolyam-küszöbnél

Használj deviza szenzort egy okos szabály feltételeként, hogy értesítést kapj, amikor egy árfolyam átlép egy küszöbértéket:

  • Feltétel: EUR érték 25,00 fölé emelkedik
  • Művelet: Push értesítés küldése
Árfolyam alapú kapcsolás

Indíts műveleteket árfolyammozgások alapján — például kapcsolj kijelző indikátorokat vagy vezérelj kimeneteket, amikor egy figyelt deviza eléri a célzott tartományt.

Hibaelhárítás

Minden eszköz nullát vagy semmilyen adatot nem mutat
  1. Ellenőrizd a TapHome Core internetkapcsolatát — a sablon kimenő HTTPS hozzáférést igényel az api.cnb.cz-hez
  2. Ellenőrizd, hogy az API válaszol — nyisd meg a https://api.cnb.cz/cnbapi/exrates/daily?date=2026-03-28&lang=CZ címet böngészőben
  3. Az új árfolyamokat minden munkanapon körülbelül 14:30 CET-kor teszik közzé. Hétvégén és ünnepnapokon az API az utolsó érvényes árfolyamokat adja vissza
Egyes devizák értékei helytelennek tűnnek

Nézd meg a fenti többegységes árfolyamok táblázatát. Az olyan devizák, mint a JPY, HUF, KRW és IDR, 100 vagy 1000 egységre vannak jegyezve, nem 1 egységre. Ez a standard ČNB konvenció, nem sablonhiba.

Az adatok nem frissülnek

A sablon óránként kérdezi le az API-t. Ha az árfolyamok elavultnak tűnnek, ellenőrizd, hogy a TapHome Core rendelkezik-e internet-hozzáféréssel, és hogy a CNB API elérhető-e. Az API-nak nincsenek dokumentált kéréslimitjei, de tartós kapcsolati problémák megakadályozzák a frissítéseket.

Elérhető eszközök

CNB CZK Árfolyamok Modul
Egyéni változók

Kurzy ČNB

Olvasás (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
Ausztrál dollár (AUD) Változó Csak olvasható
string Egység: CZK json_path

Ausztrál dollár (AUD)

Olvasás
PARSEJSON(responsejson, "$.rates[0].rate");
Brazil real (BRL) Változó Csak olvasható
string Egység: CZK json_path

Brazil real (BRL)

Olvasás
PARSEJSON(responsejson, "$.rates[1].rate");
Kanadai dollár (CAD) Változó Csak olvasható
string Egység: CZK json_path

Kanadai dollár (CAD)

Olvasás
PARSEJSON(responsejson, "$.rates[13].rate");
Kínai jüan (CNY) Változó Csak olvasható
string Egység: CZK json_path

Kínai jüan (CNY)

Olvasás
PARSEJSON(responsejson, "$.rates[2].rate");
Dán korona (DKK) Változó Csak olvasható
string Egység: CZK json_path

Dán korona (DKK)

Olvasás
PARSEJSON(responsejson, "$.rates[3].rate");
Euró (EUR) Változó Csak olvasható
string Egység: CZK json_path

Euró (EUR)

Olvasás
PARSEJSON(responsejson, "$.rates[4].rate");
Brit font (GBP) Változó Csak olvasható
string Egység: CZK json_path

Brit font (GBP)

Olvasás
PARSEJSON(responsejson, "$.rates[29].rate");
Hongkongi dollár (HKD) Változó Csak olvasható
string Egység: CZK json_path

Hongkongi dollár (HKD)

Olvasás
PARSEJSON(responsejson, "$.rates[6].rate");
Magyar forint (HUF) Változó Csak olvasható

Árfolyam 100 HUF-ra

string Egység: CZK json_path

Magyar forint (HUF)

Olvasás
PARSEJSON(responsejson, "$.rates[15].rate");
Svájci frank (CHF) Változó Csak olvasható
string Egység: CZK json_path

Svájci frank (CHF)

Olvasás
PARSEJSON(responsejson, "$.rates[25].rate");
Indonéz rúpia (IDR) Változó Csak olvasható

Árfolyam 1000 IDR-ra

string Egység: CZK json_path

Indonéz rúpia (IDR)

Olvasás
PARSEJSON(responsejson, "$.rates[8].rate");
Izraeli sékel (ILS) Változó Csak olvasható
string Egység: CZK json_path

Izraeli sékel (ILS)

Olvasás
PARSEJSON(responsejson, "$.rates[10].rate");
Indiai rúpia (INR) Változó Csak olvasható

Árfolyam 100 INR-ra

string Egység: CZK json_path

Indiai rúpia (INR)

Olvasás
PARSEJSON(responsejson, "$.rates[7].rate");
Izlandi korona (ISK) Változó Csak olvasható

Árfolyam 100 ISK-ra

string Egység: CZK json_path

Izlandi korona (ISK)

Olvasás
PARSEJSON(responsejson, "$.rates[9].rate");
Japán jen (JPY) Változó Csak olvasható

Árfolyam 100 JPY-ra

string Egység: CZK json_path

Japán jen (JPY)

Olvasás
PARSEJSON(responsejson, "$.rates[11].rate");
Dél-koreai von (KRW) Változó Csak olvasható

Árfolyam 100 KRW-ra

string Egység: CZK json_path

Dél-koreai von (KRW)

Olvasás
PARSEJSON(responsejson, "$.rates[14].rate");
Mexikói peso (MXN) Változó Csak olvasható
string Egység: CZK json_path

Mexikói peso (MXN)

Olvasás
PARSEJSON(responsejson, "$.rates[17].rate");
Malajziai ringgit (MYR) Változó Csak olvasható
string Egység: CZK json_path

Malajziai ringgit (MYR)

Olvasás
PARSEJSON(responsejson, "$.rates[16].rate");
Norvég korona (NOK) Változó Csak olvasható
string Egység: CZK json_path

Norvég korona (NOK)

Olvasás
PARSEJSON(responsejson, "$.rates[19].rate");
Új-zélandi dollár (NZD) Változó Csak olvasható
string Egység: CZK json_path

Új-zélandi dollár (NZD)

Olvasás
PARSEJSON(responsejson, "$.rates[20].rate");
Fülöp-szigeteki peso (PHP) Változó Csak olvasható

Árfolyam 100 PHP-ra

string Egység: CZK json_path

Fülöp-szigeteki peso (PHP)

Olvasás
PARSEJSON(responsejson, "$.rates[5].rate");
Lengyel zloty (PLN) Változó Csak olvasható
string Egység: CZK json_path

Lengyel zloty (PLN)

Olvasás
PARSEJSON(responsejson, "$.rates[21].rate");
Román lej (RON) Változó Csak olvasható
string Egység: CZK json_path

Román lej (RON)

Olvasás
PARSEJSON(responsejson, "$.rates[22].rate");
Svéd korona (SEK) Változó Csak olvasható
string Egység: CZK json_path

Svéd korona (SEK)

Olvasás
PARSEJSON(responsejson, "$.rates[24].rate");
Szingapúri dollár (SGD) Változó Csak olvasható
string Egység: CZK json_path

Szingapúri dollár (SGD)

Olvasás
PARSEJSON(responsejson, "$.rates[23].rate");
Thai baht (THB) Változó Csak olvasható

Árfolyam 100 THB-ra

string Egység: CZK json_path

Thai baht (THB)

Olvasás
PARSEJSON(responsejson, "$.rates[26].rate");
Török líra (TRY) Változó Csak olvasható

Árfolyam 100 TRY-ra

string Egység: CZK json_path

Török líra (TRY)

Olvasás
PARSEJSON(responsejson, "$.rates[27].rate");
Amerikai dollár (USD) Változó Csak olvasható
string Egység: CZK json_path

Amerikai dollár (USD)

Olvasás
PARSEJSON(responsejson, "$.rates[28].rate");
IMF SDR (XDR) Változó Csak olvasható

IMF Különleges Lehívási Jogok — összetett tartalékeszköz

string Egység: CZK json_path

IMF SDR (XDR)

Olvasás
PARSEJSON(responsejson, "$.rates[18].rate");
Dél-afrikai rand (ZAR) Változó Csak olvasható
string Egység: CZK json_path

Dél-afrikai rand (ZAR)

Olvasás
PARSEJSON(responsejson, "$.rates[12].rate");
Kapcsolat: Packet Parser → HTTP

Források

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