Treasury Security Lookup by CUSIP: Every Auction and Reopening of One Security (TreasuryDirect)
treasurydirect/treasury-security-lookup
Every auction record the Treasury holds for one CUSIP, newest issue date first: the original auction and each reopening, with term, auction, issue and maturity dates, coupon, amount offered, highest accepted yield or rate, bid-to-cover ratio and bidder breakdown. A CUSIP the Treasury does not know returns an empty list. An auction not yet held has empty result fields. Every value is a string; fields that do not apply to a kind of security are empty. A row is wide (about 190 fields, 7 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-security-lookup" })
// 3. learn: read the usage guide at runtime
omnial_learn({ tool: "treasurydirect/treasury-security-lookup" })
// 4. run: price the exact call first, then run it
omnial_execute({ tool: "treasurydirect/treasury-security-lookup", input: { /* see input_schema */ }, dry_run: true })
omnial_execute({ tool: "treasurydirect/treasury-security-lookup", 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": [
"cusip"
],
"properties": {
"cusip": {
"type": "string",
"pattern": "^[A-Za-z0-9]{9}$",
"description": "The security's 9-character CUSIP, letters and digits, for example 91282CRF0. Case-insensitive."
}
},
"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 record of the CUSIP (the original auction or a reopening), 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 auction records for the CUSIP, newest issue date first. Empty when the Treasury has none.",
"additionalProperties": true
}