Introduction
01/31/2001 — 03/31/2024Released MonthlyLast Updated 04/04/2024
The Average Interest Rates on U.S. Treasury Securities dataset provides average interest rates on U.S. Treasury securities on a monthly basis. Its primary purpose is to show the average interest rate on a variety of marketable and non-marketable Treasury securities. Marketable securities consist of Treasury Bills, Notes, Bonds, Treasury Inflation-Protected Securities (TIPS), Floating Rate Notes (FRNs), and Federal Financing Bank (FFB) securities. Non-marketable securities consist of Domestic Series, Foreign Series, State and Local Government Series (SLGS), U.S. Savings Securities, and Government Account Series (GAS) securities. Marketable securities are negotiable and transferable and may be sold on the secondary market. Non-marketable securities are not negotiable or transferrable and are not sold on the secondary market. This is a useful dataset for investors and bond holders to compare how interest rates on Treasury securities have changed over time.
Preview
Data Table:
N/A
Date Range:
Dataset Properties
Data Table Name | Field Name | Display Name | Description | Data Type | Is Required |
|---|---|---|---|---|---|
| Average Interest Rates on U.S. Treasury Securities | record_date | Record Date | The date that data was published. | DATE | 1 |
| Average Interest Rates on U.S. Treasury Securities | security_type_desc | Security Type Description | Indicates whether a security type is marketable or nonmarketable. Marketable Debt includes Treasury Bills, Notes, Bonds, Floating Rate Notes, and Inflation-Protected Securities where ownership can be transferred from one person or entity to another. They can also be traded on the secondary market. Nonmarketable securities include Savings Bonds, Government Account Series, State and Local Government Series, Domestic Series and Foreign Series securities where legal ownership cannot be transferred. | STRING | 1 |
| Average Interest Rates on U.S. Treasury Securities | security_desc | Security Description | The type of debt instrument issued to raise money needed to operate the federal government and pay off maturing obligations. | STRING | 1 |
| Average Interest Rates on U.S. Treasury Securities | avg_interest_rate_amt | Average Interest Rate Amount | Average Interest Rates are a calculated percentage based on the aggregate interest payments divided by the total debt. In this table the Total Marketable, Total Nonmarketable, and Total Interest-bearing Debt rates do not include the Treasury Inflation-Indexed Securities and the Treasury Floating Rate Notes. | PERCENTAGE | |
| Average Interest Rates on U.S. Treasury Securities | src_line_nbr | Source Line Number | Indicates the row of the corresponding table where a data point can be found. This can assist in structuring the data in a similar format to the published report and in understanding potential hierarchies within the table. | INTEGER | 1 |
Showing 1 - 5
rows
of
rows
| Table Name | Description | Row Description | Row Count |
|---|
| Name | Definition |
|---|
Notes & Known Limitations
Average interest rates are calculated based on the total unmatured interest-bearing debt. The average interest rates for total marketable, total non-marketable, and total interest-bearing debt do not include Treasury Inflation-Protected Securities (TIPS) or Treasury Floating Rate Notes (FRNs).
API Quick Guide
Check out our more detailed API Documentation.
Endpoint
BASE URL:
https://api.fiscaldata.treasury.gov/services/api/fiscal_service/
ENDPOINT:
FULL URL:
https://api.fiscaldata.treasury.gov/services/api/fiscal_service/
Fields
Refer to Dataset Properties above for a data dictionary with field names and descriptions, as well as notes and known limitations. known limitations.
| Field Name | Display Name | Data Type |
|---|
Showing 1 - 5 rows of 11 rows
Data Types
All data is returned as a string, including nulls. Refer to the chart above for the intended data type of each field.
Parameters
Refer to Dataset Properties above for a data dictionary with field names and descriptions as well as notes and known limitations
Fields
toggle contents
- Parameter:
fields= - Definition: The fields parameter allows you to select which field(s) should be included in the response.
- Accepts: The
fields=parameter accepts a comma-separated list of field names (no parentheses). - Required: No, specifying fields is not required to make an API request.
- Default: If desired fields are not specified, all fields will be returned.
- Notes: When a field named passed to the
fields=parameter is not available for the endpoint accessed, an error will occur. Note that omitting fields can result in automatically aggregated and summed data results. For more information, view the full documentation on Aggregation and Sums.
EXAMPLE
?fields=
Filters
toggle contents
Sorting
toggle contents
Format
toggle contents
Pagination
toggle contents
Methods
Our APIs accept the GET method, one of the most common HTTP methods.
Example Request & Response
In this example, we are...
- Specifying the endpoint
- Requesting the JSON response format
- Sorting the data by
in descending order - Setting pagination parameters
EXAMPLE REQUEST
https://api.fiscaldata.treasury.gov/services/api/fiscal_service/undefined?sort=-undefined&format=json&page[number]=1&page[size]=1
EXPECTED RESPONSE
Loading...
For More API Information
Visit our full API documentation to find out more about:
- Aggregation and sums
- Pivoting
- Response codes
- Meta object
- ...and more!
