MNB Exchange Rate API

Docs - mnb.hu

Install

yarn add mnb-exchange-rate

Usage

Client singleton

import {getClient} from 'mnb-exchange-rate';

const client = await getClient();

Escape hatch to soap library

client.soap.addSoapHeader('X-Foo', 'bar');

General information

const info = await client.GetInfo();

{
  FirstDate: "1949-01-03",
  LastDate: "2025-11-21",
  Currencies: [
    "HUF",
    // ....
    "YUD",
  ],
};

Available currencies

const currencies = await client.GetCurrencies();

{
  Currencies: [
    "HUF",
    // ....
    "YUD",
  ],
}

Currency units

const units = await client.GetCurrencyUnits({currencies: ['EUR', 'JPY']});

{
  EUR: 1,
  JPY: 100,
}

Range of historic data

const interval = await client.GetDateInterval();

{
  FirstDate: "1949-01-03",
  LastDate: "2025-11-21",
}

Current exchange rate of all currencies

const rate_current = await client.GetCurrentExchangeRates();

{
  AUD: 214.62,
  // ...
  ZAR: 19.22,
}

Get exchange rate by interval and specific currencies

const rates = await client.GetExchangeRates({
  startDate: '2025-02-02',
  endDate: '2025-02-04',
  currencies: ['EUR'],
});

{
  "2025-02-04": {
    EUR: 408.06,
  },
  "2025-02-03": {
    EUR: 409.3,
  },
}