API for obtaining the interbank market rates

1. Obtaining values of average interest rates and volumes of interbank credits and deposits:

Request address: https://www.nbrb.by/API/InterbankRates/{Periodicity}/{Date}

Request parameters:

  • Periodicity –the value of the period, data for which you want to receive
    1 – data for the year
    2 – monthly data
    3 – data for a specific date
  • Date – зrequired date value in yyyy-mm-dd format
    Depending on the value of the Periodicity parameter, this parameter should have the following form:
    Periodicity = 1 – {year}-01-01 (for example, 2021-01-01 to display data for 2021)
    Periodicity = 2 – {year}-{month}-01 (нfor example, 2021-07-01 to display data for July 2021)
    Periodicity = 3 – {year}-{month}-{day} (for example, 2021-07-12 to display data as of July 12, 2021).
    If the specified date falls on a weekend, the data will be displayed on the 1st business day preceding the specified date.
Note:
  1. If the Date parameter specifies dates before 2020-02-01 or after the current date, the status 204 response "No Content" is returned (the server has successfully processed the request, there is no data).
  2. Data for the reporting year are published in January of the year following the reporting year, according to the Schedule of preliminary dates for the publication of official statistical information.

Result: Returns an array of objects of the InterbankRates class

The InterbankRates class contains the following properties:

  • Periodicity – the value of the Periodicity parameter from the array containing the reference of the periods of the requested data
  • Currency – the value of the Name parameter from the array containing the reference of currencies
  • Date – the date on which the data is requested
  • CreditTermId – the value of the CreditTermId parameter from the array containing the reference of terms of credits and deposits)
  • Sum – total for the republic, amount, thousand currency units
  • Percent – total for the republic, rate,% per annum
  • NonResidentSum – with non-residents, amount, thousand currency units
  • NonResidentPercent – with non-residents, rate,% per annum
  • ResidentSum – with residents, amount, thousand currency units
  • ResidentPercent – with residents, rate,% per annum
Examples of use:

2. Obtaining the frequency of data on average interest rates and volumes of interbank credits and deposits:

Request address: https://www.nbrb.by/API/InterbankRates/Periodicity

Result: Returns an array of objects of the Periodicity class.

The Periodicity class contains the following properties:

  • Periodicity – value of a period
  • Ru – name of a period in Russian
  • Be – name of a period in Belarusian
  • En – name of a period in English

3. Obtaining a list of currencies for which average interest rates and volumes of interbank credits and deposits are set:

Request address: https://www.nbrb.by/API/InterbankRates/Currency

Result: Returns an array of objects of the Currency class.

The Currency class contains the following properties:

  • Name – currency code
  • Ru – name of currency in Russian
  • Be – name of currency in Belarusian
  • En – name of currency in English

4. Obtaining the terms of credits and deposits, for which the average interest rates and volumes are set:

Request address: https://www.nbrb.by/API/InterbankRates/CreditTermId

Result: Returns an array of objects of the CreditTermId class.

The CreditTermId class contains the following properties:

  • CreditTermId – ID value of the term of credits and deposits
  • Ru – name of a term in Russian
  • Be – name of a term in Belarusian
  • En – name of a term in English

 We kindly ask you to submit comments and suggestions on the work of the API to the following address: email@nbrb.by.