Treasury Auction Results: Yields, Rates, Bid-to-Cover for Bills, Notes, Bonds, TIPS, FRNs (TreasuryDirect)
treasurydirect/treasury-auction-results
The most recent US Treasury auctions with results, newest issue date first: for each bill, note, bond, TIPS or floating rate note its CUSIP, term, auction and issue dates, amount offered, highest accepted yield or discount rate, bid-to-cover ratio and the bidder breakdown. Filter to one kind of security, and ask for 1 to 20. Every value is a string; fields that do not apply to a kind of security are empty. A row is wide (about 190 fields), so 20 rows is about 136 KB. U.S. Department of the Treasury data, passed through unmodified and served by Eden Engine; not an official Treasury product.
Price
$0.0026 per call
You pay the price shown. If a call turns out to cost more than its quote, you pay the actual price, capped at twice the quote. No monthly minimum. Top-ups start at $5.
Data source
U.S. Department of the Treasury (Fiscal Data)
Data from the U.S. Department of the Treasury, Bureau of the Fiscal Service (TreasuryDirect web APIs, treasurydirect.gov), used under its web API terms at treasurydirect.gov/legal-information/developers/web-api-terms. Served by Eden Engine; not an official U.S. Department of the Treasury product.
Use it
Five steps: search, inspect, learn, run, settle. No per-tool setup; your agent reaches this tool through the meta-tools it already has.
Connect once and your AI can find and run this tool, and any other it needs.
// 1. search: find the tool
omnial_search({ query: "what you need" })
// 2. inspect: price and input schema
omnial_inspect({ tool: "treasurydirect/treasury-auction-results" })
// 3. learn: read the usage guide at runtime
omnial_learn({ tool: "treasurydirect/treasury-auction-results" })
// 4. run: price the exact call first, then run it
omnial_execute({ tool: "treasurydirect/treasury-auction-results", input: { /* see input_schema */ }, dry_run: true })
omnial_execute({ tool: "treasurydirect/treasury-auction-results", input: { /* ... */ } })
// 5. settle: the call is charged when it finishes, nothing to doNot connected yet? Point your MCP client at https://mcp.eden-engine.com/mcp, then copy a config for your client.
Pricing
Every charge this tool can incur.
| Charge | Price |
|---|---|
Per call | $0.0026 |
- Updated
- Oct 20, 2026
Input and output schemas
Input schema
{
"type": "object",
"required": [
"limit"
],
"properties": {
"type": {
"enum": [
"Bill",
"Note",
"Bond",
"TIPS",
"FRN"
],
"type": "string",
"description": "Leave out for all kinds. Otherwise one of Bill, Note, Bond, TIPS or FRN (case-sensitive): TIPS and FRN issues are separate here although their securityType field reads Note."
},
"limit": {
"type": "integer",
"maximum": 20,
"minimum": 1,
"description": "How many auctions to return, newest issue date first, 1 to 20. A row is about 7 KB."
}
},
"additionalProperties": false
}Output schema
{
"type": "object",
"required": [
"results"
],
"properties": {
"results": {
"type": "array",
"items": {
"type": "object",
"properties": {
"type": {
"type": "string",
"description": "Bill, Note, Bond, TIPS or FRN. Use this one: `securityType` reads 'Note' for TIPS and FRN issues."
},
"cusip": {
"type": "string",
"description": "The security's 9-character CUSIP."
},
"highRate": {
"type": "string",
"description": "Highest accepted discount rate in percent (bills)."
},
"highYield": {
"type": "string",
"description": "Highest accepted yield in percent (notes, bonds, TIPS); empty for bills."
},
"issueDate": {
"type": "string",
"description": "Settlement and issue date, ISO date-time, no zone."
},
"reopening": {
"type": "string",
"description": "'Yes' if this adds to an existing security, 'No' if it is the first issue."
},
"interestRate": {
"type": "string",
"description": "Coupon rate in percent for notes, bonds, TIPS; empty for bills."
},
"maturityDate": {
"type": "string",
"description": "Maturity date, ISO date-time, no zone."
},
"securityTerm": {
"type": "string",
"description": "The term, for example '13-Week', '10-Year' or '9-Year 10-Month'."
},
"securityType": {
"type": "string",
"description": "Bill, Note or Bond (TIPS and FRN appear as Note)."
},
"investmentRate": {
"type": "string",
"description": "Bill investment rate (bond-equivalent yield) in percent."
},
"offeringAmount": {
"type": "string",
"description": "Amount offered, US dollars, digits only."
},
"bidToCoverRatio": {
"type": "string",
"description": "Total bids tendered divided by amount accepted. Empty until results are posted."
},
"announcementDate": {
"type": "string",
"description": "When the auction was announced, ISO date-time, no zone."
},
"updatedTimestamp": {
"type": "string",
"description": "When the Treasury last updated this record, ISO date-time."
},
"highDiscountMargin": {
"type": "string",
"description": "Highest accepted discount margin in percent (floating rate notes)."
},
"securityDescription": {
"type": "string",
"description": "Term and kind, for example '13-Week Bill'."
},
"competitiveAuctionCloseDate": {
"type": "string",
"description": "The auction day, ISO date-time, no zone."
}
},
"description": "One Treasury auction of one security, in the Treasury's own wide record (about 190 fields, most empty for any one security). Every value is a STRING and an empty string means 'not applicable or not yet known'. The fields below are the ones most callers read; all others pass through.",
"additionalProperties": true
}
}
},
"description": "The auctions, newest issue date first. Empty when nothing matches.",
"additionalProperties": true
}