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.1(3w ago)03.9k↑35.4%[2 PRs](https://github.com/kantorge/laravel-currency-exchange-rates/pulls)1MITPHPPHP ^8.1CI passing Since Jan 1Pushed 1w 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 3d ago READMEChangelog (8)Dependencies (20)Versions (11)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 51 — FairBetter than 95% of packages Maintenance97 Actively maintained with recent releases Popularity22 Limited adoption so far Community18 Small or concentrated contributor base Maturity57 Maturing project, gaining track record Bus Factor1 Top contributor holds 59.2% 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 ~222 days Total 7 Last Release 23d ago Major Versions v0.0.6 → v1.0.02026-01-10 ### Community Maintainers ![](https://avatars.githubusercontent.com/u/12487243?v=4)[kantorge](/maintainers/kantorge)[@kantorge](https://github.com/kantorge) --- Top Contributors [![kantorge](https://avatars.githubusercontent.com/u/12487243?v=4)](https://github.com/kantorge "kantorge (45 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (15 commits)")[![github-actions[bot]](https://avatars.githubusercontent.com/in/15368?v=4)](https://github.com/github-actions[bot] "github-actions[bot] (14 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 [grumpydictator/firefly-iii Firefly III: a personal finances manager. 23.9k69.5k](/packages/grumpydictator-firefly-iii)[nativephp/mobile NativePHP for Mobile 1.1k75.1k97](/packages/nativephp-mobile)[firefly-iii/data-importer Firefly III Data Import Tool. 8035.8k](/packages/firefly-iii-data-importer)[venturedrake/laravel-crm A free open source CRM built as a package for laravel projects 43411.2k](/packages/venturedrake-laravel-crm)[oat-sa/tao-core TAO core extension 66143.7k124](/packages/oat-sa-tao-core)[ronasit/laravel-helpers Provided helpers function and some helper class. 2085.6k31](/packages/ronasit-laravel-helpers) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)