NBRM Exchange Rate API: Official Macedonian Denar Rates as JSON

The National Bank of North Macedonia publishes the official exchange rates that accounting, tax, and customs practice in North Macedonia reference — published official rates, not moving market prices. This guide shows how to pull them as JSON: via a REST endpoint or the zero-dependency nbrm-exchange-rate npm package.

The kursna lista, since 1993

The NBRM’s daily kursna lista carries middle, buying and selling rates for 31 currencies — and because the denar has tracked the euro in a tight managed band for two decades, EUR/MKD ~61.5 is the figure Macedonian contracts and accounting live on. The series has run without a break since 1993, the denar’s first year as a full currency.

Why official rates, not market rates

A live mid-market exchange rate API answers "what is EUR/MKD trading at right now?" — the right tool for checkouts and dashboards. But accountants, auditors, and tax authorities ask a different question: "which rate were you required to use for this date?" That answer comes from the National Bank of North Macedonia’s published rates, and it never changes after publication.

Get the latest rates (REST)

curl "https://allratestoday.com/api/v1/central-bank/nbrm/latest" \
  -H "Authorization: Bearer YOUR_API_KEY"

The response is the bank’s most recent published table — one row per pair in its own quoting direction, the publication date (rate_date) and a freshness flag. Live example captured 2026-10-09:

{
  "bank": "nbrm",
  "name": "National Bank of North Macedonia",
  "rate_date": "2026-10-09",
  "age_days": 1,
  "stale": false,
  "cadence": "daily",
  "rates": [
    {"base": "AUD", "quote": "MKD", "type": "buy", "value": 38.0994},
    {"base": "AUD", "quote": "MKD", "type": "reference", "value": 38.2909},
    {"base": "AUD", "quote": "MKD", "type": "sell", "value": 38.4824},
    {"base": "BRL", "quote": "MKD", "type": "reference", "value": 10.9923},
    … 47 more rows
  ],
  "disclaimer": "Official rates as published by the named central bank. On weekends/holidays the most recent published rate_date is returned."
}

Most integrations need one pair. Add source and target and the API returns a single resolved rate — derived: false when National Bank of North Macedonia printed the pair itself:

curl "https://allratestoday.com/api/v1/central-bank/nbrm/latest?source=EUR&target=MKD" \
  -H "Authorization: Bearer YOUR_API_KEY"

{
  "bank": "nbrm",
  "name": "National Bank of North Macedonia",
  "rate_date": "2026-10-09",
  "source": "EUR",
  "target": "MKD",
  "rate": 61.3782,
  "rate_type": "buy",
  "derived": false,
  "method": "published",
  "age_days": 1,
  "stale": false,
  "cadence": "daily",
  "disclaimer": "Official rates as published by the named central bank. On weekends/holidays the most recent published rate_date is returned."
}

The response is the bank's most recent published table — every rate and the publication date. The latest rates are available on every plan, including the free tier (no credit card).

The npm SDK

npm install nbrm-exchange-rate

import { getRate, getLatestRates } from 'nbrm-exchange-rate';

// One pair at the official rate
const pair = await getRate('EUR', 'MKD', { apiKey: 'art_live_...' });
console.log(pair.rate, pair.rate_date);

// The bank's full published table
const table = await getLatestRates({ apiKey: 'art_live_...' });
console.log(table.rate_date, table.rates.length);

Zero dependencies, TypeScript types included, and it runs anywhere fetch exists — Node 18+, Bun, Deno, and edge runtimes.

Historical rates for an invoice date

import { getRatesForDate, getHistory } from 'nbrm-exchange-rate';

const day = await getRatesForDate('2026-08-18', { apiKey: 'art_live_...' });

const series = await getHistory(
  { source: 'EUR', target: 'MKD', from: '2026-01-01' },
  { apiKey: 'art_live_...' }
);

Historical dates and time series need a paid plan; the latest rates stay free.

Published vs derived pairs

If the National Bank of North Macedonia does not print a pair directly, the API resolves it from the bank's published rates — an inverse, or a cross via MKD — and flags it derived: true with the method used. Official and computed values are never silently mixed, which is exactly the distinction an auditor will ask about.

The archive

The archive reaches back to 1 January 1993 — through the 1990s stabilisation and the euro era — with every list dated by its validity day.

FAQ

Does the National Bank of North Macedonia have an official exchange rate API?

The bank publishes its official rates on its own site, and AllRatesToday serves the same published rates as clean JSON via REST or the nbrm-exchange-rate npm package. The latest table is free.

How do I get the official North Macedonia exchange rate for a past date?

The rates-for-date endpoint returns the official table for any archived date; non-publication days resolve to the most recent published date and are flagged, so audit trails stay honest. Historical dates require a paid plan; latest rates are free.

Does the API serve the middle rate or the buy/sell quotes?

All three: the sreden (middle) rate is served as rate_type "reference", with kupoven/prodazen as "buy" and "sell" — the same three columns the bank's own list prints.