Developer Notice - XML changes

Subscribe to Developer Notice updates

 

Changes are tentatively planned for January 28, 2022

Notice to those with APIs and/or services that consume the Treasury Interest Rate Statistics XML data: Treasury will be implementing changes to URLS for the XML data feeds, the XSD files, and the XML files in January 2022. Our tentative launch date for these changes is after close-of-business, Friday January 28. We will continue to update this Developer Notice. When we implement these changes, we will continue to publish to the old XML URLs as well as the new XML URLs, in parallel for a to-be-determined period to enable customers to make necessary adjustments.

 

Redirects

As part of the January 28 activities we will be implementing redirects on the table pages for all 5 interest rate data sets.

At the end of the period when we are making updates to both the new XML feeds and the old XML feeds in parallel , we will redirect the old XML urls to the new ones.

 

Here are some additional items we want you to be aware about January 28 changes.

value m:null

Data.treasury.gov XML shows an empty tag to represent an empty value with an attribute m:null = true, whereas the new structure does not have a tag when a corresponding value is not available. Please make sure your application/code checks if element is defined and value is set. If the tag is not shown, that means no data available for that time period.
Example of an empty element (data.treasury.gov): <d:BOND_MKT_UNAVAIL_REASON m:null="true" />
In the new structure we are not displaying the XML element when the value is null.

 

Long Term Rate IDs

In the current data.treasury.gov XML, the self-reference links for the Long Term rate links to each rate type (BC_20year, Over_10_Years, Real_Rate) ID. The new data structure uses the same three rate type IDs. However, the self-reference link URLs will return null values for the individual rate data.

 

Real Long Term IDs

The self-referencing URLs in the ID tag at data.treasury.gov have a date time stamp (QUOTE DATE=datetime'2021-01-05T00%3A00%3A00',RATE=-0.47D). These self-referencing URLs in the Real Long Term ID XML do not work on data.treasury.gov. This date time stamp will be changed to use an ID in the new structure to reference data for each date.

 

If you have comments or concerns, please notify us at the Feedback link at the bottom of this page.