Go to file
2019-05-12 11:59:51 +01:00
bin Move migration to top of unicorn config file 2019-04-27 14:57:27 +01:00
config Move migration to top of unicorn config file 2019-04-27 14:57:27 +01:00
db/migrate Denormalise database schema 2018-10-07 01:08:45 +01:00
lib Allow domain root in robots.txt 2019-05-12 11:59:51 +01:00
spec Handle interval where base is missing on older dates 2019-05-02 20:36:35 +01:00
.dockerignore Minor tweaks 2018-10-18 13:34:21 +01:00
.env.example Rebrand, serve HTML 2018-06-08 15:32:52 +01:00
.eslintrc Rebrand, serve HTML 2018-06-08 15:32:52 +01:00
.gitignore Update homepage 2018-09-11 17:59:42 +01:00
.rubocop.yml Handle interval where base is missing on older dates 2019-05-02 20:36:35 +01:00
.ruby-version Update runtime and gems 2019-04-25 16:37:56 +01:00
.travis.yml Update runtime and gems 2019-04-25 16:37:56 +01:00
app.json Add Deploy to Heroku button 2018-10-07 01:08:45 +01:00
config.ru Rebrand, serve HTML 2018-06-08 15:32:52 +01:00
docker-compose.override.yml Implement fork-based daemon for scheduling jobs 2018-10-07 01:08:45 +01:00
docker-compose.prod.yml Implement fork-based daemon for scheduling jobs 2018-10-07 01:08:45 +01:00
docker-compose.yml Implement fork-based daemon for scheduling jobs 2018-10-07 01:08:45 +01:00
Dockerfile Install new Bundler in Dockerfile 2019-04-25 16:49:27 +01:00
Gemfile Add Rubocop Performance gem 2019-05-02 20:35:03 +01:00
Gemfile.lock Add Rubocop Performance gem 2019-05-02 20:35:03 +01:00
LICENSE Remove dates from license 2017-01-03 12:44:13 +00:00
limit_req.conf Repack app 2018-03-08 23:51:36 +00:00
Procfile Add Deploy to Heroku button 2018-10-07 01:08:45 +01:00
Rakefile Repack app 2018-03-08 23:51:36 +00:00
README.md Minor tweaks 2018-10-18 13:34:21 +01:00

Frankfurter

Deploy

Frankfurter is a free and open source API for current and historical foreign exchange rates. It tracks data published by the European Central Bank. Rates update around 4PM CET every working day.

Use our public instance or self host with Heroku or Docker.

Examples

Get the current foreign exchange rates.

GET /latest HTTP/1.1

Get historical rates for any day since 1999.

GET /2000-01-03 HTTP/1.1

Get historical rates for a time period.

GET /2010-01-01..2010-01-31 HTTP/1.1

Get historical rates for a time period up to the present.

GET /2010-01-01.. HTTP/1.1

Get a list of available currency symbols, along with their full names.

GET /currencies HTTP/1.1

Rates quote against the Euro by default. Quote against a different currency.

GET /latest?from=USD HTTP/1.1

Request specific exchange rates.

GET /latest?to=USD,GBP HTTP/1.1

Convert a specific amount.

GET /latest?amount=1000&from=GBP&to=USD HTTP/1.1

With a full list of currencies, time series grow large in size. For better performance, use the to parameter to reduce the response weight.

GET /2016-01-01..2016-12-31?from=GBP&to=USD HTTP/1.1

Here we return the current GBP/USD currency pair with JavaScript.

// Fetch and display GBP/USD
fetch('/latest?from=GBP&to=USD')
  .then(resp => resp.json())
  .then((data) => { alert(`GBPUSD = ${data.rates.USD}`); });

Cache data whenever possible.