Получение официального курса белорусского рубля по отношению к иностранным валютам на определенную дату,

• устанавливаемого ежедневно:
  http://www.nbrb.by/Services/XmlExRates.aspx?ondate=01/31/2011
  
  
• устанавливаемого ежемесячно:
  http://www.nbrb.by/Services/XmlExRates.aspx?ondate=01/01/2011&period=1

Параметр ondate – дата в формате месяц/день/год, на которую запрашивается официальный курс. Если параметр ondate не задан, то Вы получите официальный курс на последнюю дату установления.

В первом случае возвращается XML-документ, состоящий из элемента DailyExRates, во втором (т.е. когда period=1) – MonthlyExRates. Оба элемента имеют одинаковую структуру: содержат атрибут Date, со значением равным дате, на которую получен официальный курс (для официального курса, устанавливаемого ежемесячно – дату установления курса, действовавшего на запрашиваемую дату), и вложенных элементов Currency.

Каждый элемент Currency содержит атрибут ID (внутренний код валюты – целое число) и вложенные элементы:

• NumCode – цифровой код
• CharCode – буквенный код
• Scale – номинал
• Name – наименование валюты
• Rate – курс.

Если указать параметр mode=1, то элементы Currency вместо элементов Name будут содержать элементы:

• QuotName – наименование валюты, содержащее номинал.

Полный перечень иностранных валют, к которым официальный курс белорусского рубля

• устанавливается ежедневно:
  http://www.nbrb.by/Services/XmlExRatesRef.aspx
  
  
• устанавливается ежемесячно:
  http://www.nbrb.by/Services/XmlExRatesRef.aspx?period=1

Возвращаемый XML-документ состоит из элемента DailyExRates (MonthlyExRates, если period=1) и вложенных элементов Currency. Каждый элемент Currency содержит атрибут ID (внутренний код валюты – целое число) и вложенные элементы:

• NumCode – цифровой код
• CharCode – буквенный код
• Scale – номинал
• Name – наименование валюты
• EnglishName – наименование на английском
• ParentCode – этот код используется для связи, при изменениях кодов или названий одной и той же валюты.

Для получения расширенной информации о валютах необходимо также передать параметр ext=1. В этом случае Currency будут состоять из элементов:

• NumCode – цифровой код
• CharCode – буквенный код
• Scale – номинал
• QuotName – наименование валюты, содержащее номинал
• QuotEnglishName – наименование на английском, содержащее номинал
• Name – наименование валюты
• EnglishName – наименование на английском
• DateStart – дата включения валюты в перечень валют, к которым Национальным банком устанавливается официальный курс белорусского рубля
• DateEnd – дата исключения валюты из перечня валют, к которым Национальным банком устанавливается официальный курс белорусского рубля (если не задана, то текущий элемент Currency может не содержать данный элемент)
• ParentCode – этот код используется для связи, при изменениях кодов или названий одной и той же валюты.

Получение динамики официального курса белорусского рубля по отношению к заданной иностранной валюте, устанавливаемого Национальным банком Республики Беларусь (не более чем за 365 дней):

• http://www.nbrb.by/Services/XmlExRatesDyn.aspx?curId=145&fromDate=3/1/2011&toDate=3/9/2011

Параметры:

• сurId – внутренний код валюты (целое число)
• fromDate – дата начала запрашиваемого периода в формате месяц/день/год
• toDate – дата окончания запрашиваемого периода в формате месяц/день/год.

Возвращается XML-документ состоящий из элемента Currency со следующими атрибутами:

• Id – внутренний код валюты (целое число)
• fromDate – первая дата внутри запрашиваемого периода, на которую установлен курс белорусского рубля к запрашиваемой валюте
• toDate – последняя дата внутри запрашиваемого периода, на которую установлен курс белорусского рубля к запрашиваемой валюте

и вложенных элементов Record. Каждый элемент Record содержит атрибут Date – дата установления курса и вложенный элемент Rate – официальный курс.

Получение цен на драгоценные металлы в виде банковских слитков за период (не более чем за 31 день):

• http://www.nbrb.by/Services/XmlMetals.aspx?metalId=0&fromDate=3/1/2011&toDate=3/9/2011

Параметры:

• metalId – внутренний код драгоценного металла (целое число), если не задан, то возвращаются цены на все драгоценные металлы
• fromDate – дата начала запрашиваемого периода в формате месяц/день/год
• toDate – дата окончания запрашиваемого периода в формате месяц/день/год.

Если параметры fromDate и toDate не заданы, то будут возращены цены на драгоценные металлы на последнюю дату установления.

Возвращаемый XML-документ состоит из элемента Metals со следующими атрибутами:

• fromDate – первая дата внутри запрашиваемого периода, на которую установлены цены на драгоценные металлы,
• toDate – последняя дата внутри запрашиваемого периода, на которую установлены цены на драгоценные металлы

и вложенных элементов AccountPrice.

Элементы AccountPrice содержат следующие атрибуты:

• Date – дата установления цены
• MetalId – внутренний код драгоценного металла (целое число)

и вложенные элементы Price – учетная цена.

Получение перечня драгоценных металлов, на которые Национальный банк устанавливает цены:

• http://www.nbrb.by/Services/XmlMetalsRef.aspx

Возвращаемый XML-документ состоит из элемента Metals и вложенных элементов Metal, содержащих атрибут Id (внутренний код драгоценного металла, целое число) и вложенных элементов:

• Name – наименование драгоценного металла
• NameEng – наименование на английском
• NameBel – наименование на белорусском.

Получение цен на драгоценные металлы в виде мерных слитков на дату:

• http://www.nbrb.by/Services/XmlIngots.aspx?onDate=09/27/2011

Параметр ondate – дата в формате месяц/день/год, на которую запрашиваются цены. Если параметр ondate не задан, то Вы получите цены на последнюю дату установления.

Возвращаемый XML-документ состоит из элемента Ingots с атрибутом onDate – дата установления цены, и вложенных элементов IngotsPrices.

Элементы IngotsPrices содержат следующие атрибуты:

• MetalId – внутренний код драгоценного металла (целое число)
• Nominal – Номинал, грамм (целое число)

и вложенные элементы:

• NoCertificateDollars – цена покупки без сертификата качества (в долларах США)*
• NoCertificateRubles – цена покупки без сертификата качества (в белорусских рублях)*
• CertificateDollars – цена покупки с сертификатом качества (в долларах США)*
• CertificateRubles – цена покупки с сертификатом качества (в белорусских рублях)*
• BanksDollars – цена продажи банкам (в долларах США)*
• BanksRubles – цена продажи банкам (в белорусских рублях)*
• EntitiesDollars – цена продажи юридическим и физическим лицам (за исключением банков, в долларах США)*
• EntitiesRubles – цена продажи юридическим и физическим лицам (за исключением банков, в белорусских рублях)*

* Если цена на запрашиваемую дату, соответствующая элементу, не установлена, то IngotsPrices не будут содержать данный элемент.

Получение курса белорусского рубля по отношению к основным иностранным валютам по итогам дополнительной торговой сессии ОАО БВФБ на дату:

• http://www.nbrb.by/Services/XmlStockAddRates.aspx?onDate=09/30/2011

Параметр ondate – дата в формате месяц/день/год, на которую запрашиваются цены. Если параметр ondate не задан, то Вы получите курс на последнюю дату установления.

Возвращаемый XML-документ состоит из элемента StockAddRates с атрибутом onDate – дата установления цены, и вложенных элементов Currency.

Каждый элемент Currency содержит вложенные элементы:

• NumCode – цифровой код
• CharCode – буквенный код
• Scale – номинал
• Name – наименование валюты
• NameBel – наименование валюты на белорусском языке
• Rate – курс.