Skip to content

A foreign exchange rates and currency conversion API

License

Notifications You must be signed in to change notification settings

brunosaboia/fixer-io

 
 

Repository files navigation

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

About

A foreign exchange rates and currency conversion API

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Ruby 79.1%
  • Shell 20.9%