U.S. Treasury Securities Auction Results (Bills, Notes, Bonds, TIPS and FRNs)

fiscaldata/auction-results

Results of U.S. Treasury securities auctions: for each auction the security (CUSIP, type, term), auction, issue and maturity dates, the amount offered, total tendered and accepted, bid-to-cover ratio, the clearing yield, discount rate or margin, the coupon, and how much went to direct bidders, indirect bidders and primary dealers. Covers every auction since 1979 plus announced auctions not yet held, whose result fields read null. Newest first; filter by security type, term or date. Taken directly from the U.S. Treasury's Fiscal Data API (Treasury Securities Auctions Data).

activeper callv1

Price

$0.00273 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 (Fiscal Data, fiscaldata.treasury.gov), offered without restriction per fiscaldata.treasury.gov/api-documentation.

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.

Install it Create an account

agent

// 1. search: find the tool
omnial_search({ query: "what you need" })

// 2. inspect: price and input schema
omnial_inspect({ tool: "fiscaldata/auction-results" })

// 3. learn: read the usage guide at runtime
omnial_learn({ tool: "fiscaldata/auction-results" })

// 4. run: price the exact call first, then run it
omnial_execute({ tool: "fiscaldata/auction-results", input: { /* see input_schema */ }, dry_run: true })
omnial_execute({ tool: "fiscaldata/auction-results", input: { /* ... */ } })

// 5. settle: the call is charged when it finishes, nothing to do

Not 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.00273

Updated: Oct 18, 2026

Input and output schemas

Input schema

input_schema.json

{
  "type": "object",
  "required": [
    "limit"
  ],
  "properties": {
    "page": {
      "type": "integer",
      "default": 1,
      "maximum": 10000,
      "minimum": 1,
      "description": "Which page of `limit` auctions to return, starting at 1. A page past the last one is an error; meta.total-pages says how many there are."
    },
    "limit": {
      "type": "integer",
      "maximum": 1000,
      "minimum": 1,
      "description": "How many auctions to return, newest first, 1 to 1000."
    },
    "filter": {
      "type": "string",
      "default": "",
      "maxLength": 500,
      "description": "Optional Fiscal Data filter: field:operator:value terms separated by commas, all of which must hold. Fields: security_type (Bill, Note or Bond only: TIPS and floating rate notes are Notes and Bonds, found with inflation_index_security:eq:Yes and floating_rate:eq:Yes), security_term (for example 4-Week, 2-Year, 10-Year, 30-Year), auction_date, issue_date and maturity_date (YYYY-MM-DD), cusip, reopening (Yes or No), plus any returned column. Operators: eq, lt, lte, gt, gte, in (a parenthesised list). Examples: security_type:eq:Note,security_term:eq:10-Year,auction_date:lte:2026-10-16 and auction_date:gte:2026-01-01,auction_date:lte:2026-06-30. Use auction_date:lte:<today> to leave out auctions not yet held. Leave empty for no filter. A value that matches nothing returns an empty list; an unknown field or operator is a validation error."
    }
  },
  "additionalProperties": false
}

Output schema

output_schema.json

{
  "type": "object",
  "required": [
    "data",
    "meta"
  ],
  "properties": {
    "data": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "cusip",
          "security_type",
          "security_term",
          "auction_date",
          "issue_date",
          "maturity_date",
          "offering_amt",
          "total_tendered",
          "total_accepted",
          "bid_to_cover_ratio"
        ],
        "properties": {
          "cusip": {
            "type": "string",
            "description": "The security's CUSIP identifier."
          },
          "spread": {
            "type": "string",
            "description": "The fixed spread over the 13-week bill rate in percent, for floating rate notes."
          },
          "int_rate": {
            "type": "string",
            "description": "The coupon rate in percent; null for bills."
          },
          "low_yield": {
            "type": "string",
            "description": "Lowest accepted yield in percent."
          },
          "reopening": {
            "type": "string",
            "description": "Yes when the auction adds to an existing security, otherwise No."
          },
          "high_price": {
            "type": "string",
            "description": "Price per 100 dollars at the high rate."
          },
          "high_yield": {
            "type": "string",
            "description": "Highest accepted yield in percent, for notes, bonds and TIPS; null for bills."
          },
          "issue_date": {
            "type": "string",
            "description": "When the security is issued, YYYY-MM-DD."
          },
          "auction_date": {
            "type": "string",
            "description": "When the auction is or was held, YYYY-MM-DD."
          },
          "offering_amt": {
            "type": "string",
            "description": "Dollars offered, as a decimal string."
          },
          "avg_med_yield": {
            "type": "string",
            "description": "Average or median accepted yield in percent."
          },
          "comp_accepted": {
            "type": "string",
            "description": "Dollars accepted from competitive bidders."
          },
          "floating_rate": {
            "type": "string",
            "description": "Yes for a floating rate note, otherwise No."
          },
          "maturity_date": {
            "type": "string",
            "description": "When the security matures, YYYY-MM-DD."
          },
          "security_term": {
            "type": "string",
            "description": "The security's term, for example 10-Year."
          },
          "security_type": {
            "type": "string",
            "description": "Bill, Note or Bond."
          },
          "soma_accepted": {
            "type": "string",
            "description": "Dollars accepted for the Federal Reserve's System Open Market Account (SOMA)."
          },
          "total_accepted": {
            "type": "string",
            "description": "Dollars accepted in all, as a decimal string; null before the auction."
          },
          "total_tendered": {
            "type": "string",
            "description": "Dollars bid in all, as a decimal string; null before the auction."
          },
          "announcemt_date": {
            "type": "string",
            "description": "When the auction was announced, YYYY-MM-DD."
          },
          "high_discnt_rate": {
            "type": "string",
            "description": "Highest accepted discount rate in percent, for bills."
          },
          "noncomp_accepted": {
            "type": "string",
            "description": "Dollars accepted from non-competitive bidders."
          },
          "bid_to_cover_ratio": {
            "type": "string",
            "description": "Total tendered over total accepted; null before the auction."
          },
          "high_discnt_margin": {
            "type": "string",
            "description": "Highest accepted discount margin in percent, for floating rate notes."
          },
          "high_investment_rate": {
            "type": "string",
            "description": "Highest accepted investment rate in percent, for bills."
          },
          "direct_bidder_accepted": {
            "type": "string",
            "description": "Dollars accepted from direct bidders."
          },
          "primary_dealer_accepted": {
            "type": "string",
            "description": "Dollars accepted from primary dealers."
          },
          "cash_management_bill_cmb": {
            "type": "string",
            "description": "Yes for a cash management bill, otherwise No."
          },
          "indirect_bidder_accepted": {
            "type": "string",
            "description": "Dollars accepted from indirect bidders, which include foreign central banks."
          },
          "inflation_index_security": {
            "type": "string",
            "description": "Yes for TIPS, otherwise No."
          }
        },
        "additionalProperties": true
      },
      "description": "One row per auction. Every value is a string; the string null marks a value that does not apply or is not yet known."
    },
    "meta": {
      "type": "object",
      "required": [
        "count",
        "total-count",
        "total-pages"
      ],
      "properties": {
        "count": {
          "type": "integer",
          "description": "How many auctions this page holds."
        },
        "labels": {
          "type": "object",
          "description": "Human-readable name of each column."
        },
        "dataTypes": {
          "type": "object",
          "description": "The Treasury's type name for each column."
        },
        "dataFormats": {
          "type": "object",
          "description": "The Treasury's display format for each column."
        },
        "total-count": {
          "type": "integer",
          "description": "How many auctions match the filter in all, across every page."
        },
        "total-pages": {
          "type": "integer",
          "description": "How many pages of `limit` auctions the whole match makes."
        }
      },
      "additionalProperties": true
    },
    "links": {
      "type": "object",
      "description": "Treasury's own self, first, prev, next and last page links."
    }
  },
  "description": "The Treasury's response: the auctions, newest first, and a meta block with the match count.",
  "additionalProperties": true
}