Skip to main content

openexchangerates.org python API client

Project description

This is a simple python client implementation of https://openexchangerates.org web services.

Install

openexchangerates is avaiable on pypi repositories. Just simply install by using easy_install or pip:

$ pip install openexchangerates

Usage

First of all, you have to sign up the service for an API key by visiting https://openexchangerates.org

Then it is a matter of cake to start using the service:

>>> from openexchangerates import OpenExchangeRatesClient
>>> client = OpenExchangeRatesClient('<YOUR_API_KEY>')
>>> client.currencies()
{'AED': 'United Arab Emirates Dirham',
'AFN': 'Afghan Afghani',
'ALL': 'Albanian Lek',
'AMD': 'Armenian Dram',
'ANG': 'Netherlands Antillean Guilder',
'AOA': 'Angolan Kwanza',
'ARS': 'Argentine Peso',
'AUD': 'Australian Dollar',
...

>>> client.latest()
{'base': 'USD',
'disclaimer': '<disclaimer>',
'license': '<license>',
'rates': {'AED': 3.672701,
    'AFN': 51.621833,
    'ALL': 104.032,
    'AMD': 406.489997,
    'ANG': 1.7888,
    'AOA': 95.936967,
    'ARS': 4.995484,
    'AUD': 0.966637,
    ...

You are also free to select base currency (Supported by non-free licenses):

>>> client.latest(base='GBP')
{'base': 'GBP',
'disclaimer': '<disclaimer>',
'license': '<license>',
'rates': {'AED': 3.672701,
    'AFN': 51.621833,
    'ALL': 104.032,
    'AMD': 406.489997,
    'ANG': 1.7888,
    'AOA': 95.936967,
    'ARS': 4.995484,
    'AUD': 0.966637,
    ...

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

openexchangerates-0.1.1.tar.gz (4.2 kB view hashes)

Uploaded Source

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page