UniRate — Live Currency Exchange Rates

Antlers tags for live currency exchange rates, conversion, currency lists, and VAT rates via the UniRate API.

0.2.0

November 16th, 2026

Statamic 5 and 6 add-on for the UniRate API.

Changes

  • Statamic 6 support — requires statamic/cms: ^5.0 || ^6.0. CI tests both majors on PHP 8.2–8.4; verified on a fresh Statamic 6.42 site.
  • Fails gracefully when the API can't be reached — timeouts and connection errors are rethrown as UniRateException with a message that never includes the request URL or API key. Tags render empty output / {{ error }} instead of a server error.
  • Outage fail-fast — after a connection failure the client skips API calls for 30s, so an outage costs one timeout per page instead of one per tag. Default timeout lowered to 5s.
  • Caching — successful responses cached for UNIRATE_CACHE_TTL seconds (default 600, 0 = off). Failures are never cached.
  • README: Antlers {{# #}} comments, self-closing /}} single tags, Support section.

0.1.0

August 25th, 2026

UniRate for Statamic v5 — first release.

Antlers tags for live currency data, plus an injectable client:

  • {{ unirate:rate }} — single pair or all rates for a base
  • {{ unirate:convert }} — amount conversion
  • {{ unirate:currencies }} — supported currency list
  • {{ unirate:vat }} — VAT rates by country
  • UniRate\Statamic\UniRateClient singleton (alias unirate) for use in your own code

All tags fail gracefully (single tag renders nothing on error; a tag pair exposes an {{ error }} variable).

Install: composer require unirate/statamic

Requires PHP 8.2+ and Statamic v5. Adds zero new production dependencies beyond statamic/cms. 29 mock tests.