Permalink
Find file
ae0e9a0 Apr 12, 2016
@hakanensari @0x46616c6b
78 lines (52 sloc) 1.55 KB

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