frankfurter/README.md

# Frankfurter

[![Build](https://github.com/hakanensari/frankfurter/workflows/build/badge.svg)](https://github.com/hakanensari/frankfurter/actions)

[Frankfurter](https://www.frankfurter.app) 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.

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

For more examples, read the [docs](https://www.frankfurter.app/docs).

## Deployment

You can self-host Frankfurter with Docker.

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

## Miscellaneous

Frankfurter was known as Fixer between 2012 and 2018. After selling the original domain, I relaunched under this name.
Rebrand, serve HTML 2018-04-16 17:19:15 +02:00			`# Frankfurter`
add docker-compose instruction to README.md 2016-04-07 21:00:59 +02:00
Ditch codeclimate 2020-04-02 13:40:06 +02:00			`[![Build](https://github.com/hakanensari/frankfurter/workflows/build/badge.svg)](https://github.com/hakanensari/frankfurter/actions)`
Update README 2015-07-28 17:27:10 +02:00
Update README 2019-12-24 14:49:02 +01:00			`[Frankfurter](https://www.frankfurter.app) is a free and open-source currency data API that tracks reference exchange rates published by the European Central Bank.`
Update homepage 2018-09-11 18:59:18 +02:00
Remove Heroku deploy button 2021-04-24 22:41:08 +02:00			`api.frankfurter.app` hosts a public instance of the API.
add docker-compose instruction to README.md 2016-04-07 21:00:59 +02:00
Update README 2019-05-15 14:22:06 +02:00			`## Getting Started`
add docker-compose instruction to README.md 2016-04-07 21:00:59 +02:00
Update README 2019-05-15 14:22:06 +02:00			`Get the latest exchange rates.`
Update README 2016-04-11 15:38:28 +02:00
Remove Heroku deploy button 2021-04-24 22:41:08 +02:00			```
			`https://api.frankfurter.app/latest`
Update README 2016-04-11 15:38:28 +02:00			```

Update README 2019-05-15 14:22:06 +02:00			`Get rates for a past date.`
Update README 2016-04-11 15:38:28 +02:00
Remove Heroku deploy button 2021-04-24 22:41:08 +02:00			```
			`https://api.frankfurter.app/2000-01-03`
Update homepage 2018-09-11 18:59:18 +02:00			```

Update README 2019-05-15 14:22:06 +02:00			`Get rates for a period.`
Update homepage 2018-09-11 18:59:18 +02:00
			```http
Remove Heroku deploy button 2021-04-24 22:41:08 +02:00			`https://api.frankfurter.app/2010-01-01..2010-01-31`
Update README 2016-04-11 15:38:28 +02:00			```

Update README 2019-12-24 14:49:02 +01:00			`For more examples, read the [docs](https://www.frankfurter.app/docs).`
Get time period up to the present 2018-09-18 14:16:10 +02:00
Update README 2019-05-15 14:22:06 +02:00			`## Deployment`
Add note to README 2018-03-17 15:28:52 +01:00
Remove Heroku deploy button 2021-04-24 22:41:08 +02:00			`You can self-host Frankfurter with Docker.`
Update README 2016-04-11 15:38:28 +02:00
Update README 2019-05-15 14:22:06 +02:00			```bash
			`docker run -d -p 8080:8080 \`
			`-e "DATABASE_URL=<postgres_url>" \`
			`--name frankfurter hakanensari/frankfurter`
add docker-compose instruction to README.md 2016-04-07 21:00:59 +02:00			```
Update README 2016-04-11 15:38:28 +02:00
Update README 2019-12-24 14:49:02 +01:00			`## Miscellaneous`

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