# US Treasury Auctions API > Live results and schedule of US Treasury debt auctions, served from the US Treasury's FiscalData API — no key, nothing cached. Every Treasury bill, note, bond, TIPS and FRN is sold at auction, and the results are the market's clearest read on demand for US government debt. The auctions endpoint returns the most recent auctions — bills, notes, bonds and more — each with its CUSIP, security type and term, auction and issue dates and offering amount. The results endpoint returns the recently completed auctions with the numbers that matter: the high yield or discount rate, the bid-to-cover ratio (how many dollars were bid for each dollar offered — the headline demand gauge, around 2.5 for a healthy 20-year bond), the interest rate and the price. The security endpoint returns the full detail of one auctioned security by its CUSIP. Everything is the Treasury's own published auction data, live, nothing stored. This is the Treasury-auction layer for any fixed-income, rates, macro or research app. Distinct from debt-level and yield-curve APIs — this is the auction calendar and results: what the Treasury sold, at what yield, and how strong the demand was. 3 endpoints, no key on our side. ## Authentication All requests require your oanor API key in the `x-oanor-key` header. Get one at https://www.oanor.com/developer/keys. ```bash curl -H "x-oanor-key: oanor_live_…" "https://api.oanor.com/treasuryauctions-api/..." ``` ## Pricing - **Free** (Free) — 2,600 calls/Mo, 2 req/s - **Starter** ($11/Mo) — 42,000 calls/Mo, 6 req/s - **Pro** ($26/Mo) — 225,000 calls/Mo, 15 req/s - **Mega** ($61/Mo) — 1,150,000 calls/Mo, 40 req/s ## Endpoints ### Treasury #### `GET /v1/auctions` — Most recent auctions **Parameters:** - `type` (query, optional, string) — Bill, Note, Bond, TIPS, FRN, CMB Example: `Bond` - `limit` (query, optional, string) — Max auctions (1-100, default 25) Example: `10` **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/treasuryauctions-api/v1/auctions?type=Bond&limit=10" ``` **Response:** ```json { "data": { "count": 10, "source": "US Treasury (FiscalData)", "auctions": [ { "term": "29-Year 11-Month", "cusip": "912810UU0", "reopening": true, "issue_date": "2026-06-15", "auction_date": "2026-06-11", "maturity_date": "2056-05-15", "price_per_100": null, "security_type": "Bond", "high_yield_pct": null, "total_accepted": null, "offering_amount": 22000000000, "interest_rate_pct": 5, "bid_to_cover_ratio": null, "high_discount_rate_pct": null }, { "term": "20-Year", "cusip": "912810UV8", "reopening": false, "issue_date": "2026-06-01", "auction_date": "2026-05-20", "maturity_date": "2046-05-15", "price_per_100": 98.481099, "security_type": "Bond", "high_yield_pct": 5.122, "total_accepted": 18360688200, "offering_amount": 16000000000, "interest_rate_pct": 5, "bid_to_cover_ratio": 2.55, "high_discount_rate_pct": null }, { "term": "30-Year", "cusip": "912810UU0", "reopening": false, "issue_ …(truncated, see openapi.json for full schema) ``` #### `GET /v1/results` — Completed auctions with results **Parameters:** - `type` (query, optional, string) — Bill, Note, Bond, TIPS, FRN, CMB Example: `Bond` - `limit` (query, optional, string) — Max results (1-100, default 25) Example: `10` **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/treasuryauctions-api/v1/results?type=Bond&limit=10" ``` **Response:** ```json { "data": { "note": "completed auctions with published results", "count": 10, "source": "US Treasury (FiscalData)", "results": [ { "term": "20-Year", "cusip": "912810UV8", "reopening": false, "issue_date": "2026-06-01", "auction_date": "2026-05-20", "maturity_date": "2046-05-15", "price_per_100": 98.481099, "security_type": "Bond", "high_yield_pct": 5.122, "total_accepted": 18360688200, "offering_amount": 16000000000, "interest_rate_pct": 5, "bid_to_cover_ratio": 2.55, "high_discount_rate_pct": null }, { "term": "30-Year", "cusip": "912810UU0", "reopening": false, "issue_date": "2026-05-15", "auction_date": "2026-05-13", "maturity_date": "2056-05-15", "price_per_100": 99.292811, "security_type": "Bond", "high_yield_pct": 5.046, "total_accepted": 30936165500, "offering_amount": 25000000000, "interest_rate_pct": 5, "bid_to_cover_ratio": 2.3, "high_discount_rate_pct": null }, { "term": "19-Year 10-Month", "cusip": …(truncated, see openapi.json for full schema) ``` #### `GET /v1/security` — One auctioned security by CUSIP **Parameters:** - `cusip` (query, required, string) — CUSIP Example: `912810UU0` **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/treasuryauctions-api/v1/security?cusip=912810UU0" ``` **Response:** ```json { "data": { "term": "29-Year 11-Month", "cusip": "912810UU0", "source": "US Treasury (FiscalData)", "reopening": true, "issue_date": "2026-06-15", "auction_date": "2026-06-11", "maturity_date": "2056-05-15", "price_per_100": null, "security_type": "Bond", "high_yield_pct": null, "total_accepted": null, "offering_amount": 22000000000, "auctions_of_cusip": 2, "interest_rate_pct": 5, "bid_to_cover_ratio": null, "high_discount_rate_pct": null }, "meta": { "timestamp": "2026-06-09T20:24:42.500Z", "request_id": "c4000cb5-a8bf-42f0-aed5-5ddd6a938242" }, "status": "ok", "message": "Security retrieved successfully", "success": true } ``` ### Meta #### `GET /v1/meta` — Spec **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/treasuryauctions-api/v1/meta" ``` **Response:** ```json { "data": { "source": "US Treasury FiscalData — Auctions Query (live)", "service": "treasuryauctions-api", "endpoints": { "GET /v1/meta": "This document.", "GET /v1/results": "Recently completed auctions with high yield + bid-to-cover ratio (type=, limit).", "GET /v1/auctions": "Most recent auctions (type=Bill|Note|Bond|TIPS|FRN, limit).", "GET /v1/security": "One auctioned security by CUSIP (cusip=912810UU0)." }, "description": "Live results and schedule of US Treasury debt auctions from the US Treasury's FiscalData API: the most recent auctions (bills, notes, bonds, TIPS, FRN) with CUSIP, type, term, dates and offering amount; recently completed auctions with the high yield/discount rate, bid-to-cover ratio (the headline demand gauge), interest rate and price; and the full detail of one auctioned security by CUSIP. Live, no key, nothing stored. Distinct from debt-level and yield-curve APIs — this is the auction calendar and results: what the Treasury sold, at what yield, and how strong the demand was.", "latest_auction": "2026-06-11", "upstream_status": "ok" }, "meta": { "timestamp": "2026-06-09T20:24:42.860Z", "request_id": "a020285b-59a0-4079-97fa-b54124847554" }, "status": "ok", "message": "Meta", "success": true } ``` --- Marketplace page: https://www.oanor.com/api/treasuryauctions-api OpenAPI spec: https://www.oanor.com/api/treasuryauctions-api/openapi.json