Skip to contents

Daily treasury bill rates

Source: R/interest-rate.R
tr_bill_rates.Rd

These rates are the daily secondary market quotations on the most recently auctioned Treasury Bills for each maturity tranche (4-week, 8-week, 13-week, 17-week, 26-week, and 52-week) for which Treasury currently issues new bills.

Usage

tr_bill_rates(date = NULL)

Source

https://home.treasury.gov/treasury-daily-interest-rate-xml-feed

Arguments

date

character(1) or numeric(1) date in format yyyy or yyyymm. If NULL, all data is returned. Default NULL.

Value

A data.frame() containing the rates or NULL when no entries were found.

Details

Market quotations are obtained at approximately 3:30 PM each business day by the Federal Reserve Bank of New York. The Bank Discount rate is the rate at which a bill is quoted in the secondary market and is based on the par value, amount of the discount and a 360-day year. The Coupon Equivalent, also called the Bond Equivalent, or the Investment Yield, is the bill's yield based on the purchase price, discount, and a 365- or 366-day year. The Coupon Equivalent can be used to compare the yield on a discount bill to the yield on a nominal coupon security that pays semiannual interest with the same maturity date.

See also

Other interest rate: tr_long_term_rate(), tr_real_long_term(), tr_real_yield_curve(), tr_yield_curve()

Examples

# \donttest{
# get data for a single month
tr_bill_rates("202201")
#> # A tibble: 200 × 4
#>    date       type  maturity value
#>    <date>     <chr> <chr>    <dbl>
#>  1 2022-01-03 close 4 weeks   0.05
#>  2 2022-01-03 yield 4 weeks   0.05
#>  3 2022-01-03 close 8 weeks   0.06
#>  4 2022-01-03 yield 8 weeks   0.06
#>  5 2022-01-03 close 13 weeks  0.09
#>  6 2022-01-03 yield 13 weeks  0.09
#>  7 2022-01-03 close 26 weeks  0.22
#>  8 2022-01-03 yield 26 weeks  0.22
#>  9 2022-01-03 close 52 weeks  0.39
#> 10 2022-01-03 yield 52 weeks  0.4 
#> # ℹ 190 more rows
# or for the entire year
tr_bill_rates(2022)
#> # A tibble: 2,590 × 4
#>    date       type  maturity value
#>    <date>     <chr> <chr>    <dbl>
#>  1 2022-01-03 close 4 weeks   0.05
#>  2 2022-01-03 yield 4 weeks   0.05
#>  3 2022-01-03 close 8 weeks   0.06
#>  4 2022-01-03 yield 8 weeks   0.06
#>  5 2022-01-03 close 13 weeks  0.09
#>  6 2022-01-03 yield 13 weeks  0.09
#>  7 2022-01-03 close 26 weeks  0.22
#>  8 2022-01-03 yield 26 weeks  0.22
#>  9 2022-01-03 close 52 weeks  0.39
#> 10 2022-01-03 yield 52 weeks  0.4 
#> # ℹ 2,580 more rows
# }