ecb-fx-rates

Async Python client for ECB daily reference exchange rates.

Fetches and parses the ECB's XML feeds into typed Python objects. No caching, no storage — bring your own persistence layer.

Installation

pip install -e path/to/ecb-fx-rates

Requires Python 3.12+ and aiohttp.

Usage

import aiohttp
from ecb_fx_rates import EcbRatesClient, EcbDailyRates

async def main():
    client = EcbRatesClient()

    async with aiohttp.ClientSession() as session:
        # Today's rates
        today: EcbDailyRates = await client.fetch_daily(session)
        print(today.date)              # date(2025, 12, 31)
        print(today.get("USD"))        # Decimal("1.0842")
        print(today.get("EUR"))        # Decimal("1") — always

        # All rates for a specific year
        year_2025 = await client.fetch_year(session, 2025)
        # ~250 EcbDailyRates, one per ECB business day

        # Last 90 calendar days (~60 business days)
        recent = await client.fetch_last_90_days(session)

        # Full history since 1999 (~6MB download)
        everything = await client.fetch_history(session)

API

EcbRatesClient

EcbDailyRates

Rate semantics: 1 EUR = rate units of currency. To convert foreign currency to EUR: eur = amount / rate.

Testing

pip install -e ".[dev]"
pytest tests/ -x -q

License

MIT