Treasury Securities Auctions Data
Introduction
11/15/1979 — 05/02/2024Released As NeededLast Updated 04/28/2024Preview
Dataset Properties
Data Table Name | Field Name | Display Name | Description | Data Type | Is Required |
|---|---|---|---|---|---|
| Treasury Securities Auctions Data | record_date | Record Date | The date that data was published. | DATE | 1 |
| Treasury Securities Auctions Data | 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 |
| Treasury Securities Auctions Data | 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 Auctions Data | security_term | Security Term | The term of the security. | STRING | 1 |
| Treasury Securities Auctions Data | auction_date | Auction Date | This is the date on which the auction of the security being announced/auctioned is held. | DATE | 1 |
| Table Name | Description | Row Description | Row Count |
|---|
| Name | Definition |
|---|
Notes & Known Limitations
Overview of the Auction Process:
Treasury sells marketable securities (bills, notes, bonds, FRNs, and TIPS) through regular public auctions, by which the rate, yield, or discount margin of these securities are determined.
The process begins several days before the scheduled auction when the Treasury announces the details of the upcoming issue, including the amount to be auctioned and the maturity date. When you participate in an auction, you have two bidding options – competitive and noncompetitive. TreasuryDirect allows noncompetitive bidding only. Noncompetitive bidding is limited to purchases of $5 million per auction. Bidding limits apply cumulatively to all methods (TreasuryDirect, banks, and brokers) that are used for bidding in a single auction.With a competitive bid, you specify the rate, yield, or discount margin you will accept.With a noncompetitive bid, you agree to accept the high rate, yield, or discount margin set at auction.
At the close of an auction, Treasury accepts all noncompetitive bids that comply with the auction rules, and then accepts competitive bids in ascending order in terms of their rates, yields, or discount margins (lowest to highest) until the quantity of accepted bids reaches the offering amount. All bidders, noncompetitive and competitive, will receive the same rate, yield, or spread as the highest accepted bid.
API Quick Guide
https://api.fiscaldata.treasury.gov/services/api/fiscal_service/https://api.fiscaldata.treasury.gov/services/api/fiscal_service/| Field Name | Display Name | Data Type |
|---|
- 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.
?fields=- Specifying the endpoint
- Requesting the JSON response format
- Sorting the data by
in descending order - Setting pagination parameters
https://api.fiscaldata.treasury.gov/services/api/fiscal_service/undefined?sort=-undefined&format=json&page[number]=1&page[size]=1Loading...For More API Information
- Aggregation and sums
- Pivoting
- Response codes
- Meta object
- ...and more!
