Where does the exchange rate data come from?

Exchange rates are sourced from official European Central Bank reference data, delivered via the Frankfurter dataset. If the primary source is temporarily unavailable, the API automatically falls back to a secondary provider (open.er-api) so your application keeps working. Every response includes a 'source' field indicating which provider served the data.

How many currencies are supported?

The API supports 30+ major world currencies, including USD, EUR, GBP, JPY, and more. You can retrieve the complete, up-to-date list of supported currency codes and their human-readable names at any time by calling the /currency/v1/currencies endpoint, which also returns a count of available currencies.

Can I get historical exchange rates?

Yes. The /currency/v1/historical endpoint lets you convert an amount using the exchange rates that were in effect on a specific past date. Simply pass a date in YYYY-MM-DD format along with the from and to currency codes and an optional amount. This is ideal for reconciling transactions, generating accurate historical reports, and auditing.

How often are exchange rates updated?

The underlying European Central Bank reference rates are published once per business day. Because rates do not change minute-to-minute, you generally only need to refresh a given currency pair once per hour at most. We recommend caching responses on your side and using the 'date' field in the response to decide when a refresh is needed.

How do I authenticate my requests?

Authentication is handled with a single API key passed as a query parameter. Append &apikey=YOUR_KEY to any request, for example /currency/v1/convert?from=USD&to=EUR&amount=100&apikey=YOUR_KEY. There are no upstream API keys to manage and no separate signing process.

What happens if a currency conversion fails?

The API returns clear, structured error responses. A 400 status indicates invalid or missing input, such as a malformed or unsupported currency code, with a descriptive error message. A 502 status indicates that the upstream FX provider failed even after the automatic fallback. Your application should validate currency codes up front and handle these errors gracefully.

Is the API fast enough for production e-commerce?

Absolutely. The Currency API runs on a global edge network with intelligently cached responses, delivering typical response times under 50ms from the location nearest your users. Combined with sensible client-side caching, this makes it well-suited for high-traffic e-commerce pricing, checkout flows, and real-time financial dashboards.

Real-time and historical FX conversion for developers

Currency API

The Currency API delivers accurate, key-free foreign-exchange conversion and exchange rates backed by official European Central Bank reference data (via Frankfurter), with an automatic secondary provider fallback so your application keeps working even when an upstream hiccups.

Convert any amount between 30+ major currencies, pull live or historical rates, and list every supported currency from a single clean JSON interface. Built on a global edge network, it answers in milliseconds with intelligently cached responses, making it ideal for e-commerce pricing, expense tracking, fintech dashboards, and back-office reconciliation.

Get a free API key Read the docs

Free tier included, no credit card required. One key works across every API.

Free calls / month: 200
Currencies: 30+
Response Time: <50ms
Uptime SLA: 99.9%

Get your free API key

200 free calls on the free plan

Key features

Real-time currency conversion between any two currencies
Latest exchange rates for any base currency
Historical conversion using rates from a specific date
Directory of all supported currency codes and names
ECB-backed reference data with automatic provider fallback
Edge-cached JSON responses for low latency worldwide
No upstream API keys, scraping, or surprise rate limits

Built for

E-commerce multi-currency pricing and checkout
Expense tracking and receipt normalization
Fintech and trading dashboards
Back-office reconciliation and accounting
Travel and booking platforms
Invoicing in customers’ local currencies
Financial reporting and analytics
Cross-border payment estimates

MCP · for your agent

Hand the Currency API to your agent

Connect Claude, Cursor or any MCP client once, then ask in plain words. Your agent finds this API, reads its docs and makes the call: 5 credits per call, the same as REST, from your team's balance.

Connect your agent

Convert an invoice total

“Globex invoiced us €4,800. What's that in US dollars at today's rate? I need it for the payment memo.”

list_apis · get_api_docsfree

api_request GET /currency/v1/convert?from=EUR&to=USD&amount=4800 5 cr

The USD amount with the exact rate and rate date used, for the payment memo.

Reimburse travel at the right rates

“Parse my London trip receipts and convert each one to USD at the exchange rate on the day it was spent.”

list_apis · get_api_docsfree

api_request GET /currency/v1/historical?date=2026-03-10&from=GBP&to=USD&amount=312.40 5 cr

+ Receipt Parser API25 cr

Each receipt in GBP and USD at its own day's rate, totaled for the reimbursement form.

Localize prices on the pricing page

“Get today's USD rates for EUR, GBP, JPY and TRY, and show me what our $29 plan comes to in each, rounded.”

list_apis · get_api_docsfree

api_request GET /currency/v1/rates?base=USD&symbols=EUR,GBP,JPY,TRY 5 cr

Today's rates and the $29 plan converted and rounded in each currency.

$ claude mcp add --transport http apicodex https://mcp.apicodex.io

Illustrative asks; the calls and prices are real. Claude, Cursor, VS Code and Windsurf setup: mcp.apicodex.io

Try it

Build the request for your data

Edit the parameters below and see the exact request and curl command you'd send. No key required to preview.

GET /currency/v1/convert

Open in Playground

Parameters

from

to

amount

apikey

Request · HTTP

GET /currency/v1/convert?from=USD&to=EUR&amount=100&apikey=YOUR_KEY HTTP/1.1
Host: api.apicodex.io

Response · JSON 200 OK

{
"from": "USD",
"to": "EUR",
"amount": 100,
"rate": 0.86081,
"result": 86.081,
"date": "2026-05-28",
"source": "frankfurter"
}

Run it with your key

Documentation

Currency API Documentation

The Currency API provides real-time and historical foreign-exchange rates and currency conversion, backed by the European Central Bank (via Frankfurter) with an automatic open.er-api fallback. It exposes four endpoints: convert, latest rates, historical conversion, and a supported-currencies directory.

Base URL

url

https://api.apicodex.io/currency

Authentication

Authenticate your requests by appending your API key as a query parameter:

headers

https://api.apicodex.io/currency/v1/convert?from=USD&to=EUR&amount=100&apikey=YOUR_KEY

Request and response

Illustrative values. Confirm current endpoint behavior, quotas, and data freshness in the API documentation before production use.

request · http

GET /currency/v1/convert?from=USD&to=EUR&amount=100&apikey=YOUR_KEY HTTP/1.1
Host: api.apicodex.io

response · json

{
"from": "USD",
"to": "EUR",
"amount": 100,
"rate": 0.86081,
"result": 86.081,
"date": "2026-05-28",
"source": "frankfurter"
}

Code examples

cURL

curl --request GET \
  --url 'https://api.apicodex.io/currency/v1/convert?from=USD&to=EUR&amount=100&apikey=YOUR_KEY'

JavaScript/Node.js

const params = new URLSearchParams({
  from: 'USD',
  to: 'EUR',
  amount: '100',
  apikey: 'YOUR_KEY'
});

const url = `https://api.apicodex.io/currency/v1/convert?${params}`;

try {
  const response = await fetch(url);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

Python

import requests

url = "https://api.apicodex.io/currency/v1/convert"

params = {
    "from": "USD",
    "to": "EUR",
    "amount": 100,
    "apikey": "YOUR_KEY"
}

response = requests.get(url, params=params)

print(response.json())

Endpoints

GET /v1/convert

Convert an amount between two currencies using the latest rates.

/v1/convert?from=USD&to=EUR&amount=100&apikey=YOUR_KEY

GET /v1/rates

Get the latest exchange rates for a base currency, optionally filtered by symbols.

/v1/rates?base=USD&symbols=EUR,GBP,JPY&apikey=YOUR_KEY

GET /v1/historical

Convert an amount using exchange rates from a specific past date.

/v1/historical?date=2024-01-15&from=USD&to=EUR&amount=100&apikey=YOUR_KEY

GET /v1/currencies

List all supported currency codes and their names.

/v1/currencies?apikey=YOUR_KEY

Query Parameters

Required parameters

from Source 3-letter currency code (e.g. USD). Required for /convert and /historical.
to Target 3-letter currency code (e.g. EUR). Required for /convert and /historical.
date Historical date in YYYY-MM-DD format. Required for /historical.

Optional parameters

amount Amount to convert. Defaults to 1. Used by /convert and /historical.
base Base 3-letter currency code for /rates. Defaults to EUR.
symbols Comma-separated list of target currency codes for /rates. Returns all currencies if omitted.
apikey Your API key, passed as a query parameter on every request.

Pricing

Currency API Pricing

This API costs 5 credits per request. Credits are shared across every API on your plan.

Estimate your monthly cost

Drag the slider to match your expected request volume. We'll recommend the cheapest plan that covers it.

Requests per month 10,000

Recommended plan

Starter

$29.99 /month

Credits used

Credits included

Cost per 1K requests

Choose Starter

Free

1,000 credits · ~200 requests/mo · 2 rps

All APIs included
No credit card required
Full documentation and examples
MCP server for your AI agents
Up to 5 active API keys

Start for free

Starter

Popular

$29.99 /month

50,000 credits · ~10,000 requests/mo · 10 rps

All APIs included
Email support
Usage dashboard and analytics
MCP server for your AI agents
Up to 5 active API keys

Start with Starter

Pro

$99.99 /month

250,000 credits · ~50,000 requests/mo · 25 rps

All APIs included
Priority support
MCP server for your AI agents
Up to 5 active API keys

Start with Pro

FAQ

Currency API

Key features

Built for

Hand the Currency API to your agent

Convert an invoice total

Reimburse travel at the right rates

Localize prices on the pricing page

Build the request for your data

Currency API Documentation

Base URL

Authentication

Request and response

Code examples

Endpoints

GET /v1/convert

GET /v1/rates

GET /v1/historical

GET /v1/currencies

Query Parameters

Required parameters

Optional parameters

Currency API Pricing

Free

Starter

Pro

Need a different plan?

Frequently asked questions

Related APIs