https://github.com/tim-hub/sanic-currency-exchange-rates-api
This is a self hosted, free, open source Python Currency Exchange Rate API fork.
https://github.com/tim-hub/sanic-currency-exchange-rates-api
currency-exchange-rates currency-rate-api exchange historical-rates opensource python restful-api sanic-project specific-exchange-rates symbols
Last synced: 7 months ago
JSON representation
This is a self hosted, free, open source Python Currency Exchange Rate API fork.
- Host: GitHub
- URL: https://github.com/tim-hub/sanic-currency-exchange-rates-api
- Owner: tim-hub
- License: mit
- Created: 2020-03-20T08:12:09.000Z (about 5 years ago)
- Default Branch: master
- Last Pushed: 2023-04-01T20:51:34.000Z (about 2 years ago)
- Last Synced: 2024-05-01T14:46:46.938Z (about 1 year ago)
- Topics: currency-exchange-rates, currency-rate-api, exchange, historical-rates, opensource, python, restful-api, sanic-project, specific-exchange-rates, symbols
- Language: Python
- Homepage: https://exchange-rate.bai.uno
- Size: 176 KB
- Stars: 22
- Watchers: 2
- Forks: 3
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
Awesome Lists containing this project
README
# Sanic Currency Exchange Rates Api
[](https://www.codefactor.io/repository/github/tim-hub/sanic-currency-exchange-rates-api)
This is a self hosted, free, currency exchange rate api, free demo
at [exchange-rate.bai.uno](https://exchange-rate.bai.uno).
The current and historical foreign exchange rates data are
from [European Central Bank](https://www.ecb.europa.eu/stats/policy_and_exchange_rates/euro_reference_exchange_rates/html/index.en.html)
.
- More about [Redis Stack](REDIS_STACK.md)
## Usage
> Latest date will be returned, if the date was not in Euro Central Bank history records
#### Latest & specific date rates
Get the latest foreign exchange rates.
```http
GET /api/latest
```
Get historical rates for any day since 1999.
```http
GET /api/2018-03-26
```
Rates are quoted against the Euro by default. Quote against a different currency by setting the base parameter in your
request.
```http
GET /api/latest?base=USD
```
Request specific exchange rates by setting the symbols parameter.
```http
GET /api/latest?symbols=USD,GBP
```
#### Rates history
Get historical rates for a time period.
```http
GET /api/history?start_at=2018-01-01&end_at=2018-09-01
```
Limit results to specific exchange rates to save bandwidth with the symbols parameter.
```http
GET /api/history?start_at=2018-01-01&end_at=2018-09-01&symbols=ILS,JPY
```
Quote the historical rates against a different currency.
```http
GET /api/history?start_at=2018-01-01&end_at=2018-09-01&base=USD
```
#### Client side usage
The primary use case is client side. For instance, with [money.js](https://openexchangerates.github.io/money.js/) in the
browser
```js
let demo = () => {
let rate = fx(1).from("GBP").to("USD")
alert("£1 = $" + rate.toFixed(4))
}
fetch('https://api.exchangeratesapi.io/latest')
.then((resp) => resp.json())
.then((data) => fx.rates = data.rates)
.then(demo)
```
## Why we need a new fork
This project is a fork from [ExchangeRatesApi project](https://github.com/exchangeratesapi/exchangeratesapi/), the
original project is great,
but as a project, is seems like they have some outdated dependencies (security issues) and difficulties to deploy.
| Difference | Original | Fork |
| ------------------- | --------------------------------------- |---------------|
| sanic version | 0.8.x | latest |
| python | 3.6 | 3.10 |
| pin dependencies | false | true |
| deploy to heroku | one click | not one click yet, but it could be deployed to heroku easily through the docker image|
| deploy as container | got some problem | easy |
| xml parser | xml.etree | defusedxml |
## Contributing
- [contributing guide](CONTRIBUTING.md)
## License
- [MIT](LICENSE)