An official website of the U.S. government
Treasury Securities Upcoming Auctions Data
Introduction
03/08/2024 — 05/02/2024Released As NeededLast Updated 04/26/2024The Treasury Securities Upcoming Auctions Data dataset provides information on auction announcements. Each announcement includes what securities are being auctioned, the announcement date, the auction date and issue date. This data provides a notification of what Treasury Marketable securities will be announced and or auctioned in the upcoming week.
Preview
Dataset Properties
Data Table Name | Field Name | Display Name | Description | Data Type | Is Required |
|---|---|---|---|---|---|
| Treasury Securities Upcoming Auctions | record_date | Record Date | The date that data was published. | DATE | 1 |
| Treasury Securities Upcoming Auctions | security_type | Security Type | The kind of marketable security that is being announced/auctioned. This is determined by the length to maturity. | STRING | 1 |
| Treasury Securities Upcoming Auctions | security_term | Security Term | The term of the security. | STRING | 1 |
| Treasury Securities Upcoming Auctions | reopening | Reopening | When additional amounts of previously issued securities are issued again rather than selling new issues of those securities. The reopened securities have the same maturity date and interest rate; however, as compared to the original securities, the reopened securities have a different issue date (which creates a shorter overall term), and usually, a different purchase price. | STRING | 1 |
| Treasury Securities Upcoming Auctions | cusip | CUSIP | A unique nine-character combination assigned to the security being announced/auctioned. They are provided by the CUSIP (Committee on Uniform Securities Identification Procedures) Service Bureau, which is operated by Standard & Poors for the American Bankers Association. | STRING | 1 |
Showing 1 - 5 rows of rows
| Table Name | Description | Row Description | Row Count |
|---|
| Name | Definition |
|---|
Notes & Known Limitations
There are no notes or known limitations for this dataset.
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 9 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 limitationsFields
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]=1EXPECTED 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!
Related Datasets
© 2020 Data Transparency