Project

fixer

0.26
No release in over 3 years
There's a lot of open issues
A wrapper to the exchange rate feeds of the European Central Bank
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Dependencies

Development

>= 0
>= 0
 Project Readme

Frankfurter

Build

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

Deployment

Using Docker

The simplest way to run Frankfurter is with Docker:

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

Using Docker Compose

For a complete setup including PostgreSQL:

  1. Copy the docker-compose.yml file
  2. Run:
docker compose up --wait

Contributing

Frankfurter is built with Ruby. To contribute:

  1. Fork.
  2. Install dependencies with bundle install.
  3. Run tests with bundle exec rake.
  4. Push your changes to a feature branch.
  5. Open a pull request.

Roadmap

  • Infrastructure

    • Migrate from PostgreSQL to SQLite for simpler deployment.
    • Add API versioning in URL path.
  • Data Sources

    • Add support for multiple data providers.
      • IMF
      • Other central banks
  • Features

    • Add GraphQL endpoint.
    • Deploy as a blockchain oracle.