+4
日增长
2,106
stars
199
forks
13
watchers
418
prs
350
issues
19
releases
README
Frankfurter
Frankfurter is a free, open-source exchange rate API for over 200 currencies from over 100 central banks and official sources. Rates update daily and go back to 1948.
History coverage
GET /v2/coverage describes the default EUR-based daily blended feed. Pass the same base, quotes, and providers
filters as a rates query to get its coverage, for example /v2/coverage?base=USD"es=ZAR&providers=BIS.
Non-daily provider history remains available through explicit provider queries and does not enter the daily blend.
The existing /v2/currencies?scope=all catalogue covers eligible daily sources plus pegged currencies, while
/v2/currencies?providers=BIS describes that provider's recognized currencies. Those currency dates, and the dates
in /v2/providers, describe publication coverage. They do not establish that a requested base and quote can be
converted at the same time. Taking their minimum can advertise history that the default rates query cannot return.
For a website headline describing the default API, use start_date from /v2/coverage:
javascript
const coverage = await fetch("https://api.frankfurter.dev/v2/coverage").then(r = r.json());
const headlineYear = coverage.start_date?.slice(0, 4); // Hide the history claim when null.
Use matching filters for pair or provider pages. Both bounds are eligible observation dates at which the selected
rates query returns at least one record; they can contain gaps. A carried quote's returned date may precede the
first date its base bridge exists. The bounds do not extend history into future days merely because carry-forward
can answer them. Multiple quotes use the rates endpoint's semantics: any matching pair suffices. No queryable pair
returns null bounds. Coverage accepts only base, quotes, and providers.
Deployment
The public API runs at . If you prefer to host your own instance, you can run Frankfurter with Docker.
Using Docker
The quickest way to get started:
bash
docker run -d --init -p 8080:8080 lineofflight/frankfurter
For production, mount a volume to persist the SQLite database across container restarts and set any optional API keys:
bash
docker run -d --init -p 8080:8080 \
-e DATABASE_URL=sqlite:///app/data/frankfurter.sqlite3 \
-e BAM_API_KEY=your_key \
-e BANXICO_API_KEY=your_key \
-e BCCH_USER=your_email \
-e BCCH_PASS=your_password \
-e BOT_API_KEY=your_key \
-e FRED_API_KEY=your_key \
-e TCMB_API_KEY=your_key \
-v ./data:/app/data \
--pull always \
lineofflight/frankfurter
Without a mounted volume, the database is ephemeral and some endpoints may return empty data until their initial backfill completes.
Some data providers require API keys. All are free and optional:
- BAM_API_KEY — Bank Al-Maghrib (Morocco). Register at apihelpdesk.centralbankofmorocco.ma.
- BANXICO_API_KEY — Banco de México. Register at banxico.org.mx.
- BCCH_USER / BCCH_PASS — Banco Central de Chile. Register at si3.bcentral.cl.
- BOT_API_KEY — Bank of Thailand. Register aTop issues
#184Fixed precision in JSON numbers6 comments · 2026-02-09#639Shut up and take my money4 comments · 2026-09-09#789Add CBIC (India customs) provider1 comments · 2026-11-04#773Stale provider: CBVS1 comments · 2026-10-24#807Stale provider: BCT0 comments · 2026-11-13#803Add cash and banknote rates for TCMB, DAB and BCT0 comments · 2026-11-09
Discussions
#808Eventera: exchange rates on a zoomable history timeline0 comments · 2026-11-14#774Commercial display of daily exchange rates on digital signage2 comments · 2026-10-25#765Clarification of commercial usage rights for Frankfurter v2 blended exchange rates1 comments · 2026-10-11#687No updates / offline use2 comments · 2026-09-18#686FXpeek: dated historical rates with source-linked CSV and an MCP server0 comments · 2026-09-16#676Frankfurter API QA: Exploratory Testing & Pytest Automation1 comments · 2026-09-14#675Frankfurter v2 Exploratory Testing Observations & Questions1 comments · 2026-09-14#602How come the currency BGN is never returned?1 comments · 2026-09-08
Latest release
v2.6.1 v2.6.1 2026-10-02Changed - Retired currencies use CLDR names with year ranges instead of '(old)'. (742) Fixed - Backfill no longer skips a day at each window boundary. (739) - National Bank of the Kyrgyz Republic backfills up to today. (739) - Retired and non-ISO currency labels in CBU, BOTA, NBP and BOI history. (740) - Bank of Israel pre-euro rates published per 10, 100 or 1000 units. (740) - Legacy currencies quoted past their redenomination. (740) - Banca d'Italia's old afghani quotes, labelled AFN until April 2004. (741) - Czech National Bank backfill no longer fails when a window holds whole years. (