unirate

n8n community node for the UniRate API — currency conversion, exchange rates, historical rates, time series, and VAT rates.

Package Information

Released: 2 mo ago
Downloads: 8 weekly / 40 monthly
Latest Version: 0.1.5

Available Nodes

Documentation generating…

UniRate icon
UniRate
Currency exchange rates, conversion, historical data, time series, and VAT rates from the UniRate API
UniRate Trigger icon
UniRate Trigger
Fires when an exchange rate changes — optionally above a threshold

Documentation

n8n-nodes-unirate

This is an n8n community node. It lets you use the
UniRate API in your n8n workflows for currency
exchange rates, conversion, historical data, time series, and VAT rates.

UniRate offers free real-time and historical exchange rates for 170+
currencies — no credit card needed for the free tier.

n8n is a fair-code licensed
workflow automation platform.

Installation
Operations
Credentials
UniRate Node
UniRate Trigger Node
Compatibility
Resources
Version history

Installation

Follow the installation guide
in the n8n community-nodes documentation.

In a self-hosted n8n instance:

  1. Go to Settings → Community Nodes.
  2. Select Install.
  3. Enter n8n-nodes-unirate and confirm.

The package is also available on
npm.

Credentials

You need a UniRate API key. The free tier covers latest rates,
conversion, the supported-currency list, and VAT rates. The Pro tier
adds historical rates and time series.

  1. Sign up at unirateapi.com.
  2. Copy your API key from the dashboard.
  3. In n8n, create a new credential of type UniRate API and paste the key.

The credential is sent as the api_key query parameter on every request.
The credential test calls GET /api/currencies to confirm the key.

Operations

The package ships two nodes:

  • UniRate — action node for one-shot lookups and conversions.
  • UniRate Trigger — polling trigger that fires when a tracked
    currency pair's rate changes.

UniRate Node

Resources and operations:

Resource Operation Endpoint
Rate Get GET /api/rates?from&to
Rate Get Many GET /api/rates?from
Conversion Convert GET /api/convert?from&to&amount
Conversion Convert Historical (Pro) GET /api/historical/rates?from&to&amount&date
Currency Get Many GET /api/currencies
Historical (Pro) Get Rate GET /api/historical/rates?date&from&to
Historical (Pro) Get Time Series GET /api/historical/timeseries?start_date&end_date&base&currencies
Historical (Pro) Get Limits GET /api/historical/limits
VAT Get GET /api/vat/rates?country
VAT Get Many GET /api/vat/rates

Pro endpoints return HTTP 403 on a free-tier key.

UniRate Trigger Node

Polls the UniRate API on the schedule you configure (n8n's standard
trigger-schedule controls) and emits an event when the rate for a
tracked pair changes.

Trigger modes:

  • On Any Change — fire when the rate differs from the previous poll.
  • On Threshold Crossed — fire only when the percent change is at
    least the configured threshold (e.g. 0.5 = 0.5 %).
  • On Every Poll — emit on every poll, even if the rate is unchanged.

Event payload:

{
  "from": "USD",
  "to": "EUR",
  "rate": 0.9214,
  "previousRate": 0.9180,
  "absoluteChange": 0.0034,
  "percentChange": 0.3704,
  "timestamp": "2026-04-25T08:30:00.000Z"
}

previousRate, absoluteChange, and percentChange are null on the
first poll.

Example workflows

Convert an amount in a webhook:

  1. Webhook → receives { "amount": 100, "currency": "USD" }.
  2. UniRate (Conversion → Convert) → from = {{$json.currency}},
    to = "EUR", amount = {{$json.amount}}.
  3. Respond to Webhook → { "amount_eur": {{$json.result}} }.

Alert on FX moves:

  1. UniRate Trigger → from = USD, to = EUR,
    trigger mode On Threshold Crossed, threshold 0.5,
    poll interval Every 15 minutes.
  2. Slack → post "USD/EUR moved {{$json.percentChange}}% to {{$json.rate}}".

Daily VAT-rate snapshot:

  1. Schedule Trigger → 0 6 * * *.
  2. UniRate (VAT → Get Many).
  3. Spreadsheet File → save to a dated CSV.

Compatibility

  • Tested on n8n 1.x.
  • Requires Node.js >= 20.15.

Resources

Related

UniRate ships official client libraries for nine languages — Python, Node,
Swift, Java, Go, Rust, Ruby, PHP, and .NET. See the
UniRate-API GitHub organisation.

Version history

0.1.0 (2026-04-25)

  • Initial release.
  • UniRate node: Rate, Conversion, Currency, Historical, VAT resources.
  • UniRate Trigger: polling trigger with any-change / threshold modes.

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

Discussion