Retrieve time series data from the Bank of Japan Statistics API.
Arguments
- db
(
character(1))
The database code to query (e.g.,"FM08"for foreign exchange rates). See the API manual for available databases.- code
(
character())
One or more series codes to query (e.g.,"FXERD01"for USD/JPY spot rate). Maximum 250 codes per request. All codes must have the same frequency. Useboj_metadata()to find available codes.- start_date
(
NULL|character(1)|integer(1))
Start date of the data. Format depends on frequency:"YYYYMM"for daily, weekly, and monthly data,"YYYYQQ"for quarterly (where QQ is 01-04), and"YYYY"for annual. IfNULL, all available data is returned. DefaultNULL.- end_date
(
NULL|character(1)|integer(1))
End date of the data, in the same format as start_date. IfNULL, data up to the latest available date is returned. DefaultNULL.- lang
(
character(1))
Language for series names, either"en"or"jp". Default"en".
Value
A data.table::data.table() with the requested data.
See also
Other data:
banxico_data(),
bbk_data(),
bbk_series(),
bcb_data(),
bcb_expectations(),
bcb_fx_rates(),
bcb_inflation(),
bcb_selic(),
bcb_top5(),
bde_data(),
bde_latest(),
bdf_codelist(),
bdf_data(),
bdf_dataset(),
bdp_data(),
bis_data(),
boc_data(),
boe_data(),
boi_data(),
cnb_czeonia(),
cnb_data(),
cnb_fx_other_rates(),
cnb_fx_rates(),
cnb_pribor(),
ecb_data(),
nbp_fx_rates(),
nbp_gold(),
nob_data(),
onb_data(),
snb_data(),
srb_cross_rates(),
srb_data()
Examples
# \donttest{
# fetch USD/JPY exchange rate
boj_data("FM08", "FXERD01", start_date = "202401")
#> date key value freq
#> <Date> <char> <num> <char>
#> 1: 2024-01-04 FXERD01 142.98 daily
#> 2: 2024-01-05 FXERD01 144.77 daily
#> 3: 2024-01-09 FXERD01 144.22 daily
#> 4: 2024-01-10 FXERD01 144.43 daily
#> 5: 2024-01-11 FXERD01 145.73 daily
#> ---
#> 642: 2026-08-20 FXERD01 158.26 daily
#> 643: 2026-08-21 FXERD01 158.88 daily
#> 644: 2026-08-24 FXERD01 158.87 daily
#> 645: 2026-08-25 FXERD01 159.13 daily
#> 646: 2026-08-26 FXERD01 159.22 daily
#> name unit
#> <char> <char>
#> 1: US.Dollar/Yen Spot Rate at 9:00 in JST, Tokyo Market Yen per U.S. Dollar
#> 2: US.Dollar/Yen Spot Rate at 9:00 in JST, Tokyo Market Yen per U.S. Dollar
#> 3: US.Dollar/Yen Spot Rate at 9:00 in JST, Tokyo Market Yen per U.S. Dollar
#> 4: US.Dollar/Yen Spot Rate at 9:00 in JST, Tokyo Market Yen per U.S. Dollar
#> 5: US.Dollar/Yen Spot Rate at 9:00 in JST, Tokyo Market Yen per U.S. Dollar
#> ---
#> 642: US.Dollar/Yen Spot Rate at 9:00 in JST, Tokyo Market Yen per U.S. Dollar
#> 643: US.Dollar/Yen Spot Rate at 9:00 in JST, Tokyo Market Yen per U.S. Dollar
#> 644: US.Dollar/Yen Spot Rate at 9:00 in JST, Tokyo Market Yen per U.S. Dollar
#> 645: US.Dollar/Yen Spot Rate at 9:00 in JST, Tokyo Market Yen per U.S. Dollar
#> 646: US.Dollar/Yen Spot Rate at 9:00 in JST, Tokyo Market Yen per U.S. Dollar
# fetch multiple exchange rates
boj_data("FM08", c("FXERD01", "FXERD02"), start_date = "202401")
#> date key value freq
#> <Date> <char> <num> <char>
#> 1: 2024-01-04 FXERD01 142.98 daily
#> 2: 2024-01-05 FXERD01 144.77 daily
#> 3: 2024-01-09 FXERD01 144.22 daily
#> 4: 2024-01-10 FXERD01 144.43 daily
#> 5: 2024-01-11 FXERD01 145.73 daily
#> ---
#> 1288: 2026-08-20 FXERD02 158.72 daily
#> 1289: 2026-08-21 FXERD02 159.12 daily
#> 1290: 2026-08-24 FXERD02 159.18 daily
#> 1291: 2026-08-25 FXERD02 159.45 daily
#> 1292: 2026-08-26 FXERD02 159.26 daily
#> name unit
#> <char> <char>
#> 1: US.Dollar/Yen Spot Rate at 9:00 in JST, Tokyo Market Yen per U.S. Dollar
#> 2: US.Dollar/Yen Spot Rate at 9:00 in JST, Tokyo Market Yen per U.S. Dollar
#> 3: US.Dollar/Yen Spot Rate at 9:00 in JST, Tokyo Market Yen per U.S. Dollar
#> 4: US.Dollar/Yen Spot Rate at 9:00 in JST, Tokyo Market Yen per U.S. Dollar
#> 5: US.Dollar/Yen Spot Rate at 9:00 in JST, Tokyo Market Yen per U.S. Dollar
#> ---
#> 1288: US.Dollar/Yen Highest, Tokyo Market Yen per U.S. Dollar
#> 1289: US.Dollar/Yen Highest, Tokyo Market Yen per U.S. Dollar
#> 1290: US.Dollar/Yen Highest, Tokyo Market Yen per U.S. Dollar
#> 1291: US.Dollar/Yen Highest, Tokyo Market Yen per U.S. Dollar
#> 1292: US.Dollar/Yen Highest, Tokyo Market Yen per U.S. Dollar
# }