---
title: "US Treasury auction results and calendar since 2010"
method: GET
path: "/api/markets/treasury-auctions"
tags: ["Macro"]
---

# US Treasury auction results and calendar since 2010

`GET /api/markets/treasury-auctions`

## Request

- Base URL: `https://xoomar.com`
- URL: `https://xoomar.com/api/markets/treasury-auctions`
- Auth: one of:
  - none
  - API key in header `x-api-key`

History starts in 2010; the free API returns the last six months. Docs: https://xoomar.com/markets/api/treasury-auctions

## Query parameters

- `type` 'Note' | 'Bond' | 'TIPS' | 'FRN' | 'Bill' | 'CMB' | 'all'
- `term` string
- `from` string
- `to` string
- `upcoming` boolean
- `limit` integer

## Response `200`

OK

- object
  - `data` object[]
    - `cusip` string: Security CUSIP; a reopening shares the original's CUSIP
    - `auctionDate` string, date: Auction date
    - `securityType` string: Bill, CMB (cash management bill), Note, Bond, TIPS or FRN
    - `securityTerm` string: Term as announced: 4-Week, 2-Year, 10-Year, 9-Year 10-Month (reopening)
    - `issueDate` string, date, nullable: Settlement date
    - `maturityDate` string, date, nullable: Maturity
    - `reopening` boolean, nullable: True when the auction adds to an existing issue
    - `offeringAmount` number, nullable: Announced size, USD
    - `totalAccepted` number, nullable: Accepted, USD (null until results)
    - `totalTendered` number, nullable: Bids received, USD
    - `highYield` number, nullable: Stop-out yield, percent (notes, bonds, TIPS)
    - `highRate` number, nullable: High discount rate (bills) or high discount margin (FRNs), percent
    - `interestRate` number, nullable: Coupon set at auction, percent
    - `bidToCover` number, nullable: Tendered divided by accepted
    - `indirectAccepted` number, nullable: Accepted from indirect bidders, USD
    - `directAccepted` number, nullable: Accepted from direct bidders, USD
    - `dealerAccepted` number, nullable: Accepted by primary dealers, USD
    - `indirectShare` number, nullable: Indirect share of accepted, 0 to 1
    - `directShare` number, nullable: Direct share of accepted, 0 to 1
    - `dealerShare` number, nullable: Dealer share of accepted, 0 to 1
    - `canonicalUrl` string, uri: The matching page on xoomar.com
  - `updatedAt` string, date-time: When the response was built; a few dated feeds give the date of their newest row instead
  - `source` 'xoomar.com'
  - `docs` string
  - `license` string: Data terms
  - `attribution` string
  - `canonicalUrl` string, uri: The matching page on xoomar.com
  - `meta` object: Who publishes the data and how to credit it
    - `source` string: The publisher or publishers of the data, comma-separated
    - `sourceAttribution` string: The credit line to show wherever the data is displayed
    - `notice` string: Requests without a key only: the free key, app registration and the credit

## Other responses

- `404`: Unknown slug, ticker or country
- `429`: Rate limit: 10 requests a minute without a key, 30 with a free key

---

[API](https://skmtc.dev/xoomar/apis/xoomar-market-data-api.md) · [All operations](https://skmtc.dev/xoomar/apis/xoomar-market-data-api/llms.txt) · [OpenAPI document](https://skmtc.dev/xoomar/apis/xoomar-market-data-api/revisions/07b78401eaaa?raw)