Каталог

Курсы валют НБ РБ 💱

Применять, когда пользователь спрашивает курс любой иностранной валюты к белорусскому рублю или конвертацию с участием BYN: «какой курс доллара/евро/рубля», «сколько будет 100 USD в BYN», «переведи 50 долларов в рубли», «курс на 10 января», «динамика/изменение курса за период». Триггеры: курс, обменный курс, валюта, доллар, евро, рубль, USD, EUR, RUB, CNY, НБ РБ, Нацбанк, конвертация, «сколько будет…в рублях/долларах». Не применять для криптовалют

Обновлено 2026-09-27

Источник данных

Официальный курс белорусского рубля от Национального банка Республики Беларусь — API api.nbrb.by.
Запросы выполнять инструментом download_file (ответы — JSON, размер маленький).
Данные официальные, курс устанавливается НБ РБ. В ответе пользователю указывать источник: «по данным НБ РБ».

Эндпоинты

1. Курс на дату

https://api.nbrb.by/exrates/rates/{cur_id}?parammode=2 (+ опционально &ondate=ГГГГ-ММ-ДД)
- parammode=0 — внутренний код (напр. 431 = USD), 1 — цифровой код ИСО 4217 (840 = USD), 2 — буквенный код ИСО 4217 (USD). По умолчанию использовать parammode=2 (буквенный код) — проще всего.
- Без ondate — курс на сегодня.
- periodicity=0 — ежедневный курс, 1 — ежемесячный.
- Ответ (класс Rate): Cur_ID, Date, Cur_Abbreviation, Cur_Scale (кол-во единиц валюты), Cur_Name, Cur_OfficialRate.
- Пример: https://api.nbrb.by/exrates/rates/USD?parammode=2 → доллар на сегодня.

2. Динамика курса (до 365 дней)

https://api.nbrb.by/exrates/rates/dynamics/{cur_id}?startdate=ГГГГ-ММ-ДД&enddate=ГГГГ-ММ-ДД
- cur_id — только внутренний код (узнать через rates-запрос: поле Cur_ID).
- Ответ — массив объектов: Date, Cur_OfficialRate.

3. Перечень валют (если нужен поиск кода)

https://api.nbrb.by/exrates/currencies — все валюты; https://api.nbrb.by/exrates/currencies/456 — одна.
- Класс Currency: Cur_ID, Cur_Abbreviation, Cur_Name, Cur_Name_Bel, Cur_Scale, Cur_Periodicity, Cur_DateStart, Cur_DateEnd и др.
- Использовать только когда буквенный код неизвестен или не принимается API.

Правила ответа

  1. Курс показывать с учётом Cur_Scale: «100 российских рублей = 3,5843 BYN», «1 доллар США = 3,0316 BYN».
  2. Выходные и праздники: курс не устанавливается — на сб/вс возвращается курс пятницы (это нормально, пояснять «курс на 27.09 (воскресенье) — пятничный»). Не считать это ошибкой.
  3. Несколько валют запрашивать параллельно (USD + EUR + RUB — типовой набор).
  4. Округление: 4 знака после запятой, как в API.
  5. Если пользователь просит курс на будущую дату — объяснить, что курс публикуется НБ РБ, на будущее unavailable; показать последний известный.
  6. Если дата — выходной, API вернёт пятничный курс автоматически; отдельный запрос не нужен.

Конвертация

  • Валюта → BYN: сумма × Cur_OfficialRate / Cur_Scale
  • BYN → валюта: сумма / (Cur_OfficialRate / Cur_Scale)
  • Пример: $50 → 50 × 3,0316 / 1 = 151,58 BYN.
  • Конвертация валюта → валюта: через BYN (NBRB не даёт кросс-курсы напрямую).
  • Это официальный курс НБ РБ — для справки; банковские курсы обмена отличаются (в банках курс покупки/продажи).

Типовые сценарии

  • «Какой курс доллара?» → rates USD (+ EUR, RUB по контексту — в РБ обычно интересуют все три).
  • «Сколько будет 100 евро в рублях?» → rates EUR + конвертация.
  • «Динамика доллара за месяц» → dynamics с внутренним кодом (для USD это 431), показать тренд: рост/падение за период, min/max.
  • «Курс на 10 января» → rates с ondate=ГГГГ-ММ-ДД.

Проверенные примеры (2026-09-27)

  • USD: 3,0316 BYN за 1 USD
  • EUR: 3,4487 BYN за 1 EUR
  • RUB: 3,5843 BYN за 100 RUB