{"openapi":"3.1.0","info":{"title":"US Treasury Auctions API","version":"1.0.0","description":"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.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/treasuryauctions-api","description":"oanor gateway"}],"tags":[{"name":"Treasury"},{"name":"Meta"}],"components":{"securitySchemes":{"oanorKey":{"type":"apiKey","in":"header","name":"x-oanor-key","description":"Get your key at https://www.oanor.com/developer/keys"}}},"security":[{"oanorKey":[]}],"paths":{"/v1/auctions":{"get":{"operationId":"get_v1_auctions","tags":["Treasury"],"summary":"Most recent auctions","description":"","parameters":[{"name":"type","in":"query","required":false,"description":"Bill, Note, Bond, TIPS, FRN, CMB","schema":{"type":"string"},"example":"Bond"},{"name":"limit","in":"query","required":false,"description":"Max auctions (1-100, default 25)","schema":{"type":"string"},"example":"10"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"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","security_type":"Bond","offering_amount":22000000000,"interest_rate_pct":5},{"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},{"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},{"term":"19-Year 10-Month","cusip":"912810UT3","reopening":true,"issue_date":"2026-04-30","auction_date":"2026-04-22","maturity_date":"2046-02-15","price_per_100":96.735962,"security_type":"Bond","high_yield_pct":4.883,"total_accepted":14636144300,"offering_amount":13000000000,"interest_rate_pct":4.625,"bid_to_cover_ratio":2.68},{"term":"29-Year 10-Month","cusip":"912810UR7","reopening":true,"issue_date":"2026-04-15","auction_date":"2026-04-09","maturity_date":"2056-02-15","price_per_100":98.017194,"security_type":"Bond","high_yield_pct":4.876,"total_accepted":25901386200,"offering_amount":22000000000,"interest_rate_pct":4.75,"bid_to_cover_ratio":2.39},{"term":"19-Year 11-Month","cusip":"912810UT3","reopening":true,"issue_date":"2026-03-31","auction_date":"2026-03-17","maturity_date":"2046-02-15","price_per_100":97.551352,"security_type":"Bond","high_yield_pct":4.817,"total_accepted":14343301500,"offering_amount":13000000000,"interest_rate_pct":4.625,"bid_to_cover_ratio":2.76},{"term":"29-Year 11-Month","cusip":"912810UR7","reopening":true,"issue_date":"2026-03-16","auction_date":"2026-03-12","maturity_date":"2056-02-15","price_per_100":98.09685,"security_type":"Bond","high_yield_pct":4.871,"total_accepted":22005667500,"offering_amount":22000000000,"interest_rate_pct":4.75,"bid_to_cover_ratio":2.45},{"term":"30-Year","cusip":"912810US5","reopening":false,"issue_date":"2026-02-27","auction_date":"2026-02-19","maturity_date":"2056-02-15","price_per_100":97.924748,"security_type":"Bond","high_yield_pct":2.473,"total_accepted":9000008600,"offering_amount":9000000000,"interest_rate_pct":2.375,"bid_to_cover_ratio":2.75},{"term":"20-Year","cusip":"912810UT3","reopening":false,"issue_date":"2026-03-02","auction_date":"2026-02-18","maturity_date":"2046-02-15","price_per_100":99.492967,"security_type":"Bond","high_yield_pct":4.664,"total_accepted":17916728200,"offering_amount":16000000000,"interest_rate_pct":4.625,"bid_to_cover_ratio":2.36},{"term":"30-Year","cusip":"912810UR7","reopening":false,"issue_date":"2026-02-17","auction_date":"2026-02-12","maturity_date":"2056-02-15","price_per_100":99.999398,"security_type":"Bond","high_yield_pct":4.75,"total_accepted":32083920100,"offering_amount":25000000000,"interest_rate_pct":4.75,"bid_to_cover_ratio":2.66}]},"meta":{"timestamp":"2026-06-09T20:24:41.763Z","request_id":"e1bfc206-6ca2-407d-8bc6-c55c79201033"},"status":"ok","message":"Auctions retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/results":{"get":{"operationId":"get_v1_results","tags":["Treasury"],"summary":"Completed auctions with results","description":"","parameters":[{"name":"type","in":"query","required":false,"description":"Bill, Note, Bond, TIPS, FRN, CMB","schema":{"type":"string"},"example":"Bond"},{"name":"limit","in":"query","required":false,"description":"Max results (1-100, default 25)","schema":{"type":"string"},"example":"10"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"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},{"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},{"term":"19-Year 10-Month","cusip":"912810UT3","reopening":true,"issue_date":"2026-04-30","auction_date":"2026-04-22","maturity_date":"2046-02-15","price_per_100":96.735962,"security_type":"Bond","high_yield_pct":4.883,"total_accepted":14636144300,"offering_amount":13000000000,"interest_rate_pct":4.625,"bid_to_cover_ratio":2.68},{"term":"29-Year 10-Month","cusip":"912810UR7","reopening":true,"issue_date":"2026-04-15","auction_date":"2026-04-09","maturity_date":"2056-02-15","price_per_100":98.017194,"security_type":"Bond","high_yield_pct":4.876,"total_accepted":25901386200,"offering_amount":22000000000,"interest_rate_pct":4.75,"bid_to_cover_ratio":2.39},{"term":"19-Year 11-Month","cusip":"912810UT3","reopening":true,"issue_date":"2026-03-31","auction_date":"2026-03-17","maturity_date":"2046-02-15","price_per_100":97.551352,"security_type":"Bond","high_yield_pct":4.817,"total_accepted":14343301500,"offering_amount":13000000000,"interest_rate_pct":4.625,"bid_to_cover_ratio":2.76},{"term":"29-Year 11-Month","cusip":"912810UR7","reopening":true,"issue_date":"2026-03-16","auction_date":"2026-03-12","maturity_date":"2056-02-15","price_per_100":98.09685,"security_type":"Bond","high_yield_pct":4.871,"total_accepted":22005667500,"offering_amount":22000000000,"interest_rate_pct":4.75,"bid_to_cover_ratio":2.45},{"term":"30-Year","cusip":"912810US5","reopening":false,"issue_date":"2026-02-27","auction_date":"2026-02-19","maturity_date":"2056-02-15","price_per_100":97.924748,"security_type":"Bond","high_yield_pct":2.473,"total_accepted":9000008600,"offering_amount":9000000000,"interest_rate_pct":2.375,"bid_to_cover_ratio":2.75},{"term":"20-Year","cusip":"912810UT3","reopening":false,"issue_date":"2026-03-02","auction_date":"2026-02-18","maturity_date":"2046-02-15","price_per_100":99.492967,"security_type":"Bond","high_yield_pct":4.664,"total_accepted":17916728200,"offering_amount":16000000000,"interest_rate_pct":4.625,"bid_to_cover_ratio":2.36},{"term":"30-Year","cusip":"912810UR7","reopening":false,"issue_date":"2026-02-17","auction_date":"2026-02-12","maturity_date":"2056-02-15","price_per_100":99.999398,"security_type":"Bond","high_yield_pct":4.75,"total_accepted":32083920100,"offering_amount":25000000000,"interest_rate_pct":4.75,"bid_to_cover_ratio":2.66},{"term":"19-Year 10-Month","cusip":"912810UQ9","reopening":true,"issue_date":"2026-02-02","auction_date":"2026-01-21","maturity_date":"2045-11-15","price_per_100":97.194489,"security_type":"Bond","high_yield_pct":4.846,"total_accepted":13916190200,"offering_amount":13000000000,"interest_rate_pct":4.625,"bid_to_cover_ratio":2.86}]},"meta":{"timestamp":"2026-06-09T20:24:42.129Z","request_id":"81f6a5b8-aabb-4abc-850d-ebae4129df32"},"status":"ok","message":"Results retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/security":{"get":{"operationId":"get_v1_security","tags":["Treasury"],"summary":"One auctioned security by CUSIP","description":"","parameters":[{"name":"cusip","in":"query","required":true,"description":"CUSIP","schema":{"type":"string"},"example":"912810UU0"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"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","security_type":"Bond","offering_amount":22000000000,"auctions_of_cusip":2,"interest_rate_pct":5},"meta":{"timestamp":"2026-06-09T20:24:42.500Z","request_id":"c4000cb5-a8bf-42f0-aed5-5ddd6a938242"},"status":"ok","message":"Security retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/meta":{"get":{"operationId":"get_v1_meta","tags":["Meta"],"summary":"Spec","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"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}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}}},"x-oanor-pricing":[{"slug":"free","name":"Free","price_cents_month":0,"monthly_call_quota":2600,"rps_limit":2,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":1100,"monthly_call_quota":42000,"rps_limit":6,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":2600,"monthly_call_quota":225000,"rps_limit":15,"hard_limit":true},{"slug":"mega","name":"Mega","price_cents_month":6100,"monthly_call_quota":1150000,"rps_limit":40,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/treasuryauctions-api"}