Treasury Auction Results
get_treasury_auctionsGet US Treasury securities auction results (bid-to-cover ratio, high yield or discount rate, and the primary-dealer/direct/indirect bidder split), newest first. Set upcoming=true for the announced schedule of auctions not yet held. No API key required.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "get_treasury_auctions"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| to | No | Latest auction date to include, `YYYY-MM-DD`; ignored when `upcoming` is true | |
| from | No | Earliest auction date to include, `YYYY-MM-DD`; ignored when `upcoming` is true | |
| count | No | Total auctions fetched from Treasury, newest first (default: 100); `limit`/`cursor` page through them | |
| limit | No | Maximum rows per page; omitted = curated default (25) | |
| cursor | No | Opaque continuation token from a previous response's `pageInfo.endCursor`; omitted = first page | |
| fields | No | Comma-separated list of GraphQL field names to include; omitted = all fields | |
| upcoming | No | Return the not-yet-held auction schedule instead of auction records | |
| security_term | No | Security term filter as Treasury spells it (e.g. "13-Week"); ignored when `upcoming` is true | |
| security_type | No | Security class filter ("Bill", "Note", "Bond"); ignored when `upcoming` is true |