Skip to content

Latest commit

 

History

History
77 lines (52 loc) · 1.55 KB

README.md

File metadata and controls

77 lines (52 loc) · 1.55 KB
Raw

Fixer.io

fixer

Travis

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

The rates are updated daily around 3PM CET.

Usage

Get the latest foreign exchange reference rates in JSON format.

GET /latest
Host: api.fixer.io

Get historical rates for any day since 1999.

GET /2000-01-03
Host: api.fixer.io

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
Host: api.fixer.io

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

GET /latest?symbols=USD,GBP
Host: api.fixer.io

Make cross-domain JSONP requests.

GET /latest?callback=?
Host: api.fixer.io

An HTTPS endpoint is also available at https://api.fixer.io.

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("http://api.fixer.io/latest", demo)

Docker

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