---
title: "Returns Treasury security auctions — Bills (≤1yr), Notes (2-10yr), Bonds (20-30yr), TIPS (inflation-protected), and FRNs (floating-rate)"
method: GET
path: "/v1/treasury-auctions"
---

# Returns Treasury security auctions — Bills (≤1yr), Notes (2-10yr), Bonds (20-30yr), TIPS (inflation-protected), and FRNs (floating-rate)

`GET /v1/treasury-auctions`

## Request

- Base URL: `https://api.keyvex.com`
- URL: `https://api.keyvex.com/v1/treasury-auctions`
- Auth: API key in header `x-api-key`

Returns Treasury security auctions — Bills (≤1yr), Notes (2-10yr), Bonds (20-30yr), TIPS (inflation-protected), and FRNs (floating-rate). Each record is one CUSIP issuance with announcement metadata + post- auction results.  Key signal fields agents care about:   - bid_to_cover_ratio: demand. >2.5 strong, <2.0 weak.   - high_yield / average_yield: market clearing rate.   - direct_bidder / indirect_bidder breakdowns: domestic vs foreign demand.   - soma_holdings + soma_included: Fed System Open Market Account     allocation. A live measure of Fed QE/QT activity on each issue.  Records have a two-stage lifecycle: announcement (results fields null) → post-auction (full results populated). Idempotent saves on cusip + auction_date overwrite cleanly when results publish.  Security types: 'Bill', 'Note', 'Bond', 'TIPS', 'FRN', 'CMB' (cash- management bill). Use security_type filter to focus on one term group. Note: Treasury reports TIPS and FRNs under security_type Note/Bond with an inflation-indexed / floating-rate flag (not as their own type); filtering security_type:'TIPS' or 'FRN' here resolves to those flags for convenience.

## Query parameters

- `cusip` string
- `security_type` string
- `reopening` boolean
- `min_offering_amount` number
- `min_bid_to_cover` number
- `since` string
- `until` string
- `sort_by` 'auction_date' | 'issue_date' | 'maturity_date' | 'offering_amount' | 'bid_to_cover_ratio'
- `sort_order` 'desc' | 'asc'
- `limit` integer

## Response `200`

JSON envelope: { results: [...], count, has_more }.

## Other responses

- `400`: Invalid parameter.
- `401`: Missing or invalid API key.
- `402`: This tool requires a higher plan (upgrade_required). Retrying will not help.
- `429`: Tier rate/quota limit reached (rate_limited). Retry-After points at the reset.

---

[API](https://skmtc.dev/keyvex/apis/keyvex-api.md) · [All operations](https://skmtc.dev/keyvex/apis/keyvex-api/llms.txt) · [OpenAPI document](https://skmtc.dev/keyvex/apis/keyvex-api/revisions/01c0210c19cd?raw)