PHPackages kantorge/laravel-currency-exchange-rates - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [Utility & Helpers](/categories/utility) 4. / 5. kantorge/laravel-currency-exchange-rates ActiveLibrary[Utility & Helpers](/categories/utility) kantorge/laravel-currency-exchange-rates ======================================== A Laravel package to retrieve historical currency exchange rate data v1.0.0(4mo ago)03.0k—6.3%[2 PRs](https://github.com/kantorge/laravel-currency-exchange-rates/pulls)1MITPHPPHP ^8.1CI passing Since Jan 1Pushed 2mo ago1 watchersCompare [ Source](https://github.com/kantorge/laravel-currency-exchange-rates)[ Packagist](https://packagist.org/packages/kantorge/laravel-currency-exchange-rates)[ Docs](https://github.com/kantorge/laravel-currency-exchange-rates)[ GitHub Sponsors](https://github.com/kantorge)[ RSS](/packages/kantorge-laravel-currency-exchange-rates/feed)WikiDiscussions main Synced 1mo ago READMEChangelog (7)Dependencies (10)Versions (8)Used By (1) A Laravel package to retrieve historical currency exchange rate data ==================================================================== [](#a-laravel-package-to-retrieve-historical-currency-exchange-rate-data) [![Latest Version on Packagist](https://camo.githubusercontent.com/a9b913f958aeea4df0e04e57618992d5a28ccaaa7d8e9b3bd258b52251f734c6/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f6b616e746f7267652f6c61726176656c2d63757272656e63792d65786368616e67652d72617465732e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/kantorge/laravel-currency-exchange-rates)[![GitHub Tests Action Status](https://camo.githubusercontent.com/6e824ad31a1740f33407950af9933c504af256017d5b4c4c6b0747a5e34a00a5/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f616374696f6e732f776f726b666c6f772f7374617475732f6b616e746f7267652f6c61726176656c2d63757272656e63792d65786368616e67652d72617465732f72756e2d74657374732e796d6c3f6272616e63683d6d61696e266c6162656c3d7465737473267374796c653d666c61742d737175617265)](https://github.com/kantorge/laravel-currency-exchange-rates/actions?query=workflow%3Arun-tests+branch%3Amain)[![GitHub Code Style Action Status](https://camo.githubusercontent.com/9b0ec235521f44ed786aa112b3baf4689d1c037160fe4858cdf0b455bd78ecb9/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f616374696f6e732f776f726b666c6f772f7374617475732f6b616e746f7267652f6c61726176656c2d63757272656e63792d65786368616e67652d72617465732f6669782d7068702d636f64652d7374796c652d6973737565732e796d6c3f6272616e63683d6d61696e266c6162656c3d636f64652532307374796c65267374796c653d666c61742d737175617265)](https://github.com/kantorge/laravel-currency-exchange-rates/actions?query=workflow%3A%22Fix+PHP+code+style+issues%22+branch%3Amain)[![Total Downloads](https://camo.githubusercontent.com/664f021298bb6cc0e98b4861eb291e18bf3fdc4f67de93b74b8f1df3629d1ff1/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f6b616e746f7267652f6c61726176656c2d63757272656e63792d65786368616e67652d72617465732e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/kantorge/laravel-currency-exchange-rates) This package can be used to retrieve historical currency exchange rate data from various sources. The main purpose is to provide a unified interface to retrieve data from different sources. Currently, the following sources are supported: - [Frankfurter](https://www.frankfurter.app/docs/) - [CurrencyBeacon](https://currencybeacon.com/) (requires free API key) - A mock source that can be used for testing purposes Installation ------------ [](#installation) You can install the package via composer: ``` composer require kantorge/laravel-currency-exchange-rates ``` You can publish the config file with: ``` php artisan vendor:publish --tag="laravel-currency-exchange-rates-config" ``` Configuration ------------- [](#configuration) ### Using CurrencyBeacon [](#using-currencybeacon) CurrencyBeacon requires an API key. You can get a free API key at . Add your API key to your `.env` file: ``` CURRENCY_BEACON_API_KEY=your_api_key_here ``` To use CurrencyBeacon as your default provider, set it in the published config file: ``` 'default_provider' => 'currencybeacon', ``` Or specify it when creating the client: ``` $currencyApi = CurrencyExchangeRates::create('currencybeacon'); ``` Usage ----- [](#usage) Get a new instance of the CurrencyExchangeRates class with the default source, as defined in the config file. ``` use Kantorge\CurrencyExchangeRates\Facades\CurrencyExchangeRates; $currencyApi = CurrencyExchangeRates::create(); ``` View the list of available currencies ``` // [ 'EUR', 'USD', 'GBP', ...] $currencyApi->getSupportedCurrencies(); ``` Get the exchange rate for a specific date range, with a specific base currency and target currencies ``` // [ // '2021-01-01' => [ // 'EUR' => 1, // 'USD' => 1.23, // ], // ] $currencyApi->getTimeSeries( new Carbon('2021-01-01'), new Carbon('2021-01-01'), 'HUF', ['EUR', 'USD'] ); ``` Testing ------- [](#testing) ``` composer test ``` Changelog --------- [](#changelog) Please see [CHANGELOG](CHANGELOG.md) for more information on what has changed recently. Contributing ------------ [](#contributing) Please see [CONTRIBUTING](CONTRIBUTING.md) for details. Security Vulnerabilities ------------------------ [](#security-vulnerabilities) Please review [our security policy](../../security/policy) on how to report security vulnerabilities. License ------- [](#license) The MIT License (MIT). Please see [License File](LICENSE.md) for more information. ### Health Score 46 — FairBetter than 93% of packages Maintenance82 Actively maintained with recent releases Popularity22 Limited adoption so far Community14 Small or concentrated contributor base Maturity56 Maturing project, gaining track record Bus Factor1 Top contributor holds 61.4% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~148 days Recently: every ~185 days Total 6 Last Release 128d ago Major Versions v0.0.6 → v1.0.02026-01-10 ### Community Maintainers ![](https://www.gravatar.com/avatar/47b48508ba2d4701e634acf54b72e67ff75f6d255d4537595dd607f51a02357e?d=identicon)[kantorge](/maintainers/kantorge) --- Top Contributors [![kantorge](https://avatars.githubusercontent.com/u/12487243?v=4)](https://github.com/kantorge "kantorge (43 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (13 commits)")[![github-actions[bot]](https://avatars.githubusercontent.com/in/15368?v=4)](https://github.com/github-actions[bot] "github-actions[bot] (12 commits)")[![Copilot](https://avatars.githubusercontent.com/in/1143301?v=4)](https://github.com/Copilot "Copilot (2 commits)") --- Tags laravelkantorgelaravel-currency-exchange-rates ### Code Quality TestsPest Code StyleLaravel Pint ### Embed Badge ![Health badge](/badges/kantorge-laravel-currency-exchange-rates/health.svg) ``` [![Health](https://phpackages.com/badges/kantorge-laravel-currency-exchange-rates/health.svg)](https://phpackages.com/packages/kantorge-laravel-currency-exchange-rates) ``` ### Alternatives [stevebauman/location Retrieve a user's location by their IP Address 1.3k7.6M65](/packages/stevebauman-location)[gehrisandro/tailwind-merge-laravel TailwindMerge for Laravel merges multiple Tailwind CSS classes by automatically resolving conflicts between them 341682.2k18](/packages/gehrisandro-tailwind-merge-laravel)[backpack/basset Dead-simple way to load CSS or JS assets only once per page, when using Laravel 10+. 202832.4k6](/packages/backpack-basset)[firefly-iii/data-importer Firefly III Data Import Tool. 7545.8k](/packages/firefly-iii-data-importer)[bensampo/laravel-embed Painless responsive embeds for videos, slideshows and more. 142146.8k](/packages/bensampo-laravel-embed)[glhd/conveyor-belt 14797.0k](/packages/glhd-conveyor-belt) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)