[Integrations](https://spiral.ai/integrations) › [Muse Code](https://spiral.ai/integrations/muse-code) › [U.S. Treasury auction results](https://spiral.ai/integrations/muse-code/u-s-treasury-auction-results)

# How to Use U.S. Treasury auction results in Muse Code

Returns completed Treasury auction data, including accepted yields or rates, awarded amounts, and bid-to-cover ratios. Use it to compare borrowing costs and bidding demand across auctions of the same security type and term.

|  |  |
| --- | --- |
| Model | U.S. Treasury auction results |
| 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 auction results in Muse Code

- Use U.S. Treasury auction results to build a chart in this project comparing accepted yields and bid-to-cover ratios for conventional 10-year note auctions during 2025.
- Use U.S. Treasury auction results to create a CSV export of 30-year conventional bond auctions during 2025, preserving each auction date and showing maturity dates, awarded amounts, and bid-to-cover ratios.
- Use U.S. Treasury auction results to add a comparison table for 5-year TIPS auctions during 2025, showing accepted yields, auction dates, maturity dates, and bid-to-cover ratios.
- Use U.S. Treasury auction results 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 auction results and tell me what changed since last week.

## How to set up U.S. Treasury auction results in Muse Code

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

### Use Spiral's MCP server

1. **Install Muse Code**

```bash
curl -fsSL https://dev.meta.ai/install.sh | bash
```

2. **Ask Muse to add the server**: Start `muse` and ask:

```text
Add the Spiral MCP server at https://api.spiral.ai/mcp
```

3. **Sign in**: In your terminal, run:

```bash
muse mcp login spiral
```

### Use the Spiral skill

1. **Send Muse 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 auction results**: 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/results",
    "input": {
      "sort": "<sort>"
    }
  }'
```

Then paste one of the prompts above: Muse Code finds U.S. Treasury auction results on Spiral, shows the price and runs it.

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

## U.S. Treasury auction results tools and prices

- [Treasury Fiscal Data · Auction results](https://spiral.ai/tools/alexandria/treasury-fiscal-data/auctions/results) (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 auction results in Muse 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.

### Auction demand comparisons

Compare bid-to-cover ratios and accepted yields across completed auctions of the same security type and term. Report the underlying bid and award amounts alongside the ratio where available.

## Overview

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

## U.S. Treasury auction results in other agents

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

## More Muse Code guides

- [Twelve Data symbol search](https://spiral.ai/integrations/muse-code/twelve-data-symbol-search)
- [U.S. Treasury average interest rates](https://spiral.ai/integrations/muse-code/u-s-treasury-average-interest-rates)
- [Twelve Data market quote](https://spiral.ai/integrations/muse-code/twelve-data-market-quote)
- [U.S. Treasury cash balance](https://spiral.ai/integrations/muse-code/u-s-treasury-cash-balance)
- [Twelve Data latest price](https://spiral.ai/integrations/muse-code/twelve-data-latest-price)
- [U.S. Treasury daily deposits and withdrawals](https://spiral.ai/integrations/muse-code/u-s-treasury-daily-deposits-and-withdrawals)

## Questions about U.S. Treasury auction results in Muse Code

**Can Muse Code use U.S. Treasury auction results?**

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

**How much does U.S. Treasury auction results cost in Muse 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 Muse Code plan is separate.

**Do I need an Alexandria account to use U.S. Treasury auction results in Muse Code?**

No. Spiral runs U.S. Treasury auction results 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 auction results in Muse Code?**

About two minutes: install Muse Code, then ask Muse to add the server, then sign in.

**Does Muse Code wait while U.S. Treasury auction results runs?**

U.S. Treasury auction results runs in the background. Muse 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.

