---
id: currencyconverter
version: "0.18.21"
license: unclear
license_treatment: unclear
maintenance: active
---

# CurrencyConverter — A currency converter using the European Central Bank data.

License: unclear · Maintenance: active · Downloads: 795.0K/mo

## What it is and what it does

CurrencyConverter is a Python library that performs currency conversions using historical exchange rates from the European Central Bank. It works with 42 currencies against the Euro and includes rates dating back to 1999. The package uses embedded data rather than real-time API calls, which means conversions are fast but the data may not reflect the absolute latest rates—you can optionally download fresh data from the ECB if needed.

The library supports querying rates for specific historical dates, with fallback modes for missing rates (using linear interpolation or the last known rate) and for dates outside the available range. It also offers a decimal mode for exact conversions when floating-point precision is insufficient. A command-line tool is included for quick conversions from the terminal.

Use it for:

- Build historical financial reports that need accurate exchange rates for specific past dates.
- Integrate currency conversion into applications where embedded data is acceptable and real-time rates are not critical.
- Perform batch conversions across multiple currencies without the latency of HTTP API calls.
- Calculate multi-currency accounting or reconciliation using precise decimal arithmetic.
- Analyze historical currency trends by accessing rates across decades of ECB data.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Converts currency amounts using historical exchange rates from the European Central Bank, with support for 42 currencies against the Euro since 1999.

Yes. The package is actively maintained, has no dependencies, installs easily, and solves a clear problem for applications needing historical currency conversion. The embedded data model trades freshness for speed and reliability. If you need real-time rates or rates outside the ECB's coverage, this is not the right tool; otherwise, it's a solid choice for historical or batch conversions.

## Install

pip install currencyconverter
uv add currencyconverter
poetry add currencyconverter

## Installing CurrencyConverter

Before you install: Low install friction with no runtime dependencies. Active maintenance with a recent release 10 days ago and steady repository activity.

Quickstart:

pip install currencyconverter

from datetime import date
c = CurrencyConverter()
result = c.convert(100, 'EUR', 'USD', date=date(2013, 3, 21))

Requires Python 3.9 or later.

Verify before relying:

- Whether embedded currency data is updated regularly and how stale it typically becomes between releases.
- Performance characteristics when using the decimal option for exact conversions.
- Whether the fallback interpolation methods are suitable for financial applications requiring audit trails.
- Real-time rate availability and whether this package meets latency requirements for live trading or pricing.

## Package facts

- License: not declared (unclear)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 795.0K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

currency conversion, exchange rate calculator, historical forex rates, ecb currency data, multi-currency converter, euro exchange rates, currency converter library, finance, exchange-rates, historical-data

[View on SkillFed](https://skillfed.io/packages/currencyconverter) · [View on PyPI](https://pypi.org/project/currencyconverter/)