dagster-unirate

Dagster integration for UniRateAPI — real-time currency exchange rates, conversion, supported currencies, and VAT rates. Ships a ConfigurableResource plus a pair of ready-to-run example assets.

Install

pip install dagster-unirate

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

Quick start

from dagster import Definitions, EnvVar
from dagster_unirate import UniRateResource, exchange_rates, currencies

defs = Definitions(
    assets=[exchange_rates, currencies],
    resources={
        "unirate": UniRateResource(api_key=EnvVar("UNIRATE_API_KEY")),
    },
)

export UNIRATE_API_KEY=your-key-here
dagster dev -f examples/definitions.py

Resource — UniRateResource

A Dagster ConfigurableResource. Configure it once in your Definitions, then request it from any op or asset by name.

Methods (free tier):

from dagster import asset
from dagster_unirate import UniRateResource

@asset
def my_rates(unirate: UniRateResource):
    rate = unirate.get_rate("USD", "EUR")        # -> 0.92 (float)
    all_rates = unirate.get_rate("USD")          # -> {"EUR": 0.92, ...}
    amount = unirate.convert("EUR", 100, "USD")  # -> 92.5 (convert amount)
    codes = unirate.list_currencies()            # -> ["USD", "EUR", ...]
    vat = unirate.get_vat_rates("DE")            # -> {"vat_data": {...}}
    return all_rates

Pro-gated (raises APIError with status_code == 403 on the free tier):

unirate.get_historical_rate("2024-01-15", "EUR")   # requires a Pro plan

Currency and country codes are uppercased automatically before the request.

Example assets

• exchange_rates — latest USD-based rates for a fixed set of currencies, returned as a {code: rate} dict with per-materialization metadata.
• currencies — the full list of supported currency codes.

Both live in dagster_unirate.assets; copy them into your project and edit the target list, or use them as-is. A runnable Definitions is in examples/definitions.py.

Error handling

All errors inherit from UniRateError:

from dagster_unirate import RateLimitError, UniRateError

try:
    unirate.get_rate("USD", "EUR")
except RateLimitError:
    ...  # back off
except UniRateError:
    ...  # any UniRate failure

Testing

pip install -e ".[test]"
pytest

The suite mocks the HTTP layer with respx (no network) and materializes the example assets via dagster.materialize.

Status

v0.1.0 — initial release. UniRateResource + 2 example assets. 33 mock tests.

Other UniRate clients

UniRate ships official client libraries and framework integrations across the ecosystem, all maintained under the UniRate-API org.

• Languages: Python · Node.js / TypeScript · Go · Rust · Java · Ruby · PHP · .NET · Swift
• Data / orchestration: Airflow · dbt · Dagster · LangChain
• Web frameworks: FastAPI · Flask · Django / Wagtail · Streamlit

Get a free API key at unirateapi.com.

License

MIT — see LICENSE.

Links

• UniRate API docs: https://unirateapi.com/docs
• Dagster resources guide: https://docs.dagster.io/concepts/resources
• Issues: https://github.com/UniRate-API/dagster-unirate/issues