Macroeconomic & markets

Treasury Auctions

Name: Treasury Auctions
Creator: KeyVex

Returns Treasury security auctions — Bills (≤1yr), Notes (2-10yr), Bonds (20-30yr), TIPS (inflation-protected), and FRNs (floating-rate). Each record is one CUSIP issuance with announcement metadata + post- auction results.

EndpointGET /v1/treasury-auctions

SourceUS Treasury

Authx-api-key — a free key works

What it returns

One record per result. Fields (from a live response):

Subject — cusip, security_term, issue_date, security_type
Dates — auction_date, announcement_date, maturity_date, scraped_at
Amounts — total_tendered, interest_rate, low_price, low_yield, average_yield, high_investment_rate, total_accepted, low_investment_rate, low_discount_rate, average_discount_rate, high_yield, floating_rate, offering_amount, high_discount_rate, average_price, high_price, average_investment_rate
Provenance — treasury_source_url, pdf_announcement_url, pdf_noncompetitive_results_url, pdf_competitive_results_url
Details — callable, indirect_bidder_accepted, direct_bidder_accepted, id, soma_accepted, primary_dealer_tendered, bid_to_cover_ratio, inflation_indexed, indirect_bidder_tendered, soma_holdings, competitive_tendered, competitive_accepted, reopening, noncompetitive_accepted, treas_retail_accepted, primary_dealer_accepted, soma_tendered, direct_bidder_tendered, auction_format, fima_included, soma_included

Filters

cusip	Filter to one specific CUSIP issuance.
security_type	e.g. 'Bill', 'Note', 'Bond', 'TIPS', 'FRN', 'CMB'.
reopening	Filter to reopenings (new tranches of an existing CUSIP) only when true.
min_offering_amount	Filter to auctions with offering_amount >= this dollar amount.
min_bid_to_cover	Filter to auctions with bid_to_cover_ratio >= this value (e.g. 2.5 for strong-demand auctions only).
since	ISO date YYYY-MM-DD. Applied to sort_by field.
until	ISO date YYYY-MM-DD.
sort_by	Default auction_date.
sort_order	Default desc.
limit	Default 50, max 500.

Example request

curl "https://api.keyvex.com/v1/treasury-auctions?limit=1" \
  -H "x-api-key: YOUR_KEY"

Response

{
  "results": [
    {
      "cusip": "91282CQW4",
      "callable": false,
      "indirect_bidder_accepted": null,
      "direct_bidder_accepted": null,
      "security_term": "7-Year",
      "treasury_source_url": "https://www.treasurydirect.gov/auctions/auction-query/?cusip=91282CQW4",
      "total_tendered": null,
      "interest_rate": null,
      "id": "91282CQW4-2026-06-25",
      "low_price": null,
      "soma_accepted": null,
      "low_yield": null,
      "pdf_announcement_url": "https://www.treasurydirect.gov/instit/annceresult/press/preanre/2026/A_20260618_6.pdf",
      "average_yield": null,
      "high_investment_rate": null,
      "auction_date": "2026-06-25",
      "primary_dealer_tendered": null,
      "total_accepted": null,
      "bid_to_cover_ratio": null,
      "low_investment_rate": null,
      "inflation_indexed": false,
      "indirect_bidder_tendered": null,
      "soma_holdings": 30986000000,
      "low_discount_rate": null,
      "competitive_tendered": null,
      "competitive_accepted": null,
      "average_discount_rate": null,
      "reopening": false,
      "announcement_date": "2026-06-18",
      "pdf_noncompetitive_results_url": null,
      "noncompetitive_accepted": null,
      "maturity_date": "2033-06-30",
      "treas_retail_accepted": null,
      "high_yield": null,
      "issue_date": "2026-06-30",
      "primary_dealer_accepted": null,
      "floating_rate": false,
      "soma_tendered": null,
      "security_type": "Note"
      …
    }
  ],
  "count": 1,
  "has_more": true
}

Example questions you can answer

Results of recent Treasury Note or Bond auctions.
Upcoming and historical auctions by security type.

Related datasets

Economic IndicatorsBLS + FRED + EIA CFTC Commitments of TradersCFTC COT Unified SearchAll KeyVex datasets

Query Treasury Auctions from your AI

Hand any AI your key + the OpenAPI spec and it can pull this dataset directly. Free key = full data, 60 requests/day.

Get a free key OpenAPI spec → REST docs →

← All 60+ datasets