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.
Prompts to try with U.S. Treasury upcoming auctions in Claude Code
Copy an example into Claude Code, or ask in your own words.
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
- Add the hosted server
This adds Spiral to the current project. Add --scope user to use it in every project.
claude mcp add --transport http spiral https://api.spiral.ai/mcp
- 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
- Send Claude Code this message
Your agent reads Spiral's skill and sets itself up.
set up https://spiral.ai/SKILL.md
- Sign in or paste a key
Approve Spiral in the browser, or give the agent a key from the console.
Use the Spiral CLI
- Install and sign in
Installs the Spiral CLI, signs you in and adds its skill to your coding agents.
npx -y spiral-cli@latest init
Call the Spiral API
- Create an API key
In the console, under API keys.
- Run U.S. Treasury upcoming auctions
One request; the result comes back by polling or a webhook.
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.
U.S. Treasury upcoming auctions providers and prices
Spiral runs U.S. Treasury upcoming auctions through Alexandria. Open a card for today's price, with every fee included.
Settings you can ask for
Ask Claude Code for any of these in your prompt.
| Setting | Allowed values | Default | Description |
|---|---|---|---|
| Page[size] | a number up 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] | a number | 1 | Page number, 1-indexed. |
Every API field of Treasury Fiscal Data · Upcoming auctions is on its tool page: open its card above.
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.
More on U.S. Treasury upcoming auctions and Claude Code
Overview
U.S. Treasury upcoming auctions in other agents
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.
Start using U.S. Treasury upcoming auctions in Claude Code
One Spiral account for every tool your agent needs. No subscription; you pay per run.
Paste this into Claude Code:
set up https://spiral.ai/SKILL.md


