[Integrations](https://spiral.ai/integrations) › [Codex](https://spiral.ai/integrations/codex) › [U.S. Treasury average interest rates](https://spiral.ai/integrations/codex/u-s-treasury-average-interest-rates)

# How to Use U.S. Treasury average interest rates in Codex

Returns monthly average interest rates for marketable and nonmarketable Treasury securities. Use it to compare borrowing rates by security type over time; interest expense measures the dollar cost.

|  |  |
| --- | --- |
| Model | U.S. Treasury average interest rates |
| 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 average interest rates in Codex

- Use U.S. Treasury average interest rates to fetch Treasury bill and note rates for 2020 through 2024, then add a comparison chart to this project's reporting page.
- Use U.S. Treasury average interest rates to fetch total marketable debt rates for 2023 and 2024, then add a percentage-point comparison to the project's report.
- Use U.S. Treasury average interest rates 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 average interest rates and tell me what changed since last week.
- Check U.S. Treasury average interest rates and summarize what you find in three bullet points.

## How to set up U.S. Treasury average interest rates in Codex

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

### Use Spiral's MCP server

1. **Add the hosted server**

```bash
codex mcp add spiral --url https://api.spiral.ai/mcp
```

2. **Sign in**: Codex opens the browser: sign in to Spiral and click Authorize. No API key. `codex mcp list` then shows Spiral.

```bash
codex mcp login spiral
```

### Use the Spiral skill

1. **Send Codex 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 average interest rates**: 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/debt/average-interest-rates",
    "input": {
      "sort": "<sort>"
    }
  }'
```

Then paste one of the prompts above: Codex finds U.S. Treasury average interest rates on Spiral, shows the price and runs it.

Setup guide in the docs: https://spiral.ai/docs/quickstarts/codex

## U.S. Treasury average interest rates tools and prices

- [Treasury Fiscal Data · Average interest rates](https://spiral.ai/tools/alexandria/treasury-fiscal-data/debt/average-interest-rates) (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 average interest rates in Codex?

Build a federal debt chart or reporting table from Treasury observations in your project. Keep debt balances, interest percentages, and interest expense in separate series with their reporting periods attached.

### Fiscal year briefing

Explain a completed fiscal year with annual debt, the daily debt split near year-end, monthly average rates, and reported interest expense.

### Compare 2020 with 2024

Compare debt levels, public and intragovernmental holdings, average rates, and interest expense across the two years. Present the measures separately before discussing their relationship.

### Check a national debt article

Check claims about debt growth, borrowing rates, and interest costs against Treasury observations. Match each claim to a daily, monthly, or annual reporting period.

### Teach debt and borrowing costs

Build a lesson using actual Treasury figures to distinguish outstanding debt, average interest rates, and interest expense. Include the difference between total debt and debt held by the public.

### Monthly borrowing cost review

Compare changes in reported average rates with changes in monthly interest expense. Keep percentages and dollar amounts on separate charts.

## Overview

- [Alexandria](https://spiral.ai/providers/alexandria)
- [All Codex guides](https://spiral.ai/integrations/codex)

## U.S. Treasury average interest rates in other agents

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

## More Codex guides

- [U.S. Treasury auction results](https://spiral.ai/integrations/codex/u-s-treasury-auction-results)
- [U.S. Treasury cash balance](https://spiral.ai/integrations/codex/u-s-treasury-cash-balance)
- [Twelve Data symbol search](https://spiral.ai/integrations/codex/twelve-data-symbol-search)
- [U.S. Treasury daily deposits and withdrawals](https://spiral.ai/integrations/codex/u-s-treasury-daily-deposits-and-withdrawals)
- [Twelve Data market quote](https://spiral.ai/integrations/codex/twelve-data-market-quote)
- [U.S. Treasury debt issues and redemptions](https://spiral.ai/integrations/codex/u-s-treasury-debt-issues-and-redemptions)

## Questions about U.S. Treasury average interest rates in Codex

**Can Codex use U.S. Treasury average interest rates?**

Yes. Add Spiral to Codex as an MCP server, and Codex can find and run U.S. Treasury average interest rates like any built-in tool.

**How much does U.S. Treasury average interest rates cost in Codex?**

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

**Do I need an Alexandria account to use U.S. Treasury average interest rates in Codex?**

No. Spiral runs U.S. Treasury average interest rates 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 average interest rates in Codex?**

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

**Does Codex wait while U.S. Treasury average interest rates runs?**

U.S. Treasury average interest rates runs in the background. Codex starts the run, checks on it and gives you the json when it's ready.

**Where does Treasury's debt data come from?**

Fiscal Data draws from government operational systems, including debt management and summary debt accounting systems. Its coverage is public government finances; it does not provide personal financial records.

**What reporting intervals do these Treasury datasets cover?**

Debt to the Penny provides daily observations, historical debt outstanding summarizes fiscal years, and average interest rates provides monthly figures. Interest expense supplies both monthly and fiscal year-to-date amounts.

**How far back can I compare federal debt?**

Historical debt outstanding covers fiscal years from 1789 onward. It supplies total debt without the public-versus-intragovernmental breakdown available in Debt to the Penny.

**Do Treasury's combined average rates include every security type?**

The combined rates for total marketable, total nonmarketable, and total interest-bearing debt exclude TIPS and Floating Rate Notes. Keep that coverage boundary visible when discussing the government's average borrowing rate.

**Does reported interest expense mean cash paid during the month?**

Treasury describes its interest information for outstanding interest-bearing securities as calculated using modified accrual accounting. Avoid labeling every reported expense amount as a cash payment.

