bb_data {bbk}

Returns data for a given flow and key

Description

Returns data for a given flow and key

Usage

bb_data(
  flow,
  key,
  start_period = NULL,
  end_period = NULL,
  first_n = NULL,
  last_n = NULL
)

Arguments

flow

character(1) flow to query, 5-8 characters. See bb_metadata() for available dataflows.

key

character(1) key to query.

start_period

character(1) start date of the data. Supported formats:

• YYYY for annual data (e.g., "2019")

• YYYY-S[1-2] for semi-annual data (e.g., "2019-S1")

• YYYY-Q[1-4] for quarterly data (e.g., "2019-Q1")

• YYYY-MM for monthly data (e.g., "2019-01")

• YYYY-W[01-53] for weekly data (e.g., "2019-W01")

• YYYY-MM-DD for daily and business data (e.g., "2019-01-01") If NULL, no start date restriction is applied (data retrieved from the earliest available date). Default NULL.

end_period

character(1) end date of the data, in the same format as start_period. If NULL, no end date restriction is applied (data retrieved up to the most recent available date). Default NULL.

first_n

numeric(1) number of observations to retrieve from the start of the series. If NULL, no restriction is applied. Default NULL.

last_n

numeric(1) number of observations to retrieve from the end of the series. If NULL, no restriction is applied. Default NULL.

Value

A data.frame() with the requested data. The columns are:

date

The date of the observation

value

The value of the observation

key

The time series key

title

The title of the dataflow

frequency

The frequency of the observation

category

The category of the observation

unit

The unit of the observation

unit_multiplier

The unit multiplier of the observation

References

https://www.bundesbank.de/en/statistics/time-series-databases/help-for-sdmx-web-service/web-service-interface-data

See Also

Other data: bb_series()

Examples

# fetch all data for a given flow and key
bb_data("BBSIS", "D.I.ZAR.ZI.EUR.S1311.B.A604.R10XX.R.A.A._Z._Z.A")

# specified period (start date-end date) for daily data
bb_data(
  "BBSIS", "D.I.ZAR.ZI.EUR.S1311.B.A604.R10XX.R.A.A._Z._Z.A",
  start_period = "2020-01-01",
  end_period = "2020-08-01"
)
# or only specify the start date
bb_data(
  "BBSIS", "D.I.ZAR.ZI.EUR.S1311.B.A604.R10XX.R.A.A._Z._Z.A",
  start_period = "2020-01-01"
)