Go to file
2024-11-20 14:58:17 +01:00
.github/workflows Spring cleaning 2024-11-20 14:14:27 +01:00
bin Spring cleaning 2024-11-20 14:14:27 +01:00
config Spring cleaning 2024-11-20 14:14:27 +01:00
db/migrate Spring cleaning 2024-11-20 14:14:27 +01:00
lib Ensure consistent ordering by date and ISO code 2024-11-20 14:58:17 +01:00
spec Remove simplecov 2024-11-20 14:45:40 +01:00
.dockerignore Use or infer from .ruby-version 2021-05-12 13:12:21 +01:00
.env.example Rebrand, serve HTML 2018-06-08 15:32:52 +01:00
.gitignore Clean up ignores 2019-12-20 01:02:07 +00:00
.rubocop_todo.yml Fix rubocop offenses 2023-02-28 16:49:48 +00:00
.rubocop.yml Spring cleaning 2024-11-20 14:14:27 +01:00
.ruby-version Bump ruby and gems 2024-10-03 22:17:17 +02:00
CHANGELOG.md Root returns link to docs 2020-05-02 19:38:36 +01:00
config.ru Spring cleaning 2024-11-20 14:14:27 +01:00
docker-compose.yml feat: add a docker-compose.yml with included database for more convenient self-hosting 2024-11-17 22:21:13 +01:00
Dockerfile Fix Dockerfile 2024-10-03 22:22:42 +02:00
Gemfile Remove simplecov 2024-11-20 14:45:40 +01:00
Gemfile.lock Remove simplecov 2024-11-20 14:45:40 +01:00
LICENSE Remove dates from license 2017-01-03 12:44:13 +00:00
Rakefile Spring cleaning 2024-11-20 14:14:27 +01:00
README.md feat: add a docker-compose.yml with included database for more convenient self-hosting 2024-11-17 22:21:13 +01:00

Frankfurter

Build

Frankfurter is a free and open-source currency data API that tracks reference exchange rates published by the European Central Bank.

api.frankfurter.app hosts a public instance of the API.

Getting Started

Get the latest exchange rates.

https://api.frankfurter.app/latest

Get rates for a past date.

https://api.frankfurter.app/2000-01-03

Get rates for a period.

https://api.frankfurter.app/2010-01-01..2010-01-31

Deployment

You can self-host Frankfurter with Docker.

docker run -d -p 8080:8080 \
  -e "DATABASE_URL=<postgres_url>" \
  --name frankfurter hakanensari/frankfurter

Alternatively, copy the docker-compose.yml file to your system, and in the same directory run:

docker compose up --wait 

This will also setup and host the PostgreSQL for Frankfurter.