Skip to content

lineofflight/frankfurter

Repository files navigation

Frankfurter

Build

Frankfurter is a free and open-source currency data API that tracks reference exchange rates published by institutional and non-commercial sources like the European Central Bank. Check the website for a detailed walkthrough.

The API is publicly available at [https://api.frankfurter.dev][].

Deployment

Using Docker

The simplest way to run Frankfurter locally is with Docker:

docker run -d -p 80:8080 lineofflight/frankfurter

Once the container is running, open your browser and go to http://localhost.

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

  • Migrate to SQLite
  • Add API versioning in path
  • Multiple Data Sources
  • Add GraphQL endpoint
  • Deploy as a blockchain oracle

Reporting Missing Currencies

If you notice a currency missing from our data, please open an issue and include a suggested source with the missing data. We're looking for non-commercial sources like the European Central Bank that publish current and historical daily rates at the end of each working day.