Spiral gives your agent every tool with one account. Browse the tools →

Claude Code · Finance

How to Use ECB exchange rates in Claude Code

Get dated ECB currency reference rates quoted against the euro. Use them for currency comparisons and financial reporting research when you need daily reference observations.

Prompts to try with ECB exchange rates in Claude Code

Copy an example into Claude Code, or ask in your own words.

Use ECB exchange rates to retrieve USD, GBP, and JPY observations against the euro for October 2025, then add a dated reference table to this project's reporting output.

ECB exchange ratesClaude Code
Try asking
  • Use ECB exchange rates to retrieve USD observations against the euro for September 2025 and check whether this project's conversion calculation uses the correct currency direction.

  • Use ECB exchange rates to look this up and give me the result as a table. Save the result in ./assets.

  • Pull the latest numbers from ECB exchange rates and tell me what changed since last week.

  • Check ECB exchange rates and summarize what you find in three bullet points.

How to set up ECB 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.

    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.

    npx -y spiral-cli@latest init

Call the Spiral API

  1. Create an API key

    In the console, under API keys.

  2. Run ECB exchange rates

    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": "ecb-europa-eu/economic-data/fx_rates",
        "input": {
          "base": "<base>"
        }
      }'

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

ECB exchange rates providers and prices

Spiral runs ECB exchange rates through Alexandria. Open a card for today's price, with every fee included.

AlexandriaFinance
European Central Bank (ECB Data Portal) · Fx rates
ecb-europa-eu/economic-data/fx_rates

What can you do with ECB exchange rates in Claude Code?

Build a currency report that connects each plotted value to an identified ECB series. A coding agent can inspect the project's existing calculations, retrieve reference observations, and check currency direction and frequency.

Prepare a corporate currency reference table

Identify the euro reference series for USD, GBP, and JPY, retrieve the daily observations for a reporting month, and prepare a dated table for a corporate reporting review.

Build a currency research notebook

Find the relevant exchange rate definitions, collect daily euro reference observations, and compare them with monthly series in a reproducible analysis.

Write a monthly exchange rate brief

Locate the USD and GBP reference series, summarize their daily movements against the euro, and compare the findings with the corresponding monthly observations.

Check an existing exchange rate chart

Confirm the chart's currency direction and frequency against ECB series definitions, then compare its plotted values with daily reference rates and the identified statistical series.

Questions about ECB exchange rates in Claude Code

Can Claude Code use ECB exchange rates?

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

How much does ECB exchange rates cost in Claude Code?

$0.00873 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 ECB exchange rates in Claude Code?

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

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

Does Claude Code wait while ECB exchange rates runs?

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

When does the ECB publish currency reference rates?

The usual publication time is around 16:00 CET on working days. TARGET closing days are excluded.

How far back does euro exchange rate history go?

Daily euro exchange rate history begins on January 4, 1999. Check the selected currency's observations before assuming it covers the full period.

Are ECB exchange rates available only as daily observations?

The EXR dataset includes daily, monthly, quarterly, and annual frequencies. Choose the frequency in the series definition before comparing observations.

Can previously published ECB values change?

Yes. The ECB data service explicitly supports revised observations, so an earlier period's value can differ between retrievals.

What identifies an exact ECB statistical series?

An ECB series key starts with the dataset identifier, followed by dimensions in a defined order separated by periods. Those dimensions distinguish the requested statistic from other series in the dataset.

Get started

Start using ECB exchange rates 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 Claude Code

set up https://spiral.ai/SKILL.md
Are you an AI agent? See setup options