dj-currencies

Documentation

The full documentation is at https://dj-currencies.readthedocs.io.

Quickstart

For Django 2 support, please use version 0.1.2. Django 3 support added in version 1.0. Django 4 support from version >=1.1.

Install djcurrencies:

pip install dj-currencies

Add it to your INSTALLED_APPS:

INSTALLED_APPS = (
    ...
    'dj_currencies',
    ...
)

Settings

DJANGO_CURRENCIES = {
    'DEFAULT_BACKEND': 'djmoney_rates.backends.OpenExchangeBackend',
    'OPENEXCHANGE_APP_ID': '',
    'BASE_CURRENCIES': ['USD'],
    'MAX_CACHE_DAYS': 7
}

DEFAULT_BACKEND: The selected backend to sync exchange rates

OPENEXCHANGE_APP_ID: Must be configured if you use OpenExchangeBackend

BASE_CURRENCIES: A list of base currencies to use. At the time of this version, you will only be able to convert currency from any one of the base currency to target currency.

MAX_CACHE_DAYS: Only use the cache within this time limit. If exchange rates was not synced within the time frame, an exception will thrown

Features

[open exchange rates](openexchangerates.org) integration
Extensible backend design, hook your own exchange rate sources
Multi base currencies support, no double conversion to lose precision
Store historical exchange rates
offline currency conversion

Running Tests

Does the code actually work?

source <YOURVIRTUALENV>/bin/activate
(myenv) $ python runtests.py

Metadata

Release files for dj-currencies 1.8.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for dj-currencies 1.8.0
File	Size	Uploaded
dj_currencies-1.8.0.tar.gz	7.2 kB	Mar 26, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for dj-currencies 1.8.0
File	Interpreter	ABI	Platform	Reset
dj_currencies-1.8.0-py3-none-any.whl 11.4 kB Mar 26, 2026	Python 3	none	any	Details

Total release size: 18.6 kB

Release files / dj_currencies-1.8.0.tar.gz

Download URL	dj_currencies-1.8.0.tar.gz
Size	7.2 kB
Tags	Source
SHA-256 checksum How to use checksums	`4527dd65e0bf5b24d0af9ea2eb2b22ee93caa3867649110814eae203a3f26fde`
BLAKE2b-256 checksum How to use checksums	`df4871d81d88cba8949f62f60de1a84ca11eb0a378599d499310ed4dea436344`
Upload date	Mar 26, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/6.1.0 CPython/3.13.7`

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/CoverGenius/dj-currencies
Publishing commit: github.com/CoverGenius/dj-currencies/tree/ca504118ab2c1210aa9e082adf4e674cb7d18eda

Workflow

Publishing configuration: github.com/CoverGenius/dj-currencies/blob/ca504118ab2c1210aa9e082adf4e674cb7d18eda/.github/workflows/ci.yml
Publishing logs: github.com/CoverGenius/dj-currencies/actions/runs/23574605246/attempts/1

Artifact

Subject: dj_currencies-1.8.0.tar.gz
SHA-256 checksum: 4527dd65e0bf5b24d0af9ea2eb2b22ee93caa3867649110814eae203a3f26fde Verifying attestations

Release files / dj_currencies-1.8.0-py3-none-any.whl

Download URL	dj_currencies-1.8.0-py3-none-any.whl
Size	11.4 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`34e5e4db804c5370e5ad93c73feb46f5d3d5d51ed1a3ea506fcc5b42f0002f52`
BLAKE2b-256 checksum How to use checksums	`6e9879e7ce4b8f3eabfe9a1536e8dd739c42ed5dd9027361db5bfddfc217716f`
Upload date	Mar 26, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/6.1.0 CPython/3.13.7`

Provenance

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/CoverGenius/dj-currencies
Publishing commit: github.com/CoverGenius/dj-currencies/tree/ca504118ab2c1210aa9e082adf4e674cb7d18eda

Workflow

Publishing configuration: github.com/CoverGenius/dj-currencies/blob/ca504118ab2c1210aa9e082adf4e674cb7d18eda/.github/workflows/ci.yml
Publishing logs: github.com/CoverGenius/dj-currencies/actions/runs/23574605246/attempts/1

Artifact

Subject: dj_currencies-1.8.0-py3-none-any.whl
SHA-256 checksum: 34e5e4db804c5370e5ad93c73feb46f5d3d5d51ed1a3ea506fcc5b42f0002f52 Verifying attestations