1.6 KiB
Fixer
Fixer is a free API for current and historical foreign exchange rates published by the European Central Bank.
A public instance of the API lives at https://api.fixer.io. Alternatively, you can run privately with the provided Docker image.
Rates are updated around 4PM CET every working day.
Usage
Get the latest foreign exchange rates.
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 parameter.
GET /latest?symbols=USD,GBP
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))
}
fetch('https://api.fixer.io/latest')
.then((resp) => resp.json())
.then((data) => fx.rates = data.rates)
.then(demo)
Installation
To run locally with Docker, type
docker-compose up -d
Now you can access the API at
http://localhost:8080
In production, create a .env file in the project root and run with
docker-compose -f docker-compose.yml -f docker-compose.prod.yml up -d