Exchange Rates Services

Back

TECHNICAL INSTRUCTIONS for the web service of the National Bank for the exchange rate list and the exchange rates for government authorities

For automated downloading of the exchange rate list from the web page of the National Bank of the Republic of North Macedonia, web service for downloading data in xml or JSON format is available on:

https://www.nbrm.mk/KLServiceNOV/imenametoda?StartDate=dd.MM.yyyy&EndDate=dd.MM.yyyy&format=(xml or json)

or

https://www.nbrm.mk/KLServiceNOV/imenametoda?StartDate=dd-MМM-yyyy&EndDate=dd-MМM-yyyy&format=(xml or json)

The web service includes four methods. The first two methods refer to the exchange rate list, while the other two refer to the NBRNM exchange rates for conducting international payment operations for the needs of the government authorities.

Exchange rate list:

  1. GetExchangeRate
    https://www.nbrm.mk/KLServiceNOV/GetExchangeRate?StartDate=dd.MM.yyyy&EndDate=dd.MM.yyyy&format=(xml or json)
  2. GetExchangeRateD
    https://www.nbrm.mk/KLServiceNOV/GetExchangeRateD?StartDate=dd-MMM-yyyy&EndDate=dd-MMM-yyyy&format=(xml or json)

The NBRNM exchange rates for conducting international payment operations for the needs of the government authorities:

  1. GetExchangeRates
    https://www.nbrm.mk/KLServiceNOV/GetExchangeRates?StartDate=dd.MM.yyyy&EndDate=dd.MM.yyyy&format=(xml or json)
  2. GetExchangeRatesD
    https://www.nbrm.mk/KLServiceNOV/GetExchangeRatesD?StartDate=dd-MMM-yyyy&EndDate=dd-MMM-yyyy&format=(xml or json)

When calling the web methods: GetExchangeRate and GetExchangeRateD identical result is obtained: exchange rate list of the National Bank of the Republic of North Macedonia. The only difference between them is the data type of the parameters that are being forwarded:

1. GetExchangeRateaccepts two parameters: StartDate and EndDate. Both parameters should have a String format and present a valid date in the form: dd.MM.yyyy (For example:StartDate=01.02.2010;EndDate=15.02.2010)

https://www.nbrm.mk/KLServiceNOV/GetExchangeRate?StartDate=dd.MM.yyyy&EndDate=dd.MM.yyyy&format=(xml%20or%20json)

2. GetExchangeRateD accepts two parameters: StartDate and EndDate. Both parameters should have Date format and present a valid date. (For example: StartDate=12-feb-2010; EndDate=15-feb-2010)

https://www.nbrm.mk/KLServiceNOV/GetExchangeRateD?StartDate=dd-MMM-yyyy&EndDate=dd-MMM-yyyy&format=(xml%20or%20json)

When calling the web methods GetExchangeRate and GetExchangeRateD, an exchange rate list created from the following fields has accordingly been obtained:

  1. Field: RBr (data type: double) - 'Number of exchange rate list'
  2. Field: Datum (data type: dateTime) - 'Exchange rate list validity date'
  3. Field: Valuta (data type: double) - 'Currency code'
  4. Field: Nomin (data type: double) - 'Currency units'
  5. Field: Oznaka (data type: string) - 'Type of currency'
  6. Field: Drzava (data type: string) - 'Country name - in Macedonian'
  7. Field: DrzavaAng (data type: string) - 'Country name - in English'
  8. Field: DrzavaAl (data type: string) - 'Country name - in Albanian'
  9. Field: NazivMak (data type: string) - 'Type of currency - in Macedonian'
  10. Field: NazivAng (data type: string) - 'Type of currency - in English'
  11. Field: NazivAl (data type: string) - 'Type of currency - in Albanian'
  12. Field: Sreden (data type: double) - 'Middle exchange rate in Denars'
  13. Field: Datum_f (data type: double) - 'Date of creation of exchange rate list'

When calling the web methods: GetExchangeRates and GetExchangeRatesD, identical result is obtained: The NBRNM exchange rates for conducting international payment operations for the needs of the government authorities. The only difference between them is the data type of the parameters that are being forwarded:

3. GetExchangeRatesthat accepts two parameters: StartDate and EndDate. Both parameters should have а String format and present valid date in the form: dd.MM.yyyy (For example: StartDate=01.02.2010; EndDate=15.02.2010)

https://www.nbrm.mk/KLServiceNOV/GetExchangeRates?StartDate=dd.MM.yyyy&EndDate=dd.MM.yyyy&format=(xml%20or%20json)

4. GetExchangeRatesD that accepts two parameters: StartDate and EndDate.Both parameters should have Date format and present valid date. (For example: StartDate=12-feb-2010; EndDate=15-feb-2010)

https://www.nbrm.mk/KLServiceNOV/GetExchangeRatesD?StartDate=dd-MMM-yyyy&EndDate=dd-MMM-yyyy&format=(xml%20or%20json)

When calling the web methods GetExchangeRates and GetExchangeRatesD, an exchange rate list created from the following fields has accordingly been obtained:

  1. Field: RBr (data type: double) - 'Number of exchange rate list'
  2. Field: Datum (data type: dateTime) - 'Exchange rate list validity date'
  3. Field: Valuta (data type: double) - 'Currency code'
  4. Field: Nomin (data type: double) - 'Currency units'
  5. Field: Oznaka (data type: string) - 'Type of currency'
  6. Field: Drzava (data type: string) - 'Country name - in Macedonian'
  7. Field: DrzavaAng (data type: string) - 'Country name - in English'
  8. Field: DrzavaAl (data type: string) - 'Country name - in Albanian'
  9. Field: NazivMak (data type: string) - 'Type of currency - in Macedonian'
  10. Field: NazivAng (data type: string) - 'Type of currency - in English'
  11. Field: NazivAl (data type: string) - 'Type of currency - in Albanian'
  12. Field: Sreden (data type: double) - 'Middle exchange rate in Denars'
  13. Field: Kupoven (data type: double) - 'Buying rate in Denars'
  14. Field: Prodazen (data type: double) - 'Selling rate in Denars'
  15. Field: Datum_f (data type: double) - 'Date of creation of exchange rate list'

For more technical information about these methods please contact the responsible persons in the National Bank through the IT Service Desk on +389 2 3108555.