API курсов валют National Bank of the Republic of Belarus
Официальные ежедневные курсы National Bank of the Republic of Belarus (Belarus) в формате JSON: 30 валют, история с 2026 года. Публикуемые курсы BYN для налоговой отчётности, аудита и выставления счетов.
О банке National Bank of the Republic of Belarus
Национальный банк Республики Беларусь устанавливает официальные курсы белорусского рубля каждый рабочий день — около 30 валют, публикуемых заранее и вступающих в силу со СЛЕДУЮЩЕГО календарного дня: пятничное решение уже содержит официальный курс понедельника. Именно на этот курс ссылается белорусское бухгалтерское и налоговое законодательство; банк также предоставляет один из самых удобных открытых JSON-API среди центробанков.
- Официальный сайт: www.nbrb.by
- Официальная публикация курсов: Official exchange rates
Быстрый старт
Один запрос для нужной пары — USD к BYN по официальному курсу National Bank of the Republic of Belarus:
curl "https://allratestoday.com/api/v1/central-bank/nbrb/latest?source=USD&target=BYN" \
-H "Authorization: Bearer art_live_your_key" Или полная опубликованная таблица банка:
curl "https://allratestoday.com/api/v1/central-bank/nbrb/latest" \
-H "Authorization: Bearer art_live_your_key" На платных тарифах — любая историческая дата или временной ряд:
curl "https://allratestoday.com/api/v1/central-bank/nbrb/history?source=USD&target=BYN&from=2025-01-01" \
-H "Authorization: Bearer art_live_your_key" Последние опубликованные курсы (2026-08-21)
Самая свежая таблица, опубликованная National Bank of the Republic of Belarus, — ровно то, что сейчас возвращает эндпоинт /latest. Значения указаны в BYN за 1 единицу каждой валюты:
Скачать таблицу: Excel (.xlsx) CSV (требуется платный тариф)
По одной строке на валюту за каждую дату публикации. До одного года за загрузку. Тарифицируется как один API-запрос за каждую валюту за каждый месяц данных.
| База | Котировка | Тип | Курс |
|---|---|---|---|
AED | BYN | reference | 0.8122299999999999 |
AMD | BYN | reference | 0.008879300000000001 |
AUD | BYN | reference | 2.126 |
BRL | BYN | reference | 0.5761700000000001 |
CAD | BYN | reference | 2.1669 |
CHF | BYN | reference | 3.7474 |
CNY | BYN | reference | 0.44496 |
CZK | BYN | reference | 0.144614 |
DKK | BYN | reference | 0.46708999999999995 |
EUR | BYN | reference | 3.4918 |
GBP | BYN | reference | 4.07 |
INR | BYN | reference | 0.031154 |
IRR | BYN | reference | 0.00000217 |
ISK | BYN | reference | 0.024558 |
JPY | BYN | reference | 0.018837 |
KGS | BYN | reference | 0.03411 |
KWD | BYN | reference | 9.6785 |
KZT | BYN | reference | 0.0065266000000000005 |
MDL | BYN | reference | 0.17373 |
NOK | BYN | reference | 0.32047 |
NZD | BYN | reference | 1.7773 |
PLN | BYN | reference | 0.80883 |
RUB | BYN | reference | 0.035783999999999996 |
SEK | BYN | reference | 0.31564000000000003 |
SGD | BYN | reference | 2.3476 |
TRY | BYN | reference | 0.0622 |
UAH | BYN | reference | 0.067105 |
USD | BYN | reference | 2.9829 |
VND | BYN | reference | 0.00011427799999999999 |
XDR | BYN | reference | 4.0844 |
Клиент для Node.js / TypeScript
Отдельный npm-пакет без зависимостей оборачивает эти эндпоинты — nbrb-exchange-rate:
npm install nbrb-exchange-rate import { getRate } from 'nbrb-exchange-rate';
const pair = await getRate('USD', 'BYN', { apiKey: 'art_live_...' });
console.log(pair.rate, pair.rate_date); Ноль зависимостей, типы TypeScript в комплекте; работает везде, где есть fetch — Node 18+, Bun, Deno и edge-среды.
Зачем нужен официальный курс National Bank of the Republic of Belarus?
Рыночные курсы меняются непрерывно, но налоговая отчётность, таможенные декларации, аудит и бухгалтерский учёт (Belarus и не только) обычно требуют официальный курс, опубликованный National Bank of the Republic of Belarus на конкретную дату — фиксированное число, на которое можно ссылаться и которое не меняется после публикации. Этот API отдаёт именно такие таблицы с датой публикации банка (rate_date) в каждом ответе; в выходные и праздники возвращается последняя опубликованная дата — именно этот курс требуют применять правила комплаенса.
Пары, которые банк не публикует напрямую, вычисляются из его таблицы (обратный или кросс-курс через BYN) и явно помечаются "derived": true — опубликованное банком и вычисленное никогда не смешиваются.
Эндпоинты
GET /api/v1/central-bank/nbrb/latest— последняя таблица или одна пара (все тарифы)GET /api/v1/central-bank/nbrb/{YYYY-MM-DD}— таблица на любую дату (платные тарифы)GET /api/v1/central-bank/nbrb/history— временной ряд, до 5 000 строк (платные тарифы)GET /api/v1/central-bank/nbrb/availability— календарь публикаций: даты, на которые банк реально публиковал таблицу (все тарифы)
Полное описание параметров — в документации API. Каждый запрос учитывается в месячной квоте тарифа; курсы меняются раз в рабочий день, поэтому локальное кеширование опубликованной таблицы сильно экономит даже небольшую квоту.
Часто задаваемые вопросы
Есть ли API для курсов валют National Bank of the Republic of Belarus?
Да — этот. Официальные ежедневные курсы BYN в чистом JSON; последняя таблица на любом тарифе, включая бесплатный.
Как часто обновляются курсы?
National Bank of the Republic of Belarus публикует курсы один раз в рабочий день; API загружает каждую новую таблицу вскоре после публикации (последняя: 2026-08-21).
Это официальные курсы?
Да — данные берутся из публикаций самого National Bank of the Republic of Belarus и отдаются без изменений с датой публикации банка. Всё вычисленное, а не опубликованное, помечается флагом derived.
Курсы National Bank of the Republic of Belarus — один API-ключ
Последняя таблица на любом тарифе. История с 2026 года на платных тарифах. Кредитная карта не нужна.
Получить бесплатный API-ключ Документация