Skip to content

A simple currency converter plugin for Laravel 5. Currency providers: The European Central Bank, OpenExchange, CurrencyLayer and


Notifications You must be signed in to change notification settings


Folders and files

Last commit message
Last commit date

Latest commit



82 Commits

Repository files navigation

Laravel Currency Converter

GitHub PHP from Packagist GitHub release GitHub tag Travis (.org) Codecov

A simple currency conversion plug-in for Laravel 5.5+ 💵
Example usage:

Version testing and requirements

Version Tested with
dev-master Laravel 6.0
v0.3.* Laravel 6.0
v0.2.* Laravel 5.6
v0.1.* Laravel 5.5
v0.0.7 Laravel 5.4

If you are having composer requirement issues using the latest release and Laravel < v5.4, try the v0.0.7 release.

Please note:

  • The European Central Bank does not require any user account and is therefore set as the default 'api-source', however the number of available currencies are somewhat limited compared to the other commercial sources (37). In my experience this source is also unpredictable, and might give an empty response.
  • All the other data providers are commercial and require a user account. They all have a free tier of 1000 requests per month, let's say you theoretically cache results for 60 min and you should be covered with some margin for errors 👍 Coincidentally Cache is enabled per default and set to 60 min. Now in theory one should perhaps make a simple Eloquent Model with the columns: date, from, to, rate or something similar, and then store the historical results. Please note that depending on usage this might go against the user agreements on the commercial data providers. 🤫 🙈


composer require danielme85/laravel-cconverter


You can publish this vendor config file if you would like to make changes to the default config.

php artisan vendor:publish --provider="danielme85\CConverter\CConverterServiceProvider"

All config variables can also be changed in your local .env file:



There are static class "shortcuts" to convert or get one-time Currency series.

//To convert a value
$valueNOK = Currency::conv($from = 'USD', $to = 'NOK', $value = 10, $decimals = 2);

//To convert a value based on historical data
$valueNOK = Currency::conv($from = 'USD', $to = 'NOK', $value = 10, $decimals = 2, $date = '2018-12-24');

//to get an array of all the rates associated to a base currency.
$rates = Currency::rates(); //defaults to USD

$rates = Currency::rates('NOK');

//Get historical rates
$rates = Currency::rates('NOK', '2018-12-24');

Working with multiple values

I would highly recommend creating a model instance and the non-static functions getRates() & convert() when doing multiple conversion or getting multiple currency series for the best performance. The currency rates are stored in the provider model by date/base-currency for quick and easy access.

$currency = new Currency();
$values = [1, 3, 4, 5...].
foreach ($values as $value) {
    $valueNOK = $currency->convert($from = 'USD', $to = 'NOK', $value = 10, $decimals = 2);

$rates = $currency->getRates('NOK');
foreach ($rates as $rate) {
    $value = $valueNOK * $rate;

You can override the settings when/if you create a new instance.

$currency = new Currency(
    $api = 'yahoo', 
    $https = false, 
    $useCache = false, 
    $cacheMin = 0);
$result = Currency:conv(
    $from = 'USD', 
    $to = 'NOK', 
    $value = 10, 
    $decimals = 2, 
    $date = '2018-12-24', 
    $api = 'yahoo', 
    $https = false, 
    $useCache = false, 
    $cacheMin = 0);

Use the three lettered ISO4217 code for to/from currencies:

Money Formatting

The package: gerardojbaez/money is included for an easier and more powerful Money Formatter, excellent alternative to money_format(). You can get the values of an conversion by setting round='money' (money formatter overrides rounding).

Currency::conv('USD', 'USD', 10, 2);
//Result: 10
Currency::conv('USD', 'USD', 10, 'money');
//Result: $10.00
$currency->convert('USD', 'USD', 10, 'money');
//Result: $10.00

You can also get the money formatter itself trough the static Currency function:

$formater = Currency::money($amount = 0, $currency = 'USD');

This Money Formatter also ships with a handy helper function.

echo moneyFormat(10, 'USD');
//Result: $10.00

See Money Formatter github page for more information and usage.

Supported functions per API

Default API is: The European Central Bank

Config var API HTTPS Historical Sign-up required URL
eurocentralbank The European Central Bank yes yes no
openexchange non-free non-free yes
currencylayer *CurrencyLayer non-free yes yes
fixer * yes yes yes

*CurrencyLayer and is the same company now, and it seems like the services have become one and the same.


Please take note of the Terms of Use for the different data sources.

This code is released per the MIT open source license: The actual rates and conversion will vary between the data sources. In addition I am no math professor, so you should probably not use this for super serious multi-billion dollar investments. If you are gonna spend your hard earned billion dollars on the money market, you should probably use something like this:


A simple currency converter plugin for Laravel 5. Currency providers: The European Central Bank, OpenExchange, CurrencyLayer and









Contributors 4