Public | Automated Build

Last pushed: a month ago
Short Description
JSON API for foreign exchange rates and currency conversion
Full Description

<img src="" alt="fixer" width=180 align="middle"> is a free JSON API for current and historical foreign exchange rates published by the European Central Bank.

The rates are updated daily around 4PM CET.


Get the latest foreign exchange reference rates in JSON format.

GET /latest

Get historical rates for any day since 1999.

GET /2000-01-03

Rates are quoted against the Euro by default. Quote against a different currency by setting the base parameter in your request.

GET /latest?base=USD

Request specific exchange rates by setting the symbols or currencies parameter.

GET /latest?symbols=USD,GBP

Make cross-domain JSONP requests.

GET /latest?callback=?

An HTTPS endpoint is also available at

Use money.js in the browser.

var demo = function(data) {
  fx.rates = data.rates
  var rate = fx(1).from("GBP").to("USD")
  alert("£1 = $" + rate.toFixed(4))

$.getJSON("", demo)


You can run a local instance of the app using Docker.

Bring the stack up.

docker-compose up -d

Initialize the database and seed data.

docker-compose run web rake db:migrate rates:load
docker-compose restart web


"The API returns data for a date other than the date I asked for!"

If the value of the date-property doesn't match the date you requested via query parameters that is due to the European Central Bank only publishing exchange rates for working days. In such cases, the exchange rates of the last working day are returned. #47

Docker Pull Command
Source Repository

Comments (0)