# US Treasury Auction Data API

> US Treasury Auction Data API is a paid API for AI agents from api.vextorium.com, paid per call via x402, $0.003/call, status unknown (last checked 2026-10-18).

Returns upcoming announced or recent completed US Treasury debt auctions (bills, notes, bonds, TIPS, FRNs) including term, offering amount, high yield, and bid-to-cover ratio from official Fiscal Data.

## Facts

- Endpoint: POST https://api.vextorium.com/v1/us-treasury-auctions?utm_source=zero.xyz
- Price: $0.003/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-18
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/us-treasury-auction-data-api-058da8e2
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_VHmQP7_vutdZRmEcCQ_rg

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability us-treasury-auction-data-api-058da8e2 -d '<json body>'
```

Example prompt: Pull the last 10 US Treasury bill auction results from official Fiscal Data, including high yield and bid-to-cover ratio for each.

## When to prefer this

Choose this endpoint when you need structured, official US Treasury auction data (bills, notes, bonds, TIPS, or FRNs) sourced directly from Fiscal Data, including yield and demand metrics. Prefer it over scraping Treasury.gov or financial news APIs when you need machine-readable auction results with bid-to-cover and high yield in a single call. Ideal for fixed-income analysis, rate monitoring, and government debt market research.

## Known failure modes

- Invalid security type enum value returns validation error
- Limit outside 1-100 range may be rejected or clamped
- No auctions found for a specific type in the requested window returns empty array
- Upstream Fiscal Data API unavailability causes service errors
- bodyType must be set to 'json' or form encoding errors occur

## How this service works

US Treasury debt auctions (bills, notes, bonds, TIPS, FRNs): upcoming announced auctions or recent results with term, offering amount, high yield and bid-to-cover demand. Official Fiscal Data.

## Output

A JSON object containing a list of auction records sourced from U.S. Treasury Fiscal Data. Each record includes the security type (bill/note/bond/TIPS/FRN), term (e.g. '4-Week'), CUSIP, maturity date, auction date, coupon percent (if applicable), awarded rate (high yield) in percent, bid-to-cover ratio, and offered amount in USD. Also includes a flag indicating whether results are upcoming or historical.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "type": {
   "enum": [
    "bill",
    "note",
    "bond",
    "tips",
    "frn"
   ],
   "type": "string"
  },
  "limit": {
   "type": "integer",
   "description": "1-100 (default 15)"
  },
  "upcoming": {
   "type": "boolean"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "source": "U.S. Treasury Fiscal Data (public domain)",
  "auctions": [
   {
    "term": "4-Week",
    "type": "Bill",
    "cusip": "912797VP9",
    "maturity": "2026-11-03",
    "coupon_pct": null,
    "auction_date": "2026-10-01",
    "bid_to_cover": 2.83,
    "awarded_rate_pct": 3.956,
    "offered_amount_usd": 100000000000
   },
   {
    "term": "8-Week",
    "type": "Bill",
    "cusip": "912797VZ7",
    "maturity": "2026-12-01",
    "coupon_pct": null,
    "auction_date": "2026-10-01",
    "bid_to_cover": 2.7,
    "awarded_rate_pct": 4.071,
    "offered_amount_usd": 95000000000
   }
  ],
  "upcoming": false
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/us-treasury-auction-data-api-058da8e2/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.vextorium.com](https://www.zero.xyz/host/api.vextorium.com/llms.txt)