fixerio 0.1.1

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.