Fetch Czech National Bank (CNB) exchange rates

Retrieve the central bank exchange rate fixing (Czech koruna against foreign currencies) from the CNB API.

Usage

cnb_fx_rates(date = NULL, year = NULL, lang = "EN")

Source

https://api.cnb.cz/cnbapi/swagger-ui.html

Arguments

date

(NULL | character(1) | Date(1))
The date to query, returning rates for all currencies on that day. If NULL, the latest available fixing is returned. Mutually exclusive with year. Default NULL.

year

(NULL | integer(1))
A calendar year, returning rates for all currencies on every working day of that year. Mutually exclusive with date. Default NULL.

lang

(character(1))
Language for the country and currency names, either "EN" or "CZ". Default "EN".

Value

A data.table::data.table() with the requested exchange rates. The rate is the amount of Czech koruna per amount units of the foreign currency.

See also

Other data: bbk_data(), bbk_series(), bde_data(), bde_latest(), bdf_codelist(), bdf_data(), bdf_dataset(), bdp_data(), bis_data(), boc_data(), boe_data(), boj_data(), cnb_data(), cnb_pribor(), ecb_data(), nbp_fx_rates(), nbp_gold(), nob_data(), onb_data(), snb_data(), srb_cross_rates(), srb_data()

Examples

# \donttest{
# latest fixing for all currencies
cnb_fx_rates()
#>           date currency_code   currency        country amount   rate
#>         <Date>        <char>     <char>         <char>  <int>  <num>
#>  1: 2026-05-29           AUD     dollar      Australia      1 14.958
#>  2: 2026-05-29           BRL       real         Brazil      1  4.132
#>  3: 2026-05-29           CAD     dollar         Canada      1 15.107
#>  4: 2026-05-29           CNY   renminbi          China      1  3.081
#>  5: 2026-05-29           DKK      krone        Denmark      1  3.250
#>  6: 2026-05-29           EUR       euro            EMU      1 24.285
#>  7: 2026-05-29           HKD     dollar       Hongkong      1  2.661
#>  8: 2026-05-29           HUF     forint        Hungary    100  6.864
#>  9: 2026-05-29           ISK      krona        Iceland    100 16.935
#> 10: 2026-05-29           XDR        SDR            IMF      1 28.496
#> 11: 2026-05-29           INR      rupee          India    100 21.947
#> 12: 2026-05-29           IDR     rupiah      Indonesia   1000  1.167
#> 13: 2026-05-29           ILS new shekel         Israel      1  7.426
#> 14: 2026-05-29           JPY        yen          Japan    100 13.092
#> 15: 2026-05-29           MYR    ringgit       Malaysia      1  5.259
#> 16: 2026-05-29           MXN       peso         Mexico      1  1.202
#> 17: 2026-05-29           NZD     dollar    New Zealand      1 12.460
#> 18: 2026-05-29           NOK      krone         Norway      1  2.254
#> 19: 2026-05-29           PHP       peso    Philippines    100 33.865
#> 20: 2026-05-29           PLN      zloty         Poland      1  5.744
#> 21: 2026-05-29           RON        leu        Romania      1  4.623
#> 22: 2026-05-29           SGD     dollar      Singapore      1 16.329
#> 23: 2026-05-29           ZAR       rand   South Africa      1  1.285
#> 24: 2026-05-29           KRW        won    South Korea    100  1.384
#> 25: 2026-05-29           SEK      krona         Sweden      1  2.254
#> 26: 2026-05-29           CHF      franc    Switzerland      1 26.667
#> 27: 2026-05-29           THB       baht       Thailand    100 64.116
#> 28: 2026-05-29           TRY       lira         Turkey    100 45.441
#> 29: 2026-05-29           GBP      pound United Kingdom      1 28.000
#> 30: 2026-05-29           USD     dollar            USA      1 20.851
#>           date currency_code   currency        country amount   rate
#>         <Date>        <char>     <char>         <char>  <int>  <num>

# all fixings for a given year
cnb_fx_rates(year = 2024L)
#>             date currency_code amount   rate
#>           <Date>        <char>  <int>  <num>
#>    1: 2024-01-02           AUD      1 15.278
#>    2: 2024-01-02           BGN      1 12.621
#>    3: 2024-01-02           BRL      1  4.609
#>    4: 2024-01-02           CAD      1 16.938
#>    5: 2024-01-02           CHF      1 26.524
#>   ---                                       
#> 7808: 2024-12-31           THB    100 70.618
#> 7809: 2024-12-31           TRY    100 68.539
#> 7810: 2024-12-31           USD      1 24.237
#> 7811: 2024-12-31           XDR      1 31.609
#> 7812: 2024-12-31           ZAR      1  1.284
# }