mirror of
https://github.com/hakanensari/frankfurter.git
synced 2024-11-25 12:32:30 +01:00
82 lines
1.9 KiB
Markdown
82 lines
1.9 KiB
Markdown
# Fixer.io
|
|
|
|
<img src="http://fixer.io/img/money.png" alt="fixer" width=180 align="middle">
|
|
|
|
[](https://travis-ci.org/hakanensari/fixer-io)
|
|
|
|
Fixer.io is a free JSON API for current and historical foreign exchange rates published by the European Central Bank.
|
|
|
|
The rates are updated daily around 4PM CET.
|
|
|
|
## Usage
|
|
|
|
Get the latest foreign exchange reference rates in JSON format.
|
|
|
|
```http
|
|
GET /latest
|
|
Host: api.fixer.io
|
|
```
|
|
|
|
Get historical rates for any day since 1999.
|
|
|
|
```http
|
|
GET /2000-01-03
|
|
Host: api.fixer.io
|
|
```
|
|
|
|
Rates are quoted against the Euro by default. Quote against a different currency by setting the base parameter in your request.
|
|
|
|
```http
|
|
GET /latest?base=USD
|
|
Host: api.fixer.io
|
|
```
|
|
|
|
Request specific exchange rates by setting the symbols or currencies parameter.
|
|
|
|
```http
|
|
GET /latest?symbols=USD,GBP
|
|
Host: api.fixer.io
|
|
```
|
|
|
|
Make cross-domain JSONP requests.
|
|
|
|
```http
|
|
GET /latest?callback=?
|
|
Host: api.fixer.io
|
|
```
|
|
|
|
An HTTPS endpoint is also available at [https://api.fixer.io](https://api.fixer.io).
|
|
|
|
Use [money.js](http://openexchangerates.github.io/money.js/) in the browser.
|
|
|
|
```js
|
|
var demo = function(data) {
|
|
fx.rates = data.rates
|
|
var rate = fx(1).from("GBP").to("USD")
|
|
alert("£1 = $" + rate.toFixed(4))
|
|
}
|
|
|
|
$.getJSON("http://api.fixer.io/latest", demo)
|
|
```
|
|
|
|
## Docker
|
|
|
|
You can run a local instance of the app using Docker.
|
|
|
|
Bring the stack up.
|
|
|
|
```bash
|
|
docker-compose up -d
|
|
```
|
|
|
|
Initialize the database and seed data.
|
|
|
|
```bash
|
|
docker-compose run web rake db:migrate rates:load
|
|
docker-compose restart web
|
|
```
|
|
|
|
## FAQ
|
|
### "The API returns data for a date other than the date I asked for!"
|
|
If the value of the `date`-property doesn't match the date you requested via query parameters that is due to the European Central Bank only publishing exchange rates **for working days**. In such cases, the exchange rates of the last working day are returned. [#47](https://github.com/hakanensari/fixer-io/issues/47)
|