NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
Packagist
Packagist, #3448 most downloaded on Packagist
A wrapper package for interacting with the exchangeratesapi.io API.
Latest stable
v7.11.0
Last release 8 months ago
13 Mar 2026
Release timing varies
gaps range from 2 weeks to 8 months
Most releases are documented
notes for 30 of 37 stable releases
Nothing withdrawn
no release was ever pulled
7 years old
37 releases · first in 2019
Drag across the ruler to compare, or tap a release to open it.
Dropped support for PHP 8.0 and 8.1 by @ash-jc-allen in https://github.com/ash-jc-allen/laravel-exchange-rates/pull/174
Full Changelog: https://github.com/ash-jc-allen/laravel-exchange-rates/compare/v7.10.0...v7.11.0
Addcurrency-beacon driver in supported APIs comment in config file by @yuters in https://github.com/ash-jc-allen/laravel-exchange-rates/pull/170
currency-beacon driver in supported APIs comment in config file by @yuters in https://github.com/ash-jc-allen/laravel-exchange-rates/pull/170.gitattributes file by @ash-jc-allen in https://github.com/ash-jc-allen/laravel-exchange-rates/pull/173Full Changelog: https://github.com/ash-jc-allen/laravel-exchange-rates/compare/v7.9.0...v7.10.0
Your coding agent can read these notes before it upgrades. Set up the MCP server →
Add support for Laravel 12 by @ash-jc-allen in https://github.com/ash-jc-allen/laravel-exchange-rates/pull/167
Full Changelog: https://github.com/ash-jc-allen/laravel-exchange-rates/compare/v7.8.0...v7.9.0
Drop Laravel 8 support by @ash-jc-allen in https://github.com/ash-jc-allen/laravel-exchange-rates/pull/164
Full Changelog: https://github.com/ash-jc-allen/laravel-exchange-rates/compare/v7.7.0...v7.8.0
Add explicit nullable types for PHP 8.4 support by @SanderMuller in https://github.com/ash-jc-allen/laravel-exchange-rates/pull/162
Full Changelog: https://github.com/ash-jc-allen/laravel-exchange-rates/compare/v7.6.0...v7.7.0
Updated the test data providers methods to be static by @faissaloux in https://github.com/ash-jc-allen/laravel-exchange-rates/pull/158
Full Changelog: https://github.com/ash-jc-allen/laravel-exchange-rates/compare/v7.5.0...v7.6.0
Added "BYN" as a valid currency symbol by @ash-jc-allen in https://github.com/ash-jc-allen/laravel-exchange-rates/pull/157
Full Changelog: https://github.com/ash-jc-allen/laravel-exchange-rates/compare/v7.4.0...v7.5.0
Added support for nesbot/carbon 3.0 by @ash-jc-allen in https://github.com/ash-jc-allen/laravel-exchange-rates/pull/154
nesbot/carbon 3.0 by @ash-jc-allen in https://github.com/ash-jc-allen/laravel-exchange-rates/pull/154Full Changelog: https://github.com/ash-jc-allen/laravel-exchange-rates/compare/v7.3.0...v7.4.0
Added support for Laravel 11 by @ash-jc-allen in https://github.com/ash-jc-allen/laravel-exchange-rates/pull/153
Full Changelog: https://github.com/ash-jc-allen/laravel-exchange-rates/compare/v7.2.0...v7.3.0
Added support for the CurrencyBeacon API by @ragulka in https://github.com/ash-jc-allen/laravel-exchange-rates/pull/149
Full Changelog: https://github.com/ash-jc-allen/laravel-exchange-rates/compare/v7.1.1...v7.2.0
Fixed the exchange-rate-host driver so it works with the latest, sudden API changes by @ash-jc-allen in https://github.com/ash-jc-allen/laravel-exchan
exchange-rate-host driver so it works with the latest, sudden API changes by @ash-jc-allen in https://github.com/ash-jc-allen/laravel-exchange-rates/pull/148Full Changelog: https://github.com/ash-jc-allen/laravel-exchange-rates/compare/v7.1.0...v7.1.1
Added an https config option that can be used to specify whether the API should be accessed over HTTPS or HTTP by @jlevers and @ash-jc-allen in https:
https config option that can be used to specify whether the API should be accessed over HTTPS or HTTP by @jlevers and @ash-jc-allen in https://github.com/ash-jc-allen/laravel-exchange-rates/pull/136 and https://github.com/ash-jc-allen/laravel-exchange-rates/pull/137Full Changelog: https://github.com/ash-jc-allen/laravel-exchange-rates/compare/v7.0.1...v7.1.0
Fixed bug that was using the incorrect response class by @ash-jc-allen in https://github.com/ash-jc-allen/laravel-exchange-rates/pull/130
Full Changelog: https://github.com/ash-jc-allen/laravel-exchange-rates/compare/v7.0.0...v7.0.1
Fixed documentation to show how to instantiate the ExchangeRate class by @ash-jc-allen in https://github.com/ash-jc-allen/laravel-exchange-rates/pull/
Full Changelog: https://github.com/ash-jc-allen/laravel-exchange-rates/compare/v6.1.0...v7.0.0
Add ExchangeRateHost driver by @viicslen in https://github.com/ash-jc-allen/laravel-exchange-rates/pull/118
Full Changelog: https://github.com/ash-jc-allen/laravel-exchange-rates/compare/v6.0.0...v6.1.0
Added concept of "drivers" so the package can support multiple APIs. #84
driver config option. #84declare(strict_types=1); to all files. #106api_url config option. #84existsInCache method from the src/Classes/CacheRepository.php file. #106validateIsStringOrArray method from the src/Classes/Validation file. #106Full Changelog: https://github.com/ash-jc-allen/laravel-exchange-rates/compare/v5.2.0...v6.0.0
Upgrade guide: https://github.com/ash-jc-allen/laravel-exchange-rates/blob/master/UPGRADE.md
Updated the PHPUnit config to the newer format by @ash-jc-allen and @tammytee in https://github.com/ash-jc-allen/laravel-exchange-rates/pull/80
Full Changelog: https://github.com/ash-jc-allen/laravel-exchange-rates/compare/v5.1.0...v5.2.0
PHP 8.2 Support by @ash-jc-allen in https://github.com/ash-jc-allen/laravel-exchange-rates/pull/78
Full Changelog: https://github.com/ash-jc-allen/laravel-exchange-rates/compare/v5.0.1...v5.1.0
Used Carbon::now() instead of the now() helper to provide support for Lumen. #77
Carbon::now() instead of the now() helper to provide support for Lumen. #77Added PHPStan workflow for GitHub Actions. #72
guzzlehttp/guzzle 6.*. #69orchestra/testbench 3.* , 4.* , and 5.*. #69phpunit/phpunit 8.*. #69Updated the list of allowed currencies
<h3 id="updated-currencies-list">Updated the list of allowed currencies (#66)</h3>
As part of the API migrating to the newer format and version, there are now many more currencies than in the past. All of the new currencies can be seen in the documentation in the README. Thanks, @martyn-v for contributing and updating the list!
<h3 id="updated-dependabot-version">Updated Dependabot to GitHub-native version (#64)</h3>
Dependabot has now been updated to use the GitHub-native version rather than the preview version that has been used up until now.
Fixed the parameters that are sent to the ` timeseries ` endpoint
<h3 id="fixed-parameters">Fixed the parameters that are sent to the <code>timeseries</code> endpoint. (#63)</h3>
This release fixed a bug that was still sending the older start_at and end_at parameters that were expected in the older version of the API. The requests now use the newer start_date and end_date parameters.
Added config file and support for new API changes
<h3 id="added-support-for-new-api-changes">Added config file and support for new API changes (#57)</h3>
As of 1st April 2021, the exchangeratesapi.io now requires an API key to use the service. To get an API key, head over to https://exchangeratesapi.io/pricing. You can sign up for free or use the paid tiers.
Please note that at the time of writing this, you will need to be on at least the 'Basic' plan to make request via HTTPS. You
will also be required to have at least the 'Professional' plan to use the convertBetweenDateRange() and exchangeRateBetweenDateRange()
that this package offers.
You will also be required to have at least the 'Basic' paid plan to use exchangeRate() and convert() methods offered by
this package due to the fact that the free plan does not allow setting a base currency when converting.
After you've got your API key, you can add the following fields to your .env file:
EXCHANGE_RATES_API_URL=https://api.exchangeratesapi.io/v1/
EXCHANGE_RATES_API_KEY={Your-API-Key-Here}
As of Laravel Exchange Rates v3.3.0, the package can now be run using PHP 8.
<h3 id="added-support-for-php-8">Added support for PHP 8 (#50)</h3>
As of Laravel Exchange Rates v3.3.0, the package can now be run using PHP 8.
Updated the Travis CI config to run the tests correctly
<h3 id="updated-travis-config">Updated the Travis CI config to run the tests correctly (#47)</h3>
The Travis CI config has now been updated so that it runs the test for this library against the correct version of PHP and Laravel. Previously, the Laravel version was being ignored and the tests were just being run against the latest version (at the time 7.28.0).
Added support for Laravel 8 and Guzzle 7
<h3 id="added-laravel-8-support">Added support for Laravel 8 (#46)</h3>
Laravel Exchanges Rates now has support for Laravel 8 and Guzzle 7.
Added a new ``` ValidCurrency ``` validation rule
<h3 id="added-new-validation-rule">Added a new <code>ValidCurrency</code> validation rule (#45)</h3>
Laravel Exchange Rates comes with its own ValidCurrency rule for validating currencies. This can be useful for if you need to be sure that a currency (maybe one provided by the user) is supported by the library.
The example below show how you can use the rule for validating the currency:
<?php
namespace App\Http\Controllers;
use AshAllenDesign\LaravelExchangeRates\Rules\ValidCurrency;
use Illuminate\Support\Facades\Validator;
class TestController extends Controller
{
public function index()
{
$formData = [
'currency' => 'GBP',
];
$rules = [
'currency' => new ValidCurrency,
];
$validator = Validator::make($formData, $rules);
}
}
Added functionality to get rates and converted values for more than one currency
->shouldCache() method<h3 id="multiple-rates-and-converted-values">Added functionality to get rates and converted values for more than one currency (#42)</h3>
This feature brings huge improvements to the performance and usage of this library. Previously, if you wanted to get the exchange rate for more than one exchange rate you would have to call the package's method multiple times (once for each currency).
As of Laravel Exchange Rates v3.0.0, you can now get the exchange rates and converted values for multiple currencies at once. This reduces the amount of requests that are needed to be made to the API and reduces overall load.
The example below show how to convert £1 'GBP' to 'EUR' and 'USD' at today's exchange rate.
$exchangeRates = new ExchangeRate();
$result = $exchangeRates->convert(100, 'GBP', ['EUR', 'USD'], Carbon::now());
// $result: [
// 'EUR' => 110.15884906,
// 'USD' => 125.30569081
// ];
<h3 id="new-should-cache-method">Added a new <code>->shouldCache()</code> method (#38)</h3>
A new ->shouldCache() method has now been added that can be used to determine whether if the exchange rate fetched via the API should be stored in the cache.
The example below shows how to use the new method get an exchange rate and not cache it:
<?php
namespace App\Http\Controllers;
use AshAllenDesign\LaravelExchangeRates\Classes\ExchangeRate;
class TestController extends Controller
{
public function index()
{
$exchangeRates = new ExchangeRate();
return $exchangeRates->shouldCache(false)->convert(100, 'GBP', 'EUR', Carbon::now());
}
}
<h3 id="dropped-laravel-5-8-support">Dropped Laravel 5.8 support (#41)</h3>
As of Laravel Exchange Rates v3.0.0, Laravel 5.8 is no longer supported. Therefore, you must be using a minimum of Laravel 6.0 to use this library.
Prevented API calls when getting the exchange rate for two of the same currency
<h3 id="prevented-api-calls">Prevented API calls when getting the exchange rate for two of the same currency (#32)</h3>
Laravel Exchange Rates uses the exchangeratesapi.io service for fetching the exchange rates between different currencies. At the time of releasing v2.2.0, a bug exists in the API that caused an exception if trying to convert from EUR to EUR.
To solve this issue, a change has now been made that prevents any requests from being sent to the API if the from and to currencies are the same. This also brings some minor performance improvements.
<h3 id="documentation-update">Documentation update (#33)</h3>
This is only a small update purely for cosmetic reasons. It changes the list of support currencies in the documentation from an unordered list to a table.
Laravel Exchange Rates now has support for Laravel 7!
<h3 id="added-support-for-laravel-seven">Added support for Laravel 7 (#28)</h3>
Laravel Exchange Rates now has support for Laravel 7!
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
One column per quarter.