Foreign exchange rates and currency conversion API
Ruby HTML Shell CSS JavaScript
Switch branches/tags
Nothing to show
Clone or download
hakanensari Implement time series
... along with some minor miscellaneous refactoring

This finally completes fixerAPI/fixer#22
Latest commit a96e568 Jul 6, 2018



Frankfurter is a free API for current and historical foreign exchange rates published by the European Central Bank.

Rates are updated around 4PM CET every working day.


Get the current foreign exchange rates.

GET /current

Get historical rates for any day since 1999.

GET /2000-01-03

Rates quote against the Euro by default. Quote against a different currency.

GET /current?from=USD

Request specific exchange rates.

GET /current?to=GBP

Change the converted amount.

GET /current?amount=100

Finally, use all the above together.

GET /current?from=EUR&to=GBP&amount=100

The primary use case is client side. For instance, with money.js in the browser

let demo = () => {
  let rate = fx(1).from("GBP").to("USD")
  alert("£1 = $" + rate.toFixed(4))

  .then((resp) => resp.json())
  .then((data) => fx.rates = data.rates)


To build locally, type

docker-compose up -d

Now you can access the API at


In production, first create a .env file based on .env.example. Then, run with

docker-compose -f docker-compose.yml -f up -d

To update to a newer image

docker-compose -f docker-compose.yml -f pull
docker-compose -f docker-compose.yml -f up -d

Within a few minutes, you will be able to access the API at