frankfurter/README.md
2020-04-02 12:40:06 +01:00

1.2 KiB

Frankfurter

Build

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

I host a public instance of the API at api.frankfurter.app.

Getting Started

Get the latest exchange rates.

GET /latest HTTP/1.1

Get rates for a past date.

GET /2000-01-03 HTTP/1.1

Get rates for a period.

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

For more examples, read the docs.

Deployment

Deploy

You can self-host Frankfurter with Heroku or Docker.

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

Check out the website for a more detailed walkthrough.

Miscellaneous

Frankfurter was known as Fixer between 2012 and 2018. After selling the original domain, I relaunched under this name.