Skip to contents

Returns Bundesbank data for a given flow and key

Usage

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

Arguments

flow

(character(1)) flow to query, 5-8 characters. See bbk_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.table() with the requested data.

See also

Other data: bbk_series(), ecb_data(), snb_data()

Examples

# \donttest{
# fetch all data for a given flow and key
bbk_data("BBSIS", "D.I.ZAR.ZI.EUR.S1311.B.A604.R10XX.R.A.A._Z._Z.A")
#>             date                                                   key value
#>           <Date>                                                <char> <num>
#>    1: 1997-08-07 BBSIS.D.I.ZAR.ZI.EUR.S1311.B.A604.R10XX.R.A.A._Z._Z.A  5.76
#>    2: 1997-08-08 BBSIS.D.I.ZAR.ZI.EUR.S1311.B.A604.R10XX.R.A.A._Z._Z.A  5.76
#>    3: 1997-08-11 BBSIS.D.I.ZAR.ZI.EUR.S1311.B.A604.R10XX.R.A.A._Z._Z.A  5.75
#>    4: 1997-08-12 BBSIS.D.I.ZAR.ZI.EUR.S1311.B.A604.R10XX.R.A.A._Z._Z.A  5.72
#>    5: 1997-08-13 BBSIS.D.I.ZAR.ZI.EUR.S1311.B.A604.R10XX.R.A.A._Z._Z.A  5.77
#>   ---                                                                       
#> 6948: 2024-12-16 BBSIS.D.I.ZAR.ZI.EUR.S1311.B.A604.R10XX.R.A.A._Z._Z.A  2.27
#> 6949: 2024-12-17 BBSIS.D.I.ZAR.ZI.EUR.S1311.B.A604.R10XX.R.A.A._Z._Z.A  2.26
#> 6950: 2024-12-18 BBSIS.D.I.ZAR.ZI.EUR.S1311.B.A604.R10XX.R.A.A._Z._Z.A  2.27
#> 6951: 2024-12-19 BBSIS.D.I.ZAR.ZI.EUR.S1311.B.A604.R10XX.R.A.A._Z._Z.A  2.30
#> 6952: 2024-12-20 BBSIS.D.I.ZAR.ZI.EUR.S1311.B.A604.R10XX.R.A.A._Z._Z.A  2.32
#>                                                                                                                                                                    title
#>                                                                                                                                                                   <char>
#>    1: Yields, derived from the term structure of interest rates, on listed Federal securities with annual coupon payments / residual maturity of 10.0 years / daily data
#>    2: Yields, derived from the term structure of interest rates, on listed Federal securities with annual coupon payments / residual maturity of 10.0 years / daily data
#>    3: Yields, derived from the term structure of interest rates, on listed Federal securities with annual coupon payments / residual maturity of 10.0 years / daily data
#>    4: Yields, derived from the term structure of interest rates, on listed Federal securities with annual coupon payments / residual maturity of 10.0 years / daily data
#>    5: Yields, derived from the term structure of interest rates, on listed Federal securities with annual coupon payments / residual maturity of 10.0 years / daily data
#>   ---                                                                                                                                                                   
#> 6948: Yields, derived from the term structure of interest rates, on listed Federal securities with annual coupon payments / residual maturity of 10.0 years / daily data
#> 6949: Yields, derived from the term structure of interest rates, on listed Federal securities with annual coupon payments / residual maturity of 10.0 years / daily data
#> 6950: Yields, derived from the term structure of interest rates, on listed Federal securities with annual coupon payments / residual maturity of 10.0 years / daily data
#> 6951: Yields, derived from the term structure of interest rates, on listed Federal securities with annual coupon payments / residual maturity of 10.0 years / daily data
#> 6952: Yields, derived from the term structure of interest rates, on listed Federal securities with annual coupon payments / residual maturity of 10.0 years / daily data
#>         freq bearer_reg   item valuation currency issuer_class listed_sub
#>       <char>     <char> <char>    <char>   <char>       <char>     <char>
#>    1:  daily          I    ZAR        ZI      EUR        S1311          B
#>    2:  daily          I    ZAR        ZI      EUR        S1311          B
#>    3:  daily          I    ZAR        ZI      EUR        S1311          B
#>    4:  daily          I    ZAR        ZI      EUR        S1311          B
#>    5:  daily          I    ZAR        ZI      EUR        S1311          B
#>   ---                                                                    
#> 6948:  daily          I    ZAR        ZI      EUR        S1311          B
#> 6949:  daily          I    ZAR        ZI      EUR        S1311          B
#> 6950:  daily          I    ZAR        ZI      EUR        S1311          B
#> 6951:  daily          I    ZAR        ZI      EUR        S1311          B
#> 6952:  daily          I    ZAR        ZI      EUR        S1311          B
#>       security_class maturity interest_type interest_rate redemption
#>               <char>   <char>        <char>        <char>     <char>
#>    1:           A604    R10XX             R             A          A
#>    2:           A604    R10XX             R             A          A
#>    3:           A604    R10XX             R             A          A
#>    4:           A604    R10XX             R             A          A
#>    5:           A604    R10XX             R             A          A
#>   ---                                                               
#> 6948:           A604    R10XX             R             A          A
#> 6949:           A604    R10XX             R             A          A
#> 6950:           A604    R10XX             R             A          A
#> 6951:           A604    R10XX             R             A          A
#> 6952:           A604    R10XX             R             A          A
#>       certificate coverage rating time_format decimals    unit unit_mult
#>            <char>   <char> <char>      <char>    <int>  <char>    <char>
#>    1:          _Z       _Z      A         P1D        2 PROZENT         0
#>    2:          _Z       _Z      A         P1D        2 PROZENT         0
#>    3:          _Z       _Z      A         P1D        2 PROZENT         0
#>    4:          _Z       _Z      A         P1D        2 PROZENT         0
#>    5:          _Z       _Z      A         P1D        2 PROZENT         0
#>   ---                                                                   
#> 6948:          _Z       _Z      A         P1D        2 PROZENT         0
#> 6949:          _Z       _Z      A         P1D        2 PROZENT         0
#> 6950:          _Z       _Z      A         P1D        2 PROZENT         0
#> 6951:          _Z       _Z      A         P1D        2 PROZENT         0
#> 6952:          _Z       _Z      A         P1D        2 PROZENT         0
#>       category unit_eng
#>         <char>   <char>
#>    1:     GKZR  percent
#>    2:     GKZR  percent
#>    3:     GKZR  percent
#>    4:     GKZR  percent
#>    5:     GKZR  percent
#>   ---                  
#> 6948:     GKZR  percent
#> 6949:     GKZR  percent
#> 6950:     GKZR  percent
#> 6951:     GKZR  percent
#> 6952:     GKZR  percent
# fetch data for multiple keys
bbk_data("BBK01", c("TTA032", "TTA010"))
#>             date          key   value
#>           <Date>       <char>   <num>
#>    1: 1998-12-22 BBK01.TTA010       0
#>    2: 1999-01-01 BBK01.TTA010       0
#>    3: 1999-01-08 BBK01.TTA010       0
#>    4: 1999-01-15 BBK01.TTA010       0
#>    5: 1999-01-22 BBK01.TTA010       0
#>   ---                                
#> 5180: 2023-09-29 BBK01.TTA032 2510103
#> 5181: 2023-10-06 BBK01.TTA032 2506613
#> 5182: 2023-10-13 BBK01.TTA032 2504519
#> 5183: 2023-10-20 BBK01.TTA032 2509279
#> 5184: 2023-10-27 BBK01.TTA032 2511960
#>                                                                                                                                                 title
#>                                                                                                                                                <char>
#>    1: Claims on non-euro area residents denominated in Euro / claims arising from the credit facility under ERM II / unadjusted / Deutsche Bundesbank
#>    2: Claims on non-euro area residents denominated in Euro / claims arising from the credit facility under ERM II / unadjusted / Deutsche Bundesbank
#>    3: Claims on non-euro area residents denominated in Euro / claims arising from the credit facility under ERM II / unadjusted / Deutsche Bundesbank
#>    4: Claims on non-euro area residents denominated in Euro / claims arising from the credit facility under ERM II / unadjusted / Deutsche Bundesbank
#>    5: Claims on non-euro area residents denominated in Euro / claims arising from the credit facility under ERM II / unadjusted / Deutsche Bundesbank
#>   ---                                                                                                                                                
#> 5180:                                                                                                 Total assets / unadjusted / Deutsche Bundesbank
#> 5181:                                                                                                 Total assets / unadjusted / Deutsche Bundesbank
#> 5182:                                                                                                 Total assets / unadjusted / Deutsche Bundesbank
#> 5183:                                                                                                 Total assets / unadjusted / Deutsche Bundesbank
#> 5184:                                                                                                 Total assets / unadjusted / Deutsche Bundesbank
#>         freq   dim1 time_format decimals   unit unit_mult
#>       <char> <char>      <char>    <int> <char>    <char>
#>    1:  daily TTA010         P1D        0   EURO         6
#>    2:  daily TTA010         P1D        0   EURO         6
#>    3:  daily TTA010         P1D        0   EURO         6
#>    4:  daily TTA010         P1D        0   EURO         6
#>    5:  daily TTA010         P1D        0   EURO         6
#>   ---                                                    
#> 5180:  daily TTA032         P1D        0   EURO         6
#> 5181:  daily TTA032         P1D        0   EURO         6
#> 5182:  daily TTA032         P1D        0   EURO         6
#> 5183:  daily TTA032         P1D        0   EURO         6
#> 5184:  daily TTA032         P1D        0   EURO         6
# specified period (start date-end date) for daily data
bbk_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"
)
#>            date                                                   key value
#>          <Date>                                                <char> <num>
#>   1: 2020-01-02 BBSIS.D.I.ZAR.ZI.EUR.S1311.B.A604.R10XX.R.A.A._Z._Z.A -0.16
#>   2: 2020-01-03 BBSIS.D.I.ZAR.ZI.EUR.S1311.B.A604.R10XX.R.A.A._Z._Z.A -0.27
#>   3: 2020-01-06 BBSIS.D.I.ZAR.ZI.EUR.S1311.B.A604.R10XX.R.A.A._Z._Z.A -0.27
#>   4: 2020-01-07 BBSIS.D.I.ZAR.ZI.EUR.S1311.B.A604.R10XX.R.A.A._Z._Z.A -0.27
#>   5: 2020-01-08 BBSIS.D.I.ZAR.ZI.EUR.S1311.B.A604.R10XX.R.A.A._Z._Z.A -0.27
#>  ---                                                                       
#> 144: 2020-07-27 BBSIS.D.I.ZAR.ZI.EUR.S1311.B.A604.R10XX.R.A.A._Z._Z.A -0.48
#> 145: 2020-07-28 BBSIS.D.I.ZAR.ZI.EUR.S1311.B.A604.R10XX.R.A.A._Z._Z.A -0.52
#> 146: 2020-07-29 BBSIS.D.I.ZAR.ZI.EUR.S1311.B.A604.R10XX.R.A.A._Z._Z.A -0.53
#> 147: 2020-07-30 BBSIS.D.I.ZAR.ZI.EUR.S1311.B.A604.R10XX.R.A.A._Z._Z.A -0.55
#> 148: 2020-07-31 BBSIS.D.I.ZAR.ZI.EUR.S1311.B.A604.R10XX.R.A.A._Z._Z.A -0.57
#>                                                                                                                                                                   title
#>                                                                                                                                                                  <char>
#>   1: Yields, derived from the term structure of interest rates, on listed Federal securities with annual coupon payments / residual maturity of 10.0 years / daily data
#>   2: Yields, derived from the term structure of interest rates, on listed Federal securities with annual coupon payments / residual maturity of 10.0 years / daily data
#>   3: Yields, derived from the term structure of interest rates, on listed Federal securities with annual coupon payments / residual maturity of 10.0 years / daily data
#>   4: Yields, derived from the term structure of interest rates, on listed Federal securities with annual coupon payments / residual maturity of 10.0 years / daily data
#>   5: Yields, derived from the term structure of interest rates, on listed Federal securities with annual coupon payments / residual maturity of 10.0 years / daily data
#>  ---                                                                                                                                                                   
#> 144: Yields, derived from the term structure of interest rates, on listed Federal securities with annual coupon payments / residual maturity of 10.0 years / daily data
#> 145: Yields, derived from the term structure of interest rates, on listed Federal securities with annual coupon payments / residual maturity of 10.0 years / daily data
#> 146: Yields, derived from the term structure of interest rates, on listed Federal securities with annual coupon payments / residual maturity of 10.0 years / daily data
#> 147: Yields, derived from the term structure of interest rates, on listed Federal securities with annual coupon payments / residual maturity of 10.0 years / daily data
#> 148: Yields, derived from the term structure of interest rates, on listed Federal securities with annual coupon payments / residual maturity of 10.0 years / daily data
#>        freq bearer_reg   item valuation currency issuer_class listed_sub
#>      <char>     <char> <char>    <char>   <char>       <char>     <char>
#>   1:  daily          I    ZAR        ZI      EUR        S1311          B
#>   2:  daily          I    ZAR        ZI      EUR        S1311          B
#>   3:  daily          I    ZAR        ZI      EUR        S1311          B
#>   4:  daily          I    ZAR        ZI      EUR        S1311          B
#>   5:  daily          I    ZAR        ZI      EUR        S1311          B
#>  ---                                                                    
#> 144:  daily          I    ZAR        ZI      EUR        S1311          B
#> 145:  daily          I    ZAR        ZI      EUR        S1311          B
#> 146:  daily          I    ZAR        ZI      EUR        S1311          B
#> 147:  daily          I    ZAR        ZI      EUR        S1311          B
#> 148:  daily          I    ZAR        ZI      EUR        S1311          B
#>      security_class maturity interest_type interest_rate redemption certificate
#>              <char>   <char>        <char>        <char>     <char>      <char>
#>   1:           A604    R10XX             R             A          A          _Z
#>   2:           A604    R10XX             R             A          A          _Z
#>   3:           A604    R10XX             R             A          A          _Z
#>   4:           A604    R10XX             R             A          A          _Z
#>   5:           A604    R10XX             R             A          A          _Z
#>  ---                                                                           
#> 144:           A604    R10XX             R             A          A          _Z
#> 145:           A604    R10XX             R             A          A          _Z
#> 146:           A604    R10XX             R             A          A          _Z
#> 147:           A604    R10XX             R             A          A          _Z
#> 148:           A604    R10XX             R             A          A          _Z
#>      coverage rating time_format decimals    unit unit_mult category unit_eng
#>        <char> <char>      <char>    <int>  <char>    <char>   <char>   <char>
#>   1:       _Z      A         P1D        2 PROZENT         0     GKZR  percent
#>   2:       _Z      A         P1D        2 PROZENT         0     GKZR  percent
#>   3:       _Z      A         P1D        2 PROZENT         0     GKZR  percent
#>   4:       _Z      A         P1D        2 PROZENT         0     GKZR  percent
#>   5:       _Z      A         P1D        2 PROZENT         0     GKZR  percent
#>  ---                                                                         
#> 144:       _Z      A         P1D        2 PROZENT         0     GKZR  percent
#> 145:       _Z      A         P1D        2 PROZENT         0     GKZR  percent
#> 146:       _Z      A         P1D        2 PROZENT         0     GKZR  percent
#> 147:       _Z      A         P1D        2 PROZENT         0     GKZR  percent
#> 148:       _Z      A         P1D        2 PROZENT         0     GKZR  percent
# or only specify the start date
bbk_data(
  "BBSIS", "D.I.ZAR.ZI.EUR.S1311.B.A604.R10XX.R.A.A._Z._Z.A",
  start_period = "2024-04-01"
)
#>            date                                                   key value
#>          <Date>                                                <char> <num>
#>   1: 2024-04-02 BBSIS.D.I.ZAR.ZI.EUR.S1311.B.A604.R10XX.R.A.A._Z._Z.A  2.37
#>   2: 2024-04-03 BBSIS.D.I.ZAR.ZI.EUR.S1311.B.A604.R10XX.R.A.A._Z._Z.A  2.41
#>   3: 2024-04-04 BBSIS.D.I.ZAR.ZI.EUR.S1311.B.A604.R10XX.R.A.A._Z._Z.A  2.39
#>   4: 2024-04-05 BBSIS.D.I.ZAR.ZI.EUR.S1311.B.A604.R10XX.R.A.A._Z._Z.A  2.37
#>   5: 2024-04-08 BBSIS.D.I.ZAR.ZI.EUR.S1311.B.A604.R10XX.R.A.A._Z._Z.A  2.46
#>  ---                                                                       
#> 184: 2024-12-16 BBSIS.D.I.ZAR.ZI.EUR.S1311.B.A604.R10XX.R.A.A._Z._Z.A  2.27
#> 185: 2024-12-17 BBSIS.D.I.ZAR.ZI.EUR.S1311.B.A604.R10XX.R.A.A._Z._Z.A  2.26
#> 186: 2024-12-18 BBSIS.D.I.ZAR.ZI.EUR.S1311.B.A604.R10XX.R.A.A._Z._Z.A  2.27
#> 187: 2024-12-19 BBSIS.D.I.ZAR.ZI.EUR.S1311.B.A604.R10XX.R.A.A._Z._Z.A  2.30
#> 188: 2024-12-20 BBSIS.D.I.ZAR.ZI.EUR.S1311.B.A604.R10XX.R.A.A._Z._Z.A  2.32
#>                                                                                                                                                                   title
#>                                                                                                                                                                  <char>
#>   1: Yields, derived from the term structure of interest rates, on listed Federal securities with annual coupon payments / residual maturity of 10.0 years / daily data
#>   2: Yields, derived from the term structure of interest rates, on listed Federal securities with annual coupon payments / residual maturity of 10.0 years / daily data
#>   3: Yields, derived from the term structure of interest rates, on listed Federal securities with annual coupon payments / residual maturity of 10.0 years / daily data
#>   4: Yields, derived from the term structure of interest rates, on listed Federal securities with annual coupon payments / residual maturity of 10.0 years / daily data
#>   5: Yields, derived from the term structure of interest rates, on listed Federal securities with annual coupon payments / residual maturity of 10.0 years / daily data
#>  ---                                                                                                                                                                   
#> 184: Yields, derived from the term structure of interest rates, on listed Federal securities with annual coupon payments / residual maturity of 10.0 years / daily data
#> 185: Yields, derived from the term structure of interest rates, on listed Federal securities with annual coupon payments / residual maturity of 10.0 years / daily data
#> 186: Yields, derived from the term structure of interest rates, on listed Federal securities with annual coupon payments / residual maturity of 10.0 years / daily data
#> 187: Yields, derived from the term structure of interest rates, on listed Federal securities with annual coupon payments / residual maturity of 10.0 years / daily data
#> 188: Yields, derived from the term structure of interest rates, on listed Federal securities with annual coupon payments / residual maturity of 10.0 years / daily data
#>        freq bearer_reg   item valuation currency issuer_class listed_sub
#>      <char>     <char> <char>    <char>   <char>       <char>     <char>
#>   1:  daily          I    ZAR        ZI      EUR        S1311          B
#>   2:  daily          I    ZAR        ZI      EUR        S1311          B
#>   3:  daily          I    ZAR        ZI      EUR        S1311          B
#>   4:  daily          I    ZAR        ZI      EUR        S1311          B
#>   5:  daily          I    ZAR        ZI      EUR        S1311          B
#>  ---                                                                    
#> 184:  daily          I    ZAR        ZI      EUR        S1311          B
#> 185:  daily          I    ZAR        ZI      EUR        S1311          B
#> 186:  daily          I    ZAR        ZI      EUR        S1311          B
#> 187:  daily          I    ZAR        ZI      EUR        S1311          B
#> 188:  daily          I    ZAR        ZI      EUR        S1311          B
#>      security_class maturity interest_type interest_rate redemption certificate
#>              <char>   <char>        <char>        <char>     <char>      <char>
#>   1:           A604    R10XX             R             A          A          _Z
#>   2:           A604    R10XX             R             A          A          _Z
#>   3:           A604    R10XX             R             A          A          _Z
#>   4:           A604    R10XX             R             A          A          _Z
#>   5:           A604    R10XX             R             A          A          _Z
#>  ---                                                                           
#> 184:           A604    R10XX             R             A          A          _Z
#> 185:           A604    R10XX             R             A          A          _Z
#> 186:           A604    R10XX             R             A          A          _Z
#> 187:           A604    R10XX             R             A          A          _Z
#> 188:           A604    R10XX             R             A          A          _Z
#>      coverage rating time_format decimals    unit unit_mult category unit_eng
#>        <char> <char>      <char>    <int>  <char>    <char>   <char>   <char>
#>   1:       _Z      A         P1D        2 PROZENT         0     GKZR  percent
#>   2:       _Z      A         P1D        2 PROZENT         0     GKZR  percent
#>   3:       _Z      A         P1D        2 PROZENT         0     GKZR  percent
#>   4:       _Z      A         P1D        2 PROZENT         0     GKZR  percent
#>   5:       _Z      A         P1D        2 PROZENT         0     GKZR  percent
#>  ---                                                                         
#> 184:       _Z      A         P1D        2 PROZENT         0     GKZR  percent
#> 185:       _Z      A         P1D        2 PROZENT         0     GKZR  percent
#> 186:       _Z      A         P1D        2 PROZENT         0     GKZR  percent
#> 187:       _Z      A         P1D        2 PROZENT         0     GKZR  percent
#> 188:       _Z      A         P1D        2 PROZENT         0     GKZR  percent
# }