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

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.

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

Query parameters

cusipstring

Filter to one specific CUSIP issuance.

security_typestring

e.g. 'Bill', 'Note', 'Bond', 'TIPS', 'FRN', 'CMB'.

reopeningboolean

Filter to reopenings (new tranches of an existing CUSIP) only when true.

min_offering_amountnumber

Filter to auctions with offering_amount >= this dollar amount.

min_bid_to_covernumber

Filter to auctions with bid_to_cover_ratio >= this value (e.g. 2.5 for strong-demand auctions only).

sincestring

ISO date YYYY-MM-DD. Applied to sort_by field.

untilstring

ISO date YYYY-MM-DD.

sort_by'auction_date' | 'issue_date' | 'maturity_date' | 'offering_amount' | 'bid_to_cover_ratio'

Default auction_date.

sort_order'desc' | 'asc'

Default desc.

limitinteger

Default 50, max 500.

Response

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

Changes

No recorded changes to this operation across all 1 revision of this API.