A Python client for Fixer.io
Project description
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 3PM CET.
Installation
Install fixerio with:
pip install fixerio
Or with:
easy_install fixerio
Or you can get the source from GitHub at https://github.com/amatellanes/fixerio.
Usage
Get the latest foreign exchange reference rates in JSON format.
>>> from fixerio import Fixerio >>> fxrio = Fixerio() >>> fxrio.latest() ''' {u'base': u'EUR', u'date': u'2016-05-27', u'rates': {u'AUD': 1.5483, u'BGN': 1.9558, u'BRL': 4.031, u'CAD': 1.456, u'CHF': 1.1068, u'CNY': 7.3281, u'CZK': 27.028, u'DKK': 7.4367, u'GBP': 0.76245, u'HKD': 8.6735, u'HRK': 7.4905, u'HUF': 314.21, u'IDR': 15157.25, u'ILS': 4.2938, u'INR': 74.867, u'JPY': 122.46, u'KRW': 1316.98, u'MXN': 20.6611, u'MYR': 4.5554, u'NOK': 9.282, u'NZD': 1.6586, u'PHP': 52.096, u'PLN': 4.3912, u'RON': 4.5034, u'RUB': 73.7516, u'SEK': 9.2673, u'SGD': 1.536, u'THB': 39.851, u'TRY': 3.2928, u'USD': 1.1168, u'ZAR': 17.4504}} '''
Get historical rates for any day since 1999.
>>> import datetime >>> from fixerio import Fixerio >>> today = datetime.date.today() >>> fxrio = Fixerio() >>> fxrio.historical_rates(today) ''' {u'base': u'EUR', u'date': u'2016-05-27', u'rates': {u'AUD': 1.5483, u'BGN': 1.9558, u'BRL': 4.031, u'CAD': 1.456, u'CHF': 1.1068, u'CNY': 7.3281, u'CZK': 27.028, u'DKK': 7.4367, u'GBP': 0.76245, u'HKD': 8.6735, u'HRK': 7.4905, u'HUF': 314.21, u'IDR': 15157.25, u'ILS': 4.2938, u'INR': 74.867, u'JPY': 122.46, u'KRW': 1316.98, u'MXN': 20.6611, u'MYR': 4.5554, u'NOK': 9.282, u'NZD': 1.6586, u'PHP': 52.096, u'PLN': 4.3912, u'RON': 4.5034, u'RUB': 73.7516, u'SEK': 9.2673, u'SGD': 1.536, u'THB': 39.851, u'TRY': 3.2928, u'USD': 1.1168, u'ZAR': 17.4504}} '''
Rates are quoted against the Euro by default. Quote against a different currency by setting the base parameter in your request.
>>> from fixerio import Fixerio >>> fxrio = Fixerio(base='USD') >>> fxrio.latest() ''' {u'base': u'USD', u'date': u'2016-05-27', u'rates': {u'AUD': 1.3864, u'BGN': 1.7513, u'BRL': 3.6094, u'CAD': 1.3037, u'CHF': 0.99105, u'CNY': 6.5617, u'CZK': 24.201, u'DKK': 6.6589, u'EUR': 0.89542, u'GBP': 0.68271, u'HKD': 7.7664, u'HRK': 6.7071, u'HUF': 281.35, u'IDR': 13572.0, u'ILS': 3.8447, u'INR': 67.037, u'JPY': 109.65, u'KRW': 1179.2, u'MXN': 18.5, u'MYR': 4.079, u'NOK': 8.3112, u'NZD': 1.4851, u'PHP': 46.648, u'PLN': 3.9319, u'RON': 4.0324, u'RUB': 66.038, u'SEK': 8.2981, u'SGD': 1.3754, u'THB': 35.683, u'TRY': 2.9484, u'ZAR': 15.625}} '''
>>> from fixerio import Fixerio >>> fxrio = Fixerio() >>> fxrio.latest(base='USD') ''' {u'base': u'USD', u'date': u'2016-05-27', u'rates': {u'AUD': 1.3864, u'BGN': 1.7513, u'BRL': 3.6094, u'CAD': 1.3037, u'CHF': 0.99105, u'CNY': 6.5617, u'CZK': 24.201, u'DKK': 6.6589, u'EUR': 0.89542, u'GBP': 0.68271, u'HKD': 7.7664, u'HRK': 6.7071, u'HUF': 281.35, u'IDR': 13572.0, u'ILS': 3.8447, u'INR': 67.037, u'JPY': 109.65, u'KRW': 1179.2, u'MXN': 18.5, u'MYR': 4.079, u'NOK': 8.3112, u'NZD': 1.4851, u'PHP': 46.648, u'PLN': 3.9319, u'RON': 4.0324, u'RUB': 66.038, u'SEK': 8.2981, u'SGD': 1.3754, u'THB': 35.683, u'TRY': 2.9484, u'ZAR': 15.625}} '''
Request specific exchange rates by setting the symbols parameter.
>>> from fixerio import Fixerio >>> fxrio = Fixerio(symbols=['USD', 'GBP']) >>> fxrio.latest() ''' {u'base': u'EUR', u'date': u'2016-05-27', u'rates': {u'GBP': 0.76245, u'USD': 1.1168}} '''
>>> from fixerio import Fixerio >>> fxrio = Fixerio() >>> fxrio.latest(symbols=['USD', 'GBP']) ''' {u'base': u'EUR', u'date': u'2016-05-27', u'rates': {u'GBP': 0.76245, u'USD': 1.1168}} '''
An HTTPS endpoint is available.
>>> from fixerio import Fixerio >>> fxrio = Fixerio(secure=True) >>> fxrio.latest() ''' {u'base': u'EUR', u'date': u'2016-05-27', u'rates': {u'AUD': 1.5483, ... '''
>>> from fixerio import Fixerio >>> fxrio = Fixerio() >>> fxrio.latest(secure=True) ''' {u'base': u'EUR', u'date': u'2016-05-27', u'rates': {u'AUD': 1.5483, ... '''
All exceptions that fixerio explicitly raises are fixerio.exceptions.FixerioException.
Release History
0.1.1 (2016-06-16)
- Initial version.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for fixerio-0.1.1-py2.py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | c443790a984499df86c2173d660d2db540e53a30cc7bc0858771d9b1aae5fd5d |
|
MD5 | dfdf3704ef01817fa255c2c521114112 |
|
BLAKE2-256 | 1d3aabc7461f7e44d97259cd5663abc97e088bb59542c22c948d8ee80de9eb18 |