A Python client for `Fixer API`_
|Build Status| |Coverage Status| |Supports Wheel format| |Latest PyPI version| |Documentation Status| |Requirements Status|
`Fixer API`_ (formerly known as 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 3 pm CET.
Install fixerio
with:
pip install fixerio-client
Or with:
easy_install fixerio-client
Or you can get the source from GitHub at https://github.com/xsaren11/fixerio.
Get the latest foreign exchange reference rates in JSON format.
>>> from fixerio import Fixerio
>>> fxrio = Fixerio(access_key='YOUR ACCESS KEY')
>>> fxrio.latest()
'''
{'base': 'EUR',
'date': '2016-05-27',
'rates': {'AUD': 1.5483,
'BGN': 1.9558,
'BRL': 4.031,
'CAD': 1.456,
'CHF': 1.1068,
'CNY': 7.3281,
'CZK': 27.028,
'DKK': 7.4367,
'GBP': 0.76245,
'HKD': 8.6735,
'HRK': 7.4905,
'HUF': 314.21,
'IDR': 15157.25,
'ILS': 4.2938,
'INR': 74.867,
'JPY': 122.46,
'KRW': 1316.98,
'MXN': 20.6611,
'MYR': 4.5554,
'NOK': 9.282,
'NZD': 1.6586,
'PHP': 52.096,
'PLN': 4.3912,
'RON': 4.5034,
'RUB': 73.7516,
'SEK': 9.2673,
'SGD': 1.536,
'THB': 39.851,
'TRY': 3.2928,
'USD': 1.1168,
'ZAR': 17.4504}}
'''
Get historical rates for any day since 1999.
>>> import datetime
>>> from fixerio import Fixerio
>>> today = datetime.date.today()
>>> fxrio = Fixerio(access_key='YOUR ACCESS KEY')
>>> fxrio.historical_rates(today)
'''
{'base': 'EUR',
'date': '2016-05-27',
'rates': {'AUD': 1.5483,
'BGN': 1.9558,
'BRL': 4.031,
'CAD': 1.456,
'CHF': 1.1068,
'CNY': 7.3281,
'CZK': 27.028,
'DKK': 7.4367,
'GBP': 0.76245,
'HKD': 8.6735,
'HRK': 7.4905,
'HUF': 314.21,
'IDR': 15157.25,
'ILS': 4.2938,
'INR': 74.867,
'JPY': 122.46,
'KRW': 1316.98,
'MXN': 20.6611,
'MYR': 4.5554,
'NOK': 9.282,
'NZD': 1.6586,
'PHP': 52.096,
'PLN': 4.3912,
'RON': 4.5034,
'RUB': 73.7516,
'SEK': 9.2673,
'SGD': 1.536,
'THB': 39.851,
'TRY': 3.2928,
'USD': 1.1168,
'ZAR': 17.4504}}
'''
Request specific exchange rates by setting the symbols
parameter.
>>> from fixerio import Fixerio
>>> fxrio = Fixerio(access_key='YOUR ACCESS KEY', symbols=['USD', 'GBP'])
>>> fxrio.latest()
'''
{'base': 'EUR',
'date': '2016-05-27',
'rates': {'GBP': 0.76245, 'USD': 1.1168}}
'''
>>> from fixerio import Fixerio
>>> fxrio = Fixerio(access_key='YOUR ACCESS KEY')
>>> fxrio.latest(symbols=['USD', 'GBP'])
'''
{'base': 'EUR',
'date': '2016-05-27',
'rates': {'GBP': 0.76245, 'USD': 1.1168}}
'''