Currency Converter & Exchange Rates — for AI Agents

A real-time currency, FX and crypto conversion tool built for AI agents, LLMs and RAG pipelines. Convert between 30+ fiat currencies and thousands of cryptocurrencies with live and historical rates — the kind of data an LLM can't produce from its training set. Ideal as a tool-call / MCP grounding source for finance assistants, travel agents and chatbots.

Small, structured output — one clean record per conversion, perfect for an LLM context or an agent tool response. Works from the Apify Console, on a schedule, or via API. Callable by Claude, ChatGPT, LangChain, CrewAI, LlamaIndex and any MCP client (every Apify actor is MCP-callable via mcp.apify.com).

💱 Live rates, not stale training data. "How much is 150 EUR in USD? What's 1 BTC in EUR right now?" — the actor answers with current, sourced rates.

---

🤖 Why this is an AI-agent tool

LLMs don't know today's exchange rate. Agents fix that with a tool call to a live source. Currency conversion is one of the most frequently called agent tools:

• ✅ Live + historical — latest ECB fiat rates and any past date; real-time crypto
• ✅ Fiat + crypto in one tool — 30+ currencies and thousands of coins
• ✅ Tool-shaped — from + to + amount in, a clean converted number out
• ✅ MCP-ready — call it from any agent framework or MCP client

---

📋 What this actor does

Give it a source, one or more targets and an amount:

• ✅ Fiat ↔ fiat — e.g. EUR → USD, GBP, JPY (ECB reference rates)
• ✅ Crypto ↔ fiat — e.g. BTC → USD, ETH → EUR
• ✅ Fiat ↔ crypto — e.g. USD → BTC
• ✅ Crypto ↔ crypto — e.g. BTC → ETH
• ✅ Historical fiat rates — any date back to 1999
• ✅ 24-hour change for crypto

---

🚀 Quick start

1. Enter a From currency (e.g. EUR, USD, BTC).
2. Add one or more To currencies (e.g. USD, GBP, BTC).
3. Set an Amount (default 1) and optionally a historical Date.
4. Click Start and read the structured result from Storage → Dataset.

---

⚙️ Input

Field	Type	Description
From currency	string	Source fiat code (EUR, USD, GBP, TRY, JPY) or crypto (BTC, ETH, SOL, or a CoinGecko id like bitcoin).
To currencies	array	One or more targets, e.g. ["USD"], ["USD", "GBP", "BTC"].
Amount	integer	Amount of the source to convert. Default 1.
Historical date	string	Optional YYYY-MM-DD for a historical fiat rate. Latest if empty.
Proxy	object	Optional — the rate APIs have no anti-bot.

Example 1 — 150 EUR to several currencies

{ "from": "EUR", "to": ["USD", "GBP", "JPY"], "amount": 150 }

Example 2 — 1 BTC to USD and EUR

{ "from": "BTC", "to": ["USD", "EUR"], "amount": 1 }

Example 3 — Historical USD → EUR

{ "from": "USD", "to": ["EUR"], "amount": 100, "date": "2024-01-15" }

---

📦 Output

{
  "from": "EUR",
  "to": "USD",
  "amount": "150",
  "rate": "1.1448",
  "result": "171.72",
  "fromType": "fiat",
  "toType": "fiat",
  "change24h": null,
  "date": "2026-07-04",
  "source": "frankfurter",
  "scrapedAt": "2026-07-04T00:00:00.000Z"
}

For crypto, change24h holds the 24-hour percentage change:

{ "from": "BTC", "to": "USD", "amount": "1", "rate": "62466.00", "result": "62466.00", "toType": "fiat", "change24h": "1.05", "source": "coingecko" }

Output fields

Field	Description
from / to	Source and target currency/crypto codes.
amount / rate / result	Amount, exchange rate, and converted amount (amount × rate).
fromType / toType	fiat or crypto.
change24h	24-hour percentage change (crypto).
date	Date of the rate used.
source	frankfurter (fiat, ECB) or coingecko (crypto).

---

💱 Supported currencies

Fiat (30+, ECB): USD, EUR, GBP, JPY, CHF, AUD, CAD, CNY, HKD, SGD, INR, TRY, BRL, MXN, ZAR, PLN, SEK, NOK, DKK, KRW, IDR, PHP, THB, MYR, and more.

Crypto: BTC, ETH, USDT, BNB, SOL, XRP, USDC, ADA, DOGE, TRX, TON, DOT, MATIC, LTC, AVAX, LINK, and thousands more (use the symbol or a CoinGecko id).

---

🔌 AI & integrations

• MCP: every Apify actor is callable from mcp.apify.com — add this as a tool in Claude Desktop, VS Code or any MCP client.
• Frameworks: LangChain (ApifyActorsTool), LlamaIndex, CrewAI, Vercel AI SDK, n8n.
• API: run and fetch results with the Apify API or JS / Python clients.

---

❓ FAQ

Do I need an API key? No — both rate sources are keyless.

How fresh are the rates? Fiat rates are ECB reference rates (updated every working day); crypto is real-time.

Which historical range is supported? Fiat historical rates go back to 1999. Historical crypto uses the latest price.

Can an AI agent call this directly? Yes — it's designed as a tool-call source and is MCP-callable via Apify.

---

⚖️ Legal & responsible use

This actor uses public exchange-rate APIs (European Central Bank via Frankfurter, and CoinGecko). Respect their terms and rate limits. Rates are for information only, not financial advice.

---

🛟 Support

Need an extra currency or hit an issue? Open a ticket from the actor's Issues tab.

Happy converting! 💱