README

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

Requirements

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

Other UniRate clients

UniRate ships official client libraries and framework integrations across the ecosystem. The repos below are all maintained under the UniRate-API org.

• Languages: Python · Node.js / TypeScript · Go · Rust · Java · Ruby · PHP · .NET · Swift
• Web frameworks: Next.js · SvelteKit · NestJS · Django / Wagtail · FastAPI · Flask · React · tRPC
• Static-site generators: Astro · Eleventy · Hugo
• Data / orchestration: Airflow · dbt · LangChain
• Workflow / no-code: n8n · Google Sheets · MCP server
• Editors / tools: VS Code · Obsidian
• Specialty bridges: Laravel Money · RubyMoney · NodaMoney (.NET)

Get a free API key at unirateapi.com.

License

MIT — see LICENSE.