prefect-unirate

Prefect 3 integration for UniRateAPI — real-time currency exchange rates, conversion, currency lists, and VAT rates as first-class Prefect tasks, wired up through a reusable credentials block.

Install

pip install prefect-unirate

Requires prefect >= 3.0.0 and Python 3.10+. Get a free API key at https://unirateapi.com.

Credentials

UniRateCredentials is a Prefect Block that stores your API key (as a SecretStr) and builds a client.

Register the block type once, then save an instance you can reuse across flows:

prefect block register -m prefect_unirate

from prefect_unirate import UniRateCredentials

UniRateCredentials(api_key="your-key").save("unirate")

Load it anywhere with UniRateCredentials.load("unirate").

Tasks

from prefect import flow
from prefect_unirate import (
    UniRateCredentials,
    get_exchange_rate,
    convert_currency,
    list_currencies,
    get_vat_rates,
)


@flow
def fx() -> None:
    creds = UniRateCredentials.load("unirate")

    rate = get_exchange_rate(creds, "USD", "EUR")     # 0.92
    amount = convert_currency(creds, "EUR", 100, "USD")  # 92.5
    codes = list_currencies(creds)                    # ['USD', 'EUR', ...]
    vat = get_vat_rates(creds, "DE")                  # {'country': 'DE', ...}

Currency and country codes are uppercased automatically before being sent.

Error handling

Every task raises a typed exception on failure (all subclass UnirateError):

Historical endpoints are Pro-gated and return 403 on the free tier.

Example flow

A complete runnable flow lives at examples/example_flow.py. It reads UNIRATE_API_KEY from the environment.

Testing

pip install -e ".[test]"
pytest

Tests run against a temporary Prefect database via prefect_test_harness, with the HTTP layer mocked by respx — no network access and no real Prefect server.

Status

v0.1.0 — initial release. Credentials block + 4 tasks. 30+ mock tests.

Other UniRate clients

UniRate ships official client libraries and framework integrations across the ecosystem. The repos below are all maintained under the UniRate-API org.

• Languages: Python · Node.js / TypeScript · Go · Rust · Java · Ruby · PHP · .NET · Swift
• Data / orchestration: Airflow · dbt · LangChain
• Web frameworks: FastAPI · Flask · Django / Wagtail · NestJS
• Workflow / no-code: n8n · Google Sheets · MCP server

Get a free API key at unirateapi.com.

License

MIT.

Links

• UniRate API docs: https://unirateapi.com/docs
• Prefect integrations: https://docs.prefect.io/latest/integrations/
• Issues: https://github.com/UniRate-API/prefect-unirate/issues