[Integrations](https://spiral.ai/integrations) › [Instinct](https://spiral.ai/integrations/instinct) › [Treasury reporting exchange rates](https://spiral.ai/integrations/instinct/treasury-reporting-exchange-rates)

# How to Use Treasury reporting exchange rates in Instinct

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, with a Spiral API key |

## Prompts to try with Treasury reporting exchange rates in Instinct

- Every week, use Treasury reporting exchange rates to check Canada for new records and report any new rate with its record and effective dates.
- Each business day, use Treasury reporting exchange rates to check Argentina for newly added amendment records and notify me only when a record changes.
- At the start of each month, use Treasury reporting exchange rates to summarize newly available records for the Canadian dollar and Mexican peso.
- Every week, use Treasury reporting exchange rates to check Japan and report whether a new quarterly record or effective date has appeared.
- Each quarter, use Treasury reporting exchange rates to compare Canada's and Japan's newly published reporting rates with the preceding quarter.

## How to set up Treasury reporting exchange rates in Instinct

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

### Use the Spiral skill

1. **Send Instinct 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 Spiral's MCP server

1. **Create an API key**: In the console, open API keys and create a key for Instinct. Copy it.

2. **Send Instinct this message**: Instinct reads Spiral's skill and asks for your API key.

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

3. **Give Instinct the key**: When Instinct asks for the key, add it where Instinct keeps secrets, never in the chat itself.

### 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: Instinct finds Treasury reporting exchange rates on Spiral, shows the price and runs it.

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

## 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 Instinct?

Receive a notice when Treasury adds a reporting rate or amendment for a watched currency. A scheduled agent can compare returned records with its previous results and report the currency, rate, and effective date.

### 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 Instinct guides](https://spiral.ai/integrations/instinct)

## 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)
- [Claude Code](https://spiral.ai/integrations/claude-code/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)
- [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 Instinct guides

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

## Questions about Treasury reporting exchange rates in Instinct

**Can Instinct use Treasury reporting exchange rates?**

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

**How much does Treasury reporting exchange rates cost in Instinct?**

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

**Do I need an Alexandria account to use Treasury reporting exchange rates in Instinct?**

You need no Alexandria account. Instinct uses one Spiral API key for every tool, and Spiral runs Treasury reporting exchange rates on its own Alexandria account.

**How long does it take to set up Treasury reporting exchange rates in Instinct?**

About two minutes: create an API key, then send Instinct this message, then give Instinct the key.

**Does Instinct wait while Treasury reporting exchange rates runs?**

Treasury reporting exchange rates runs in the background. Instinct 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.

