[Integrations](https://spiral.ai/integrations) › [Claude Code](https://spiral.ai/integrations/claude-code) › [U.S. Treasury upcoming auctions](https://spiral.ai/integrations/claude-code/u-s-treasury-upcoming-auctions)

# How to Use U.S. Treasury upcoming auctions in Claude Code

Returns Treasury auction announcements with security details, offering amounts, and auction, issue, and maturity dates. Use it to plan around upcoming issuance before the auction determines the accepted rate or yield.

|  |  |
| --- | --- |
| Model | U.S. Treasury upcoming auctions |
| Available through | Alexandria |
| Category | Finance |
| Price | $0.001746 per call. |
| Returns | json |
| Runs | In the background |
| Setup | About 2 minutes, no API key |

## Prompts to try with U.S. Treasury upcoming auctions in Claude Code

- Use U.S. Treasury upcoming auctions to populate this project's calendar with announced 13-week and 26-week bill auctions, including offering amounts, auction dates, and issue dates.
- Use U.S. Treasury upcoming auctions to add an upcoming 2-year floating rate note table to this project with CUSIPs, offering amounts, auction dates, and issue dates.
- Use U.S. Treasury upcoming auctions to look this up and give me the result as a table. Save the result in ./assets.
- Pull the latest numbers from U.S. Treasury upcoming auctions and tell me what changed since last week.
- Check U.S. Treasury upcoming auctions and summarize what you find in three bullet points.

## How to set up U.S. Treasury upcoming auctions in Claude Code

Pick the way that suits you. Each takes about two minutes.

### Use Spiral's MCP server

1. **Add the hosted server**: This adds Spiral to the current project. Add `--scope user` to use it in every project.

```bash
claude mcp add --transport http spiral https://api.spiral.ai/mcp
```

2. **Sign in**: Start `claude`, type `/mcp`, choose spiral and Authenticate. Sign in to Spiral in the browser and click Authorize. No API key.

### Use the Spiral skill

1. **Send Claude Code this message**: Your agent reads Spiral's skill and sets itself up.

```
set up https://spiral.ai/SKILL.md
```

2. **Sign in or paste a key**: Approve Spiral in the browser, or give the agent a key from the console.

### Use the Spiral CLI

1. **Install and sign in**: Installs the Spiral CLI, signs you in and adds its skill to your coding agents.

```bash
npx -y spiral-cli@latest init
```

### Call the Spiral API

1. **Create an API key**: In the console, under API keys.

2. **Run U.S. Treasury upcoming auctions**: One request; the result comes back by polling or a webhook.

```bash
curl https://api.spiral.ai/v1/runs \
  -H "Authorization: Bearer $SPIRAL_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "provider": "alexandria",
    "model": "treasury-fiscal-data/auctions/upcoming",
    "input": {
      "sort": "<sort>"
    }
  }'
```

Then paste one of the prompts above: Claude Code finds U.S. Treasury upcoming auctions on Spiral, shows the price and runs it.

Setup guide in the docs: https://spiral.ai/docs/quickstarts/claude-code

## U.S. Treasury upcoming auctions tools and prices

- [Treasury Fiscal Data · Upcoming auctions](https://spiral.ai/tools/alexandria/treasury-fiscal-data/auctions/upcoming) (Alexandria): $0.001746 per call.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| sort |  | — | Sort column, prefixed with `-` for descending: `-record_date` puts the latest first. Comma-separated for several. Unsorted results come back oldest first. |
| fields |  | — | Columns to return, comma-separated, in place of all of them. Rows come back distinct over the chosen columns, so `fields=security_type` on auction results answers three rows, not eleven thousand; keep every column that identifies a row in the list before counting or summing (for buybacks, `operation_date` and `operation_start_time_est`, plus `cusip_nbr` on securities). A column not in the declared list answers HTTP 400 naming it. |
| filter |  | — | Filter, as `column:operator:value`, several joined by commas: `record_date:gte:2026-01-01`, `security_type:eq:Bill,auction_date:gte:2026-08-01`. Operators: eq, lt, lte, gt, gte, and in with a parenthesised list `security_type:in:(Bill,Note)`. An unknown column answers HTTP 400. |
| page[size] | … to 10000 | 100 | Rows per page, 1 to 10,000. The default of 100 is fine for a summary series and far too small for a full auction history. |
| page[number] |  | 1 | Page number, 1-indexed. `meta.total-pages` in the response says how many there are. |

## What can you do with U.S. Treasury upcoming auctions in Claude Code?

Build a Treasury issuance calendar or auction comparison view in your project using official dates, amounts, and results. Preserve separate auction events for reopenings and distinguish FRNs and TIPS in security comparisons.

### Weekly Treasury auction brief

Summarize the week's announced offerings and completed auctions by security type and term. Show offering amounts and dates for upcoming sales, then accepted rates and bid-to-cover ratios for completed sales.

### Issuance totals by maturity

Total announced offering amounts and completed auction awards separately by term. Use the comparison to describe the timing and maturity mix of Treasury issuance.

### Business cash planning

Compare Treasury issue and maturity dates with a business's cash planning dates. Use upcoming announcements to identify candidates and completed auctions to review recent accepted rates.

### Reopening research

Review announced reopenings and completed reopening auctions. Keep each auction date separate while comparing securities that retain the original maturity date and coupon rate or spread.

### Upcoming issuance calendar

Build a dated list of announced bill, note, bond, TIPS, and FRN auctions. Include offering amounts and issue dates so a market research team can plan its coverage.

## Overview

- [Alexandria](https://spiral.ai/providers/alexandria)
- [All Claude Code guides](https://spiral.ai/integrations/claude-code)

## U.S. Treasury upcoming auctions in other agents

- [Amp](https://spiral.ai/integrations/amp/u-s-treasury-upcoming-auctions)
- [ChatGPT](https://spiral.ai/integrations/chatgpt/u-s-treasury-upcoming-auctions)
- [Claude](https://spiral.ai/integrations/claude-desktop/u-s-treasury-upcoming-auctions)
- [Cline](https://spiral.ai/integrations/cline/u-s-treasury-upcoming-auctions)
- [Codex](https://spiral.ai/integrations/codex/u-s-treasury-upcoming-auctions)
- [Cursor](https://spiral.ai/integrations/cursor/u-s-treasury-upcoming-auctions)
- [Devin](https://spiral.ai/integrations/devin/u-s-treasury-upcoming-auctions)
- [dots](https://spiral.ai/integrations/dots/u-s-treasury-upcoming-auctions)
- [Factory Droid](https://spiral.ai/integrations/factory-droid/u-s-treasury-upcoming-auctions)
- [Gemini](https://spiral.ai/integrations/gemini/u-s-treasury-upcoming-auctions)
- [Gemini CLI](https://spiral.ai/integrations/gemini-cli/u-s-treasury-upcoming-auctions)
- [Google Antigravity](https://spiral.ai/integrations/antigravity/u-s-treasury-upcoming-auctions)
- [goose](https://spiral.ai/integrations/goose/u-s-treasury-upcoming-auctions)
- [Grok](https://spiral.ai/integrations/grok/u-s-treasury-upcoming-auctions)
- [Grok Build](https://spiral.ai/integrations/grok-build/u-s-treasury-upcoming-auctions)
- [Hermes](https://spiral.ai/integrations/hermes/u-s-treasury-upcoming-auctions)
- [Instinct](https://spiral.ai/integrations/instinct/u-s-treasury-upcoming-auctions)
- [Manus](https://spiral.ai/integrations/manus/u-s-treasury-upcoming-auctions)
- [Muse](https://spiral.ai/integrations/muse/u-s-treasury-upcoming-auctions)
- [Muse Code](https://spiral.ai/integrations/muse-code/u-s-treasury-upcoming-auctions)
- [n8n](https://spiral.ai/integrations/n8n/u-s-treasury-upcoming-auctions)
- [Notion](https://spiral.ai/integrations/notion/u-s-treasury-upcoming-auctions)
- [OpenClaw](https://spiral.ai/integrations/openclaw/u-s-treasury-upcoming-auctions)
- [opencode](https://spiral.ai/integrations/opencode/u-s-treasury-upcoming-auctions)
- [Perplexity](https://spiral.ai/integrations/perplexity/u-s-treasury-upcoming-auctions)
- [Raycast](https://spiral.ai/integrations/raycast/u-s-treasury-upcoming-auctions)
- [VS Code](https://spiral.ai/integrations/vscode/u-s-treasury-upcoming-auctions)
- [Windsurf](https://spiral.ai/integrations/windsurf/u-s-treasury-upcoming-auctions)
- [Zapier](https://spiral.ai/integrations/zapier/u-s-treasury-upcoming-auctions)

## More Claude Code guides

- [U.S. Treasury interest expense](https://spiral.ai/integrations/claude-code/u-s-treasury-interest-expense)
- [UN Comtrade data availability](https://spiral.ai/integrations/claude-code/un-comtrade-data-availability)
- [U.S. Treasury historical debt outstanding](https://spiral.ai/integrations/claude-code/u-s-treasury-historical-debt-outstanding)
- [UN Comtrade dataset metadata](https://spiral.ai/integrations/claude-code/un-comtrade-dataset-metadata)
- [U.S. Treasury gold reserves](https://spiral.ai/integrations/claude-code/u-s-treasury-gold-reserves)
- [UN Comtrade historical trade totals](https://spiral.ai/integrations/claude-code/un-comtrade-historical-trade-totals)

## Questions about U.S. Treasury upcoming auctions in Claude Code

**Can Claude Code use U.S. Treasury upcoming auctions?**

Yes. Add Spiral to Claude Code as an MCP server, and Claude Code can find and run U.S. Treasury upcoming auctions like any built-in tool.

**How much does U.S. Treasury upcoming auctions cost in Claude Code?**

$0.001746 per call. You pay from your Spiral balance as you go, with no subscription, and a failed run is not charged. Your Claude Code plan is separate.

**Do I need an Alexandria account to use U.S. Treasury upcoming auctions in Claude Code?**

No. Spiral runs U.S. Treasury upcoming auctions on its own Alexandria account. You sign in to Spiral once and never paste a key.

**How long does it take to set up U.S. Treasury upcoming auctions in Claude Code?**

About two minutes: add the hosted server, then sign in.

**Does Claude Code wait while U.S. Treasury upcoming auctions runs?**

U.S. Treasury upcoming auctions runs in the background. Claude Code starts the run, checks on it and gives you the json when it's ready.

**Which Treasury securities does the data cover?**

The source covers U.S. Treasury marketable securities: bills, notes, bonds, floating rate notes, and Treasury Inflation-Protected Securities. TreasuryDirect's auction query lists FRNs with notes and TIPS with bonds, so those categories need further filtering.

**How often does Treasury update the auction dataset?**

Fiscal Data labels it as released as needed. As checked on November 20, 2026, the dataset page showed November 19, 2026 as its last update.

**How far back does Treasury's auction query go?**

TreasuryDirect documents TIPS announcement and results data from 1997 and other security types from July 27, 1998. Fields added in April 2008 and October 2026 should not be assumed available throughout that history.

**Does the upcoming auction list show the full six-month schedule?**

TreasuryDirect describes its upcoming table as auctions already announced or scheduled to be announced. Treasury publishes its tentative six-month schedule separately, usually at quarterly press conferences.

**How do reopenings affect auction comparisons?**

A reopening sells additional amounts of a previously issued security. It retains the original maturity date and coupon rate or spread but has a different issue date, so separate auction events should remain separate in comparisons.

