UniRate Currency Exchange — Home Assistant Integration

A Home Assistant custom integration that polls the UniRate API for live exchange rates and exposes them as sensor entities.

Features

• Live exchange-rate sensors (e.g. sensor.usd_eur_rate)
• Configurable base currency and target currency list
• Configurable polling interval (default: 1 hour)
• Your UniRate API key stays server-side — never exposed to the frontend

Installation via HACS

1. In HACS → Integrations → menu → Custom repositories
2. Add https://github.com/UniRate-API/unirate-home-assistant as an Integration
3. Install UniRate Currency Exchange
4. Restart Home Assistant

Manual installation

Copy custom_components/unirate_currency/ into your HA config/custom_components/ directory and restart.

Configuration

1. Go to Settings → Devices & Services → Add Integration
2. Search for UniRate Currency Exchange
3. Enter your UniRate API key (free tier covers all sensor data)
4. Set base currency (default: USD) and polling interval

Entities

After setup, sensors are created for each configured target currency:

Entity	State	Unit
sensor.usd_eur	0.9234	EUR
sensor.usd_gbp	0.7891	GBP
sensor.usd_jpy	149.52	JPY

Example automation

automation:
  - alias: "Alert when EUR rate drops"
    trigger:
      - platform: numeric_state
        entity_id: sensor.usd_eur
        below: 0.90
    action:
      - service: notify.mobile_app
        data:
          message: "EUR/USD dropped below 0.90!"

Free vs Pro tier

All sensor data (current rates) is available on the free tier. Historical data requires a Pro subscription.

Related packages

UniRate API client libraries: Python · Node.js · Go · Rust · Ruby · PHP · Java · Swift · .NET

Framework integrations: Next.js · Nuxt · SvelteKit · Astro · NestJS · Strapi · Eleventy · React · Vue

CMS & e-commerce: WordPress · Directus · Medusa · Home Assistant (this package)

Data & AI: LangChain Python · FastAPI · Flask · Django REST · dbt · Airflow

Other: MCP server · CLI · Obsidian · money gem · laravel-money

UniRate ecosystem

UniRate ships official integrations for 40+ ecosystems, all maintained under the UniRate-API org.

Core clients (9 languages) Python · Node.js / TypeScript · Go · Rust · Java · Ruby · PHP · .NET · Swift

JavaScript / TypeScript React · Next.js · Remix · SvelteKit · Vue · Angular · Nuxt · NestJS · tRPC

Static-site generators Astro · Eleventy · Hugo · Jekyll

CMS & e-commerce Wagtail · WordPress · WooCommerce · Drupal · Strapi · Medusa · Symfony · Laravel · Directus

Data, AI & backend LangChain (Python) · LangChain.js · FastAPI · Flask · Django REST Framework · Apache Airflow · dbt

Platform & tools MCP server · CLI · Cloudflare Workers · Home Assistant · n8n · Google Sheets · VS Code · Obsidian

Money library bridges money gem (Ruby) · NodaMoney (.NET)

Get a free API key at unirateapi.com.

License

MIT © Unirate Team