Запрос R23: Получение обменного курса Национального Банка

Адрес: https://www.tws.by/tws/api/r23

Курс валюты запрашивается по коду валюты и дате. Если на переданную дату курс валюты не найден, возвращается ошибка. Если установлен параметр LatestAvailable=1, то при отсутствии курса валюта на переданную дату будет возвращён последний доступный курс.

Входные параметры

  • SessionKey – сессионный ключ, полученный из запроса R1. Обязательный параметр.
  • Currency – код валюты в соответствии с Классификатором валют.
  • Date – дата, на которую требуется получить курс валюты. Даты ранее 1 января 2010 года не поддерживаются. Формат YYYY-MM-DD.
  • LatestAvailable – признак получения последнего доступного курса в случае, если курс на переданную дату не доступен. 1 - возвращать последний доступный курс. 0 - возвращать ошибку, если курс не доступен.

Параметры JSON-ответа

  • CurrencyAmount – количество единиц иностранной валюты. Например для курса “3,3451 BYN за 100 RUB” тут будет значение “100”.
  • Rate – сумма в основной валюте за CurrencyAmount единиц запрашиваемой валюты.
  • Date – дата установки курса Национальным Банком. Если параметр LatestAvailable не установлен, эта дата всегда совпадает с датой Date из входящих параметров. Если LatestAvailable=1, эта дата курса, который был возвращён в качестве последнего доступного.