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.

Installation

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.

Usage

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}}
'''