https://github.com/UniRate-API/angular-unirate

Official Angular module for the UniRate currency-exchange API. UniRateModule.forRoot, provideUniRate, Observable UniRateService, and currencyRate/currencyConvert pipes. Zero runtime deps.
https://github.com/UniRate-API/angular-unirate

angular angular-module currency-converter exchange-rates forex fx-api rxjs unirate unirateapi

Last synced: 7 days ago
JSON representation

Official Angular module for the UniRate currency-exchange API. UniRateModule.forRoot, provideUniRate, Observable UniRateService, and currencyRate/currencyConvert pipes. Zero runtime deps.

Host: GitHub
URL: https://github.com/UniRate-API/angular-unirate
Owner: UniRate-API
License: mit
Created: 2026-07-02T05:58:51.000Z (30 days ago)
Default Branch: main
Last Pushed: 2026-07-02T06:01:48.000Z (30 days ago)
Last Synced: 2026-07-02T06:10:13.459Z (30 days ago)
Topics: angular, angular-module, currency-converter, exchange-rates, forex, fx-api, rxjs, unirate, unirateapi
Language: TypeScript
Size: 0 Bytes
Stars: 0
Watchers: 0
Forks: 0
Open Issues: 0
Metadata Files:
- Readme: README.md
- License: LICENSE

Awesome Lists containing this project

awesome-angular - @unirate/angular - Angular pipes (`currencyRate`, `currencyConvert`) and `UniRateService` (Observable-based) for live currency exchange rates from the [UniRate](https://unirateapi.com) API. Supports Angular 16–22 with `UniRateModule.forRoot()` or `provideUniRate()`. (Third Party Components / Pipes)
fucking-awesome-angular - @unirate/angular - Angular pipes (`currencyRate`, `currencyConvert`) and `UniRateService` (Observable-based) for live currency exchange rates from the [UniRate](https://unirateapi.com) API. Supports Angular 16–22 with `UniRateModule.forRoot()` or `provideUniRate()`. (Third Party Components / Pipes)

README

          # @unirate/angular

Official Angular module for the [UniRate API](https://unirateapi.com) — free

currency exchange rates, historical data, and VAT rates.

- Observable-based `UniRateService` with full API parity

- `UniRateModule.forRoot()` for NgModule apps

- `provideUniRate()` for standalone Angular 16+ apps

- `currencyRate` and `currencyConvert` pipes (use with Angular's built-in `async` pipe)

- Zero runtime dependencies (peer deps: `@angular/core`, `@angular/common`, `rxjs`)

- Compiled with [ng-packagr](https://github.com/ng-packagr/ng-packagr) in Angular Package Format (APF) — AOT and Ivy compatible

## Install

```bash

npm install @unirate/angular

```

Requires Angular 16–22 and RxJS 7.

## Quick start

### Standalone app (`app.config.ts`)

```ts

import { provideUniRate } from '@unirate/angular';

export const appConfig: ApplicationConfig = {

  providers: [

    provideUniRate({ apiKey: environment.UNIRATE_API_KEY }),

  ],

};

```

### NgModule app (`app.module.ts`)

```ts

import { UniRateModule } from '@unirate/angular';

@NgModule({

  imports: [

    UniRateModule.forRoot({ apiKey: environment.UNIRATE_API_KEY }),

  ],

})

export class AppModule {}

```

### Inject the service

```ts

import { Component, inject, OnInit } from '@angular/core';

import { AsyncPipe } from '@angular/common';

import { Observable } from 'rxjs';

import { UniRateService } from '@unirate/angular';

@Component({

  selector: 'app-rates',

  standalone: true,

  imports: [AsyncPipe],

  template: `
EUR: {{ rate$ | async }}`,

})

export class RatesComponent implements OnInit {

  private rates = inject(UniRateService);

  rate$!: Observable;

  ngOnInit() {

    this.rate$ = this.rates.getRate('USD', 'EUR');

  }

}

```

### Use the pipes

```ts

// In a standalone component:

import { CurrencyRatePipe, CurrencyConvertPipe } from '@unirate/angular';

@Component({

  standalone: true,

  imports: [AsyncPipe, CurrencyRatePipe, CurrencyConvertPipe],

  template: `

    
1 USD = {{ 'USD' | currencyRate:'EUR' | async }} EUR

    100 USD = {{ 100 | currencyConvert:'USD':'EUR' | async }} EUR

  `,

})

```

Or add `UniRateModule` to `imports` in an NgModule to get the pipes automatically.

### Async config (`forRootAsync`)

```ts

UniRateModule.forRootAsync({

  useFactory: (config: ConfigService) => ({

    apiKey: config.getOrThrow('UNIRATE_API_KEY'),

  }),

  deps: [ConfigService],

})

```

## API

### `UniRateService`

All methods return `Observable`. Subscribe with Angular's `async` pipe or `firstValueFrom()`.

```ts

getRate(from: string, to: string): Observable

getRate(from: string): Observable>

convert(to: string, amount: number, from: string): Observable

listCurrencies(): Observable

// Pro-gated — returns 403 on the free tier

getHistoricalRate(date: string, amount: number, from: string, to: string): Observable

getHistoricalRate(date: string, amount: number, from: string): Observable>

getHistoricalRates(date: string, amount: number, base: string): Observable>

convertHistorical(amount: number, from: string, to: string, date: string): Observable

getTimeSeries(startDate: string, endDate: string, amount: number, base: string, currencies?: string[]): Observable>>

getHistoricalLimits(): Observable

getVATRates(): Observable

getVATRates(country: string): Observable

```

Raw Promise-based access: `service.raw.getRate(...)` returns a `Promise` from the underlying `UniRateClient`.

### Error handling

All errors extend `UniRateError`:

| Class | HTTP status |

|---|---|

| `AuthenticationError` | 401 |

| `ProRequiredError` | 403 |

| `InvalidCurrencyError` | 404 |

| `InvalidRequestError` | 400 |

| `RateLimitError` | 429 |

| `UniRateError` | other / network |

```ts

import { catchError } from 'rxjs/operators';

import { UniRateError, ProRequiredError } from '@unirate/angular';

this.rates.getHistoricalRate('2023-01-01', 1, 'USD', 'EUR').pipe(

  catchError((err: UniRateError) => {

    if (err instanceof ProRequiredError) {

      console.warn('Historical rates require a Pro plan.');

    }

    throw err;

  }),

).subscribe();

```

## Rate limits

The free plan allows 1,000 requests/month. Historical endpoints (`/api/historical/*`) require a Pro subscription and return `ProRequiredError` on the free tier.

## Related clients

| Ecosystem | Package |

|---|---|

| Python | [unirate-api](https://pypi.org/project/unirate-api/) |

| Node.js | [unirate-api](https://www.npmjs.com/package/unirate-api) |

| React | [@unirate/react](https://www.npmjs.com/package/@unirate/react) |

| Vue | [@unirate/vue](https://www.npmjs.com/package/@unirate/vue) |

| Next.js | [@unirate/next](https://www.npmjs.com/package/@unirate/next) |

| SvelteKit | [@unirate/sveltekit](https://www.npmjs.com/package/@unirate/sveltekit) |

| NestJS | [@unirate/nestjs](https://www.npmjs.com/package/@unirate/nestjs) |

| Nuxt | [@unirate/nuxt](https://www.npmjs.com/package/@unirate/nuxt) |

| Remix | [@unirate/remix](https://www.npmjs.com/package/@unirate/remix) |

| Eleventy | [@unirate/eleventy](https://www.npmjs.com/package/@unirate/eleventy) |

| Astro | [@unirate/astro](https://www.npmjs.com/package/@unirate/astro) |

| Go | [unirate-api-go](https://github.com/UniRate-API/unirate-api-go) |

| Rust | [unirate-api](https://crates.io/crates/unirate-api) |

| Swift | [unirate-api-swift](https://github.com/UniRate-API/unirate-api-swift) |

| MCP Server | [@unirate/mcp](https://www.npmjs.com/package/@unirate/mcp) |

## UniRate ecosystem

UniRate ships official integrations for 40+ ecosystems, all maintained under the

[UniRate-API](https://github.com/UniRate-API) org.

**Core clients (9 languages)**

[Python](https://github.com/UniRate-API/unirate-api-python) ·

[Node.js / TypeScript](https://github.com/UniRate-API/unirate-api-nodejs) ·

[Go](https://github.com/UniRate-API/unirate-api-go) ·

[Rust](https://github.com/UniRate-API/unirate-api-rust) ·

[Java](https://github.com/UniRate-API/unirate-api-java) ·

[Ruby](https://github.com/UniRate-API/unirate-api-ruby) ·

[PHP](https://github.com/UniRate-API/unirate-api-php) ·

[.NET](https://github.com/UniRate-API/unirate-api-dotnet) ·

[Swift](https://github.com/UniRate-API/unirate-api-swift)

**JavaScript / TypeScript**

[React](https://github.com/UniRate-API/react-unirate) ·

[Next.js](https://github.com/UniRate-API/next-unirate) ·

[Remix](https://github.com/UniRate-API/remix-unirate) ·

[SvelteKit](https://github.com/UniRate-API/sveltekit-unirate) ·

[Vue](https://github.com/UniRate-API/vue-unirate) ·

[Angular](https://github.com/UniRate-API/angular-unirate) ·

[Nuxt](https://github.com/UniRate-API/nuxt-unirate) ·

[NestJS](https://github.com/UniRate-API/nestjs-unirate) ·

[tRPC](https://github.com/UniRate-API/trpc-unirate)

**Static-site generators**

[Astro](https://github.com/UniRate-API/astro-unirate) ·

[Eleventy](https://github.com/UniRate-API/eleventy-unirate) ·

[Hugo](https://github.com/UniRate-API/hugo-unirate) ·

[Jekyll](https://github.com/UniRate-API/jekyll-unirate)

**CMS & e-commerce**

[Wagtail](https://github.com/UniRate-API/wagtail-unirate) ·

[WordPress](https://github.com/UniRate-API/unirate-currency-converter) ·

[WooCommerce](https://github.com/UniRate-API/unirate-woocs) ·

[Drupal](https://github.com/UniRate-API/drupal-unirate) ·

[Strapi](https://github.com/UniRate-API/strapi-plugin-unirate) ·

[Medusa](https://github.com/UniRate-API/medusa-plugin-unirate) ·

[Symfony](https://github.com/UniRate-API/unirate-bundle) ·

[Laravel](https://github.com/UniRate-API/laravel-money-unirate) ·

[Directus](https://github.com/UniRate-API/directus-extension-unirate)

**Data, AI & backend**

[LangChain (Python)](https://github.com/UniRate-API/langchain-unirate) ·

[LangChain.js](https://github.com/UniRate-API/langchain-js-unirate) ·

[FastAPI](https://github.com/UniRate-API/fastapi-unirate) ·

[Flask](https://github.com/UniRate-API/flask-unirate) ·

[Django REST Framework](https://github.com/UniRate-API/djangorestframework-unirate) ·

[Apache Airflow](https://github.com/UniRate-API/airflow-provider-unirate) ·

[dbt](https://github.com/UniRate-API/dbt-unirate)

**Platform & tools**

[MCP server](https://github.com/UniRate-API/unirate-mcp) ·

[CLI](https://github.com/UniRate-API/unirate-cli) ·

[Cloudflare Workers](https://github.com/UniRate-API/cloudflare-workers-unirate) ·

[Home Assistant](https://github.com/UniRate-API/unirate-home-assistant) ·

[n8n](https://github.com/UniRate-API/n8n-nodes-unirate) ·

[Google Sheets](https://github.com/UniRate-API/unirate-sheets) ·

[VS Code](https://github.com/UniRate-API/vscode-unirate) ·

[Obsidian](https://github.com/UniRate-API/obsidian-currency)

**Money library bridges**

[money gem (Ruby)](https://github.com/UniRate-API/money-unirate-api) ·

[NodaMoney (.NET)](https://github.com/UniRate-API/UniRateApi.NodaMoney)

Get a free API key at [unirateapi.com](https://unirateapi.com).

## License

MIT — see [LICENSE](LICENSE).

ecosyste.ms

Data

Tools

Indexes

Applications

Experiments

Awesome

https://github.com/UniRate-API/angular-unirate

Awesome Lists containing this project

README