PHPackages                             unirate/statamic - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. unirate/statamic

ActiveStatamic-addon

unirate/statamic
================

Statamic v5 addon for the UniRate API — Antlers tags for live currency exchange rates, conversion, currencies, and VAT rates.

v0.1.0(yesterday)01↑2900%MITPHPPHP >=8.2CI passing

Since Aug 25Pushed yesterdayCompare

[ Source](https://github.com/UniRate-API/statamic-unirate)[ Packagist](https://packagist.org/packages/unirate/statamic)[ Docs](https://github.com/UniRate-API/statamic-unirate)[ RSS](/packages/unirate-statamic/feed)WikiDiscussions main Synced today

READMEChangelog (1)Dependencies (3)Versions (2)Used By (0)

UniRate for Statamic
====================

[](#unirate-for-statamic)

A [Statamic v5](https://statamic.com) addon that brings live currency exchange rates, conversion, supported-currency lists, and VAT rates into your Antlers templates — powered by the [UniRate API](https://unirateapi.com).

Installation
------------

[](#installation)

```
composer require unirate/statamic
```

The addon's service provider is auto-discovered. Publish the config if you want to override the defaults:

```
php artisan vendor:publish --tag=unirate-config
```

Set your API key in `.env`:

```
UNIRATE_API_KEY=your-key-here
```

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

Antlers tags
------------

[](#antlers-tags)

### `{{ unirate:rate }}`

[](#-uniraterate-)

```
{{-- Single rate --}}
1 USD = {{ unirate:rate from="USD" to="EUR" }} EUR

{{-- As a pair, with graceful error handling --}}
{{ unirate:rate from="USD" to="GBP" }}
    {{ if error }}Unavailable{{ else }}{{ rate }}{{ /if }}
{{ /unirate:rate }}

{{-- Loop every rate for a base currency --}}
{{ unirate:rate from="USD" }}
    {{ currency }}: {{ rate }}
{{ /unirate:rate }}
```

### `{{ unirate:convert }}`

[](#-unirateconvert-)

```
$100 USD ≈ €{{ unirate:convert from="USD" to="EUR" amount="100" }}
```

### `{{ unirate:currencies }}`

[](#-uniratecurrencies-)

```
{{ unirate:currencies }}
    {{ code }}
{{ /unirate:currencies }}
```

### `{{ unirate:vat }}`

[](#-uniratevat-)

```
{{ unirate:vat country="DE" }}
    {{ country_name }} VAT: {{ vat_rate }}%
{{ /unirate:vat }}
```

All tags **fail gracefully**: on any API error a single tag renders nothing, and a tag pair exposes an `{{ error }}` variable so you can present a fallback.

Using the client directly
-------------------------

[](#using-the-client-directly)

The addon registers a singleton `UniRate\Statamic\UniRateClient` you can inject or resolve in your own code:

```
use UniRate\Statamic\UniRateClient;

$client = app(UniRateClient::class);

$rate       = $client->getRate('USD', 'EUR');       // 0.92
$allRates   = $client->getRate('USD');              // ['EUR' => 0.92, ...]
$converted  = $client->convert('EUR', 100, 'USD');  // 92.5
$currencies = $client->getSupportedCurrencies();    // ['USD', 'EUR', ...]
$vat        = $client->getVatRates('DE');           // ['country_name' => 'Germany', 'vat_rate' => 19.0]
```

Configuration
-------------

[](#configuration)

`config/unirate.php`:

KeyEnvDefault`api_key``UNIRATE_API_KEY`—`base_url``UNIRATE_API_BASE_URL``https://api.unirateapi.com``timeout``UNIRATE_TIMEOUT``10`Error handling
--------------

[](#error-handling)

The client throws `UniRate\Statamic\UniRateException` with the HTTP status as the exception code:

StatusMeaning400Invalid request parameters401Missing or invalid API key403Endpoint requires a Pro subscription404Currency not found or no data available429Rate limit exceeded503Service unavailableHistorical endpoints (`getHistoricalRate`) are Pro-gated and return **403** on the free tier.

Testing
-------

[](#testing)

```
composer install
./vendor/bin/phpunit
```

The suite mocks all HTTP traffic — no live API calls or key required.

License
-------

[](#license)

MIT — see [LICENSE](LICENSE).

Related clients
---------------

[](#related-clients)

Part of the official UniRate client family: Python, Node/TypeScript, Swift, Java, Go, Rust, Ruby, PHP, and .NET, plus framework integrations for Laravel, Symfony, WordPress, and more.

###  Health Score

37

—

LowBetter than 81% of packages

Maintenance100

Actively maintained with recent releases

Popularity2

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity35

Early-stage or recently created project

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Unknown

Total

1

Last Release

1d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/e053d4268ebbee8cd937de585eb7e9647105734aa78023f2805b85373f589ff2?d=identicon)[unirateapi](/maintainers/unirateapi)

---

Top Contributors

[![rob-browncc](https://avatars.githubusercontent.com/u/199503049?v=4)](https://github.com/rob-browncc "rob-browncc (1 commits)")

---

Tags

antlerscurrencyexchange-ratesfintechforexstatamicstatamic-addonuniratevatcurrencyexchange ratesvatstatamicforexfintechStatamic addonunirate

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/unirate-statamic/health.svg)

```
[![Health](https://phpackages.com/badges/unirate-statamic/health.svg)](https://phpackages.com/packages/unirate-statamic)
```

###  Alternatives

[statamic/statamic

Statamic

832182.1k](/packages/statamic-statamic)[statamic-rad-pack/runway

Eloquently manage your database models in Statamic.

138236.2k8](/packages/statamic-rad-pack-runway)[statamic/seo-pro

71548.3k](/packages/statamic-seo-pro)[duncanmcclean/statamic-cargo

Comprehensive e-commerce addon for Statamic. Build bespoke e-commerce sites without the complexity.

3622.8k](/packages/duncanmcclean-statamic-cargo)[aerni/advanced-seo

Comprehensive SEO addon for Statamic with flexibility in mind

1818.9k](/packages/aerni-advanced-seo)[daun/statamic-mux

Seamless video encoding and streaming using Mux on Statamic sites

133.9k](/packages/daun-statamic-mux)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)