currency-open-exchange

Currency conversion

Quickstart

Install currency_open_exchange:

pip install currency-open-exchange

Then use it in a project:

import currency_open_exchange

In order to save exchange rates to your database, add currency_open_exchange to your INSTALLED_APPS in your project's settings:

INSTALLED_APPS = (
    ...
    'currency_open_exchange',
    ...
)

Setup the Open Exchange Rates backend

Open an account at https://openexchangerates.org/ if you don't have one already. Then, add this to your project's settings:

'EXCHANGE_APP_ID': 'YOUR APP ID HERE',
'EXCHANGE_BASE_CURRENCY': 'USD' (optional, only USD for free accounts)

For more information on the Open Exchange Rates API, see https://openexchangerates.org/

Pull the latest Exchange Rates

Once your backend is setup, get the latest exchange rates:

$ ./manage.py update_rates

Convert from one currency to another

Here's an example of converting 10 American Dollars to Chinese Renminbi:

from currency_open_exchange.utils import convert
amount, currency = convert(10, "USD", "CNY")