U.S. Department of the Treasury

GETTING STARTED

The Treasury Daily Interest Rate Feed provides daily interest rate data in Extensible Markup Language (XML). Our data feed accepts GET requests, returns XML responses, and uses standard HTTP response codes.

For more information about the updates to XML feeds, please see the developer notice on XML data feeds.

DATA FEED URL STRUCTURE

For simplicity and consistency, data feed URLs are formatted with all lower-case characters. Underscores are used as word separators.

The components that make up a full data feed request are below.

BaseURL + Endpoint + Parameters

BASE URL:

https://home.treasury.gov

ENDPOINT:

/resource-center/data-chart-center/interest-rates/pages/xml

PARAMETERS EXAMPLE:

?data=daily_treasury_yield_curve&field_tdr_date_value=2022

FULL REQUEST EXAMPLE:

https://home.treasury.gov/resource-center/data-chart-center/interest-rates/pages/xml?data=daily_treasury_bill_rates&field_tdr_date_value=2022

DATA FEED INDEX

AVAILABLE PARAMETERS

First parameter must be a data key and value; the second parameter is a time-period key and value.

1. Data

   KEY = data
   VALUE:
   • daily_treasury_yield_curve
   • daily_treasury_bill_rates
   • daily_treasury_long_term_rate
   • daily_treasury_real_yield_curve
   • daily_treasury_real_long_term
2. Time period - must include the time-period as a second parameter with one of these two options:
   1. field_tdr_date_value to get data for specific year or for all year  

      KEY = field_tdr_date_value
      VALUE: 

      • yyyy

        Example:
        https://home.treasury.gov/resource-center/data-chart-center/interest-rates/pages/xml?data=[value]&field_tdr_date_value=[yyyy]

        https://home.treasury.gov/resource-center/data-chart-center/interest-rates/pages/xml?data=daily_treasury_yield_curve&field_tdr_date_value=2022

      • all
        KEY = page
        VALUE = xxx (number)

         

        Example:

        https://home.treasury.gov/resource-center/data-chart-center/interest-rates/pages/xml?data=[value]&field_tdr_date_value=[all]&page =[xxx]

        https://home.treasury.gov/resource-center/data-chart-center/interest-rates/pages/xml?data=daily_treasury_yield_curve&field_tdr_date_value=all&page=24

        An XML feed is available for retrieving all records, which you can use with pagination to return all data for a given interest rate type for “all” time periods. You can use the value “all” and a page number to retrieve the data. 
        
        Pagination (only available for the time period of "all")

        The data feed pagination uses a zero-based index, meaning that the pagination begins on page 0. If you call pagination, you must start at page zero (page=0) and make the increment. The first 300 rows or page zero (page=0) will return by default if you do not request pagination.

        To loop through all pages, increments page number by one until there is no data inside the "<entry>" tag. Looping through years is possible by using the start year in the data below to loop through years to obtain a record of a specific time or for all time.
         

        Data Availability
         

        Interest Rate Type	Available From
        Daily Treasury Par Yield Curve Rates	1990
        Daily Treasury Bill Rates	2002
        Daily Treasury Long-Term Rates	2000
        Daily Treasury Par Real Yield Curve Rates	2003
        Daily Treasury Real Long-Term Rates	2000

         

      • field_tdr_date_value_month to get data for a given month

        KEY = field_tdr_date_value_month
        VALUE: 
        •    yyyymm

        Example:
        https://home.treasury.gov/resource-center/data-chart-center/interest-rates/pages/xml?data=[value]&field_tdr_date_value_month=[yyyymm]

        https://home.treasury.gov/resource-center/data-chart-center/interest-rates/pages/xml?data=daily_treasury_yield_curve&field_tdr_date_value_month=202204

DATA MODEL

The data in this feed using the OData Entity Data Model (EDM) datatypes. For more information, visit https://www.odata.org/documentation/odata-version-2-0/overview.

DAILY TREASURY RATES XML DATA STRUCTURE

1) DAILY TREASURY PAR YIELD CURVE RATES

2) DAILY TREASURY BILL RATES

3) DAILY TREASURY LONG-TERM RATES

4) DAILY TREASURY REAL PAR YIELD CURVE RATES

5) DAILY TREASURY REAL LONG-TERM RATES