PHPackages                             kalimeromk/nbrm - 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. [API Development](/categories/api)
4. /
5. kalimeromk/nbrm

ActivePackage[API Development](/categories/api)

kalimeromk/nbrm
===============

This package provides seamless integration with the web service of the National Bank of the Republic of Macedonia (NBRM). It allows Laravel applications to fetch foreign exchange rates and currency data directly from NBRM’s official API.

1.3(1y ago)14MITPHPPHP >=8.0

Since Feb 8Pushed 1y ago1 watchersCompare

[ Source](https://github.com/KalimeroMK/nbrm)[ Packagist](https://packagist.org/packages/kalimeromk/nbrm)[ RSS](/packages/kalimeromk-nbrm/feed)WikiDiscussions master Synced today

READMEChangelog (3)Dependencies (3)Versions (3)Used By (0)

Laravel NBRM Package
====================

[](#laravel-nbrm-package)

Description
-----------

[](#description)

The `kalimeromk/nbrm` package provides a Laravel service for retrieving exchange rates from the **National Bank of the Republic of Macedonia (NBRM)**. The package allows users to fetch daily exchange rates and exchange rates for government institutions.

Installation
------------

[](#installation)

To install the package, use composer:

```
composer require kalimeromk/nbrm
```

Configuration
-------------

[](#configuration)

Publish the package configuration:

```
php artisan vendor:publish --tag=config --provider="Kalimeromk\Nbrm\NBRMExchangeServiceProvider"
```

Then, update your `.env` file with the API base URL:

```
NBRM_BASE_URL=https://www.nbrm.mk/KLServiceNOV/
NBRM_FORMAT=json
```

Usage
-----

[](#usage)

Import the facade in your Laravel project:

```
use Kalimeromk\Nbrm\Facades\NBRMExchange;
```

### Get Exchange Rate

[](#get-exchange-rate)

```
$response = NBRMExchange::getExchangeRate('01.02.2024', '08.02.2024');
print_r($response);
```

### Get Exchange Rate (Detailed Format)

[](#get-exchange-rate-detailed-format)

```
$response = NBRMExchange::getExchangeRateD('01-Feb-2024', '08-Feb-2024');
print_r($response);
```

### Get Exchange Rates (All Currencies)

[](#get-exchange-rates-all-currencies)

```
$response = NBRMExchange::getExchangeRates('01.02.2024', '08.02.2024');
print_r($response);
```

### Get Exchange Rates (Detailed Format)

[](#get-exchange-rates-detailed-format)

```
$response = NBRMExchange::getExchangeRatesD('01-Feb-2024', '08-Feb-2024');
print_r($response);
```

Testing
-------

[](#testing)

Run the PHPUnit tests to verify that the package works correctly:

```
vendor/bin/phpunit
```

License
-------

[](#license)

This package is open-sourced software licensed under the **MIT License**.

###  Health Score

26

—

LowBetter than 41% of packages

Maintenance40

Moderate activity, may be stable

Popularity5

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity44

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% 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 ~0 days

Total

2

Last Release

510d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/472c4da0220f15747dd81d3a27ffbba022a06ab20f64a367ddcaacd790d812d7?d=identicon)[KalimeroMK](/maintainers/KalimeroMK)

---

Top Contributors

[![KalimeroMK](https://avatars.githubusercontent.com/u/24772657?v=4)](https://github.com/KalimeroMK "KalimeroMK (6 commits)")

---

Tags

exchangelaravelnbrmlaravel

###  Code Quality

TestsPHPUnit

Static AnalysisRector

### Embed Badge

![Health badge](/badges/kalimeromk-nbrm/health.svg)

```
[![Health](https://phpackages.com/badges/kalimeromk-nbrm/health.svg)](https://phpackages.com/packages/kalimeromk-nbrm)
```

###  Alternatives

[rakibdevs/openweather-laravel-api

Laravel package to connect https://openweathermap.org/ to get customized weather data for any location on the globe immediately

7652.6k](/packages/rakibdevs-openweather-laravel-api)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)