Frankfurter Exchange rate and currency API
Frankfurter is a free exchange rate API for 219 currencies and 39 other assets from 112 central banks and official sources. Rates update throughout the day. Daily history goes back to 1948.
The public API lives at api.frankfurter.dev. You don't need an API key. The project is open source, so you can also self-host for full control.
These are reference rates, not live market quotes. Each source publishes them once or a few times a day.
Working with an AI agent? Point it at llms.txt, or add the MCP server.
Rates
Fetch the latest exchange rates.
curl https://api.frankfurter.dev/v2/rates
Change the base currency with base.
curl https://api.frankfurter.dev/v2/rates?base=usd
Filter target currencies with quotes.
curl https://api.frankfurter.dev/v2/rates?quotes=usd,gbp
Historical Rates
Look up rates for a specific date.
curl https://api.frankfurter.dev/v2/rates?date=1999-01-04
Time Series
Fetch rates over a period with from and to.
curl https://api.frankfurter.dev/v2/rates?from=2026-01-01"es=usd
Tip: Narrowing down currencies keeps responses small. For large date ranges, request NDJSON to stream results line by line.
Grouping
Downsample a time series with group. Supports week and month.
curl https://api.frankfurter.dev/v2/rates?from=2026-01-01&group=month
Filtering by Provider
Scope to specific providers with providers.
curl https://api.frankfurter.dev/v2/rates?providers=ecb
By default, rates are blended across all providers. See
Methodology for how they're calculated. Use providers to get rates from a specific provider, or use
provider routes to query a provider
directly.
Some providers publish more than one dataset, such as NBP's daily and weekly tables. A provider key selects its default datasets. A dataset key selects just one.
curl https://api.frankfurter.dev/v2/rates?providers=nbp.b&base=pln"es=ars,ngn
Provider Attribution
Add expand=providers to see which providers contributed to each
blended rate.
curl https://api.frankfurter.dev/v2/rates?expand=providers
Each row gains a providers array. Each entry has the
provider's key, observation date, and
rate, plus excluded: true if it was left out of
the average. Pegged currencies take their rate from the peg, so every entry
is excluded. Rows built from a peg that no provider quotes omit the field.
CSV Output
Rates are also available as CSV. Append .csv to the path or set
the Accept header to text/csv.
curl https://api.frankfurter.dev/v2/rates.csv
NDJSON Output
For large responses, request
NDJSON
(newline-delimited JSON) by setting the Accept header to
application/x-ndjson. Each line is one independent JSON object,
useful for streaming large time series without buffering the entire
response.
curl https://api.frankfurter.dev/v2/rates?from=2026-01-01
Rate
Get the rate for a single currency pair. Optionally add date or
providers.
curl https://api.frankfurter.dev/v2/rate/eur/usd
Currencies
Get available currencies with provider coverage.
curl https://api.frankfurter.dev/v2/currencies
Include legacy currencies with scope.
curl https://api.frankfurter.dev/v2/currencies?scope=all
Currency
Get details and provider coverage for a single currency.
curl https://api.frankfurter.dev/v2/currency/eur
Providers
List the providers behind the API.
curl https://api.frankfurter.dev/v2/providers
Get details for a single provider.
curl https://api.frankfurter.dev/v2/providers/ecb
Each provider lists its datasets, with their own dates, schedule and currencies.
Rates by Provider
Query rates directly from a specific provider. Supports the same
parameters as /v2/rates and /v2/rate.
curl https://api.frankfurter.dev/v2/providers/ecb/rates
Fetch a single currency pair from that provider.
curl https://api.frankfurter.dev/v2/providers/ecb/rate/eur/usd
Combine with date, date ranges (from and to),
or grouping. Formats like .csv and ndjson work here too.
curl https://api.frankfurter.dev/v2/providers/ecb/rates?date=2024-05-15
Conversion
There's no conversion endpoint. Fetch the rate and convert in a few lines of code.
function convert(base, quote, amount) {
const api = "https://api.frankfurter.dev";
return fetch(`${api}/v2/rate/${base}/${quote}`)
.then((r) => r.json())
.then((d) => (amount * d.rate).toFixed(2));
}
convert("eur", "usd", 10).then((result) =>
alert(`10 EUR = ${result} USD`)
);
Errors
The API returns standard HTTP status codes with a JSON body.
{
"status": 422,
"message": "invalid currency: ABC"
}
400- Invalid parameter or malformed request.
404- Currency, rate, or resource not found.
422- Request understood but cannot be processed.
Self-Hosting
You can self-host with Docker. See the deploy guide for production setup and API key configuration.
FAQ
- Who is Frankfurter for (and who is it not for)?
- It works well for SaaS billing, e-commerce, ERP and accounting systems, and academic research across historical series back to 1948. For tax reporting and other compliance work, use a specific provider's official rates. It isn't built for live trading, or for exotic currencies with wild intraday swings.
- Is the API free for commercial use?
- Yes, including in paid products and the reports and exports they produce. Blended rates are Frankfurter's own calculation, so provider terms don't carry over to them. Provider endpoints, and the figures each provider publishes, remain subject to that provider's terms.
- Can I store or cache rates in my own database?
-
Yes, and keep them as long as you like. Caching keeps API traffic light,
so it's encouraged.
Blended rates can shift slightly as new data comes in,
so for audit records, store the rate, its date, and the
expand=providersoutput. The per-provider rates in that output are each provider's data, so republishing them falls under that provider's terms. - Do I need to credit Frankfurter?
- No, but it's appreciated. A line like “Exchange rates: Frankfurter (frankfurter.dev)” next to converted amounts or in a report's source note works well.
- Does the API have any call limits?
- There are no quotas. Requests are rate-limited to prevent abuse, but there are no monthly or daily caps. For high-volume use, consider caching responses, self-hosting, or querying the datasets directly.
- Does the public API have an SLA or uptime guarantee?
- No, but it's fine for production use if you cache responses. If you need guarantees, self-host it.
- Does the API support GraphQL?
-
No. The REST API is simple enough that GraphQL would add complexity
without much benefit. It would also break edge caching, which keeps the
API fast. Use query parameters like
base,quotes, andfrom/toto get exactly the data you need. - Is the v1 API being retired?
- No. The v1 API is deprecated in favor of v2, but remains available indefinitely. See the v1 documentation. For European Central Bank data, use /v2/providers/ecb/rates.
- What is the privacy policy of the API?
- The API doesn't collect or log personal data, IP addresses, or request URLs. The public instance runs behind Cloudflare for caching and DDoS defense, which only provides aggregate traffic stats.
- Do I need to disclose the API in App Store or Google Play privacy labels?
- No. Because queries are anonymous and no request logs are retained, requests qualify as Data Not Collected under Apple and Google Play guidelines.
- Where can I report a bug or ask a question?
- Open an issue to report a bug, request a feature, or suggest a new provider. Use Discussions to ask questions or share a library or tool you built with Frankfurter.
- How accurate are the rates?
- For compliance (tax and accounting), filter by a specific provider to get official reference rates. For general use, the default blended rates work well, though the last decimal places may shift as new data comes in. The methodology explains how blends are built and when they change.
- Are rates mid, bid, or ask?
- The API returns mid-market rates. When a provider publishes bid and ask quotes instead of a reference rate, Frankfurter stores both and calculates the midpoint.
- Are all exchange rates daily?
-
Almost all are. Some sources provide weekly, monthly, or quarterly observations. These sources are excluded from the blended feed. Query them directly with the
providersfilter. - Does every currency go back to 1948?
-
No. The US dollar does, but most currencies start in the 1990s or
later, depending on their providers. Each
currency page shows its range, as does
/v2/currencies. - Do you have precious metal or crypto rates?
-
Yes. Several central banks publish daily rates for gold (
XAU), silver (XAG), platinum (XPT), and palladium (XPD) per troy ounce. For crypto, we limit the list to coins with CME futures or a CME CF Reference Rate (likeBTC,ETH,SOL, andXRP), plusUSDTandUSDC. Only a few sources carry crypto, so coverage is thin. - Why do some old and new currencies have overlapping dates?
-
Some providers backdate replacement currencies into the old currency's
period (for example,
TRLends in 2010 whileTRYstarts in 1996). We record provider data as is, and only filter out overlaps when blending. - Why Frankfurter?
-
Because our original data source is located in the city of Frankfurt.