Laravel Money UniRate

July 8, 2026 · View on GitHub

Exchange-rate bridge for akaunting/laravel-money — automatic rate fetching, caching, and conversion powered by UniRate API.

Installation

composer require unirate-api/laravel-money

The service provider and facade are auto-discovered. Publish the config if you need to customise:

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.

Usage

Facade

use UniRate\LaravelMoney\Facades\UniRate;

// Get a single rate
$rate = UniRate::getRate('USD', 'EUR');  // 0.92

// Get all rates for a base currency
$rates = UniRate::getRates('USD');  // ['EUR' => 0.92, 'GBP' => 0.79, ...]

// Convert a raw amount
$eur = UniRate::convertAmount(100.0, 'USD', 'EUR');  // 92.0

// Convert a Money instance
use Akaunting\Money\Money;
use Akaunting\Money\Currency;

$price = new Money(1000, new Currency('USD'));
$converted = UniRate::convert($price, 'EUR');
// → Money(920, Currency('EUR'))

// List supported currencies
$currencies = UniRate::currencies();  // ['USD', 'EUR', 'GBP', ...]

Money macro

A convertVia macro is registered on Akaunting\Money\Money:

$price = new Money(2500, new Currency('USD'));
$gbp = $price->convertVia('GBP');
// → Money(1975, Currency('GBP'))

Artisan command

# Fetch and display current rates
php artisan unirate:rates

# Specify a base currency
php artisan unirate:rates --base=EUR

# Flush cache before fetching
php artisan unirate:rates --flush

Dependency injection

use UniRate\LaravelMoney\UniRateExchange;

class PricingController extends Controller
{
    public function show(UniRateExchange $exchange)
    {
        $rate = $exchange->getRate('USD', 'EUR');
        // ...
    }
}

Configuration

Key	Env	Default	Description
`api_key`	`UNIRATE_API_KEY`	—	Your UniRate API key
`base_url`	`UNIRATE_API_BASE_URL`	`https://api.unirateapi.com`	API base URL
`base_currency`	`UNIRATE_BASE_CURRENCY`	`USD`	Default base currency
`cache.store`	`UNIRATE_CACHE_STORE`	`null` (default)	Laravel cache store name
`cache.ttl`	`UNIRATE_CACHE_TTL`	`3600`	Cache TTL in seconds (0 = disabled)
`cache.prefix`	—	`unirate`	Cache key prefix
`timeout`	`UNIRATE_TIMEOUT`	`10`	HTTP timeout in seconds

Requirements

PHP 8.2+
Laravel 10, 11, 12, or 13
akaunting/laravel-money 5.x or 6.x

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 — see LICENSE.