What it returns
Every US Treasury auction from TreasuryDirect: bills, notes, bonds, TIPS, FRNs and cash management bills. Each auction: CUSIP, type, term, reopening flag, auction/issue/maturity dates, offering size, coupon, high/median/low yield (discount rate for bills, margin for FRNs), price, allocation at the high, bid-to-cover, tendered and accepted amounts, primary dealer / direct / indirect bidder takedown (amounts and % of competitive), SOMA, FIMA, retail, the high-minus-median spread in bp, results release timestamp and links to the official announcement and results PDFs. **Compared with recent auctions**: 6-auction averages of bid-to-cover, indirect share, dealer share and high-minus-median for the same term, the change in bid-to-cover, and the prior auction's date and rate. Upcoming announced auctions are included too.
Request
POST https://api.pushbuild.com/treasury-auctions/run with a JSON body. Send your key in the X-API-Key header.
| Field | Type | Description |
|---|---|---|
securityTypes | list of strings | Only these types. Empty = all. |
terms | list of strings | Only these terms, e.g. 10-Year, 13-Week, 2-Year. Reopenings match their original term. Empty = all. |
dateFrom | string | Auctions on or after (YYYY-MM-DD). Default: 30 days before dateTo. |
dateTo | string | Auctions on or before (YYYY-MM-DD). Default: today. |
cusip | string | Return every auction of one CUSIP (original issue and reopenings); ignores dates. |
includeUpcoming | boolean | Add announced auctions that have not happened yet (when dateTo is today or later). Default: true. |
resultsOnly | boolean | Drop announced auctions without results. Default: false. |
compareToRecent | boolean | Add 6-auction averages for bid-to-cover, indirect and dealer share and high-minus-median spread for the same term, plus the prior auction's rate. Default: true. |
maxItems | integer | Maximum items to return (1-500). Default: 100. |
Example
curl -X POST https://api.pushbuild.com/treasury-auctions/run \
-H "X-API-Key: YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{"maxItems": 20}'Response
{"count": 20, "truncated": false, "seconds": 1.4, "items": [ { ... } ]}Each call returns up to 500 items. Records that fail validation or are not found are flagged in the items and not charged.
Pricing
Pay only for results returned: $0.40 per 1,000 auctions. No charge for errors or empty searches.
Related APIs
Bank of England API: Bank Rate, SONIA, Gilts & Mortgages API
Bank of England statistics from its official database: Bank Rate, SONIA, gilt yields, implied inflation, mortgage rates and approvals, M4 money, lending and sterling FX.
BLS Data API: Any Bureau of Labor Statistics Series API
Any US Bureau of Labor Statistics time series by id (CPI, payrolls by industry, unemployment, wages, PPI, JOLTS, import prices) plus state unemployment and labor force from plain state codes, with month-over-month and year-over-year changes..
Cboe Put/Call Ratios & VIX Futures Term Structure API
Daily Cboe options statistics: total, equity, index, SPX and VIX put/call ratios with call and put volume and open interest by product, plus the VIX futures curve with settlements, open interest and contango versus spot VIX..
CFPB Consumer Complaints: Banks, Lenders, Fintech API
Search 18 million+ official CFPB consumer complaints against banks, lenders, card issuers, debt collectors, credit bureaus and fintechs.
CFTC Commitments of Traders (COT) Reports API
Weekly CFTC Commitments of Traders positioning for every futures market: legacy, disaggregated (managed money, producers, swap dealers) and financial (leveraged funds, asset managers).
ClinicalTrials.gov API
Search 500,000+ clinical studies from ClinicalTrials.gov by condition, drug, sponsor, location, phase and status.
Tell us what you need built.
Questions about this API, higher volumes, or a data source you need that we don't cover yet.
hello@pushbuild.com