[Integrations](https://spiral.ai/integrations) › [Claude Code](https://spiral.ai/integrations/claude-code) › [Treasury reporting exchange rates](https://spiral.ai/integrations/claude-code/treasury-reporting-exchange-rates)

# How to Use Treasury reporting exchange rates in Claude Code

Returns Treasury's quarterly foreign currency reporting rates, with currency descriptions, record dates, and effective dates for amendments. Use it to check federal reporting conversions or compare historical reporting rates.

|  |  |
| --- | --- |
| Model | Treasury reporting exchange 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 Treasury reporting exchange rates in Claude Code

- Use Treasury reporting exchange rates to add a table to this project showing Canada's rates for 2024, including record and effective dates.
- Use Treasury reporting exchange rates to build a chart of Japan's reporting rates from 2020 through 2025, preserving separate amendment records.
- Use Treasury reporting exchange rates to create a CSV export in this project for Canadian dollar and Mexican peso records from 2023 through 2025.
- Use Treasury reporting exchange rates to add an amendment review view for Argentina from 2021 through 2025, showing every returned effective date.
- Use Treasury reporting exchange rates to populate this project's finance reference table with Canada's and Japan's latest available quarterly records.

## How to set up Treasury reporting exchange rates 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 Treasury reporting exchange 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/rates/exchange",
    "input": {
      "sort": "<sort>"
    }
  }'
```

Then paste one of the prompts above: Claude Code finds Treasury reporting exchange rates on Spiral, shows the price and runs it.

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

## Treasury reporting exchange rates tools and prices

- [Treasury Fiscal Data · Treasury reporting rates of exchange](https://spiral.ai/tools/alexandria/treasury-fiscal-data/rates/exchange) (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 Treasury reporting exchange rates in Claude Code?

Build a reporting rate table that preserves amendments for each currency and quarter. A coding agent can add historical comparisons and show record dates alongside effective dates in the project's finance views.

### Check a quarterly reporting rate

Retrieve Canada's published rate for a reporting quarter and show the record date and any separate effective dates beside the result.

### Review amendments before closing reports

Inspect Argentina's quarterly records for additional effective dates so a reviewer can distinguish the original rate from later amendments.

### Build a historical reporting rate chart

Chart Japan's Treasury reporting rates over several years, keeping amendments visible rather than compressing each quarter into one unexplained value.

### Prepare an audit reference table

Assemble the Canadian dollar and Mexican peso reporting rates for the quarters under review, with currency descriptions and dates.

### Monitor new reporting records

Check selected currencies for newly published quarterly records or amendments and summarize which rates and effective dates changed.

### Compare quarterly reporting changes

Calculate changes between successive Treasury reporting rates for Canada, Mexico, and Japan, labeling the results as reporting rate comparisons.

### Populate a reporting reference tool

Give finance staff a searchable table of Treasury currency descriptions, rates, record dates, and amendment effective dates.

## Overview

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

## Treasury reporting exchange rates in other agents

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

## More Claude Code guides

- [Treasury monthly budget summary](https://spiral.ai/integrations/claude-code/treasury-monthly-budget-summary)
- [Twelve Data historical prices](https://spiral.ai/integrations/claude-code/twelve-data-historical-prices)
- [Treasury buyback security details](https://spiral.ai/integrations/claude-code/treasury-buyback-security-details)
- [Twelve Data latest price](https://spiral.ai/integrations/claude-code/twelve-data-latest-price)
- [Treasury buyback operation results](https://spiral.ai/integrations/claude-code/treasury-buyback-operation-results)
- [Twelve Data market quote](https://spiral.ai/integrations/claude-code/twelve-data-market-quote)

## Questions about Treasury reporting exchange rates in Claude Code

**Can Claude Code use Treasury reporting exchange rates?**

Yes. Add Spiral to Claude Code as an MCP server, and Claude Code can find and run Treasury reporting exchange rates like any built-in tool.

**How much does Treasury reporting exchange rates 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 Treasury reporting exchange rates in Claude Code?**

No. Spiral runs Treasury reporting exchange 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 Treasury reporting exchange rates in Claude Code?**

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

**Does Claude Code wait while Treasury reporting exchange rates runs?**

Treasury reporting exchange rates runs in the background. Claude Code starts the run, checks on it and gives you the json when it's ready.

**Which currencies does Treasury cover?**

Coverage follows currencies in which the U.S. government has an interest, including those associated with receipts, disbursements, receivables, and payables. That scope does not establish coverage of every traded currency.

**How far back does the online history go?**

The dataset begins in 2001. Treasury directs users to GovInfo for exchange rates from earlier years.

**How often are reporting rates published?**

Treasury publishes them quarterly. Its financial manual says publication generally occurs on the first working day of each quarter.

**Can a currency have more than one rate in a quarter?**

Yes. Treasury issues amendments when rates deviate by at least 10%, and an amendment appears as a separate row with a new effective date.

**Are these live foreign exchange rates?**

No. These are quarterly reporting rates, and Treasury explicitly says they are not current exchange rates.

