Веб-сервис
http://www.nbrb.by/Services/ExRates.asmx
Описание методов веб-сервиса:
Официальный курс белорусского рубля по отношению к иностранным валютам, устанавливаемый Национальным банком
Получение официального курса белорусского рубля по отношению к иностранным валютам на определенную дату,
- устанавливаемого ежедневно:
ExRatesDaily(ByVal onDate As DateTime) As DataSet
- устанавливаемого ежемесячно:
ExRatesMonthly(ByVal onDate As DateTime) As DataSet
Параметр: onDate – дата в формате System.DateTime, на которую запрашивается курс.
Метод ExRatesDaily возвращает XML-документ в формате System.Data.Dataset, содержащий таблицу DailyExRatesOnDate, метод ExRatesMonthly – аналогичный XML-документ, но содержащий таблицу MonthlyExRatesOnDate.
Обе таблицы имеют одинаковую структуру:
- Cur_QuotName – наименование валюты, содержащее номинал
- Cur_Scale – номинал
- Cur_OfficialRate – курс
- Cur_Code – цифровой код
- Cur_Abbreviation – буквенный код.
Возвращаемый DataSet в свойстве ExtendedProperties содержит элемент с ключом "onDate" и значением равным дате, на которую получен официальный курс. Для официального курса, устанавливаемого ежемесячно, элемент с ключом "onDate" содержит дату установления курса, действовавшего на запрашиваемую дату.
| Полный перечень иностранных валют, по отношению к которым Национальным банком устанавливается официальный курс белорусского рубля:
- CurrenciesRef(ByVal Periodicity As Integer) As DataSet
Параметр Periodicity – периодичность установления курса (0 – ежедневно, 1 – ежемесячно).
Метод возвращает XML-документ в формате System.Data.Dataset, содержащий таблицу DailyCurrenciesRef (Periodicity=0) или таблицу MonthlyCurrenciesRef (Periodicity=1). Обе таблицы имеют одинаковую структуру:
- Cur_Id – внутренний код
- Cur_QuotName – наименование валюты, содержащее номинал
- Cur_QuotName_Eng – наименование на английском, содержащее номинал
- Cur_Scale – номинал
- Cur_Code – цифровой код
- Cur_Abbreviation – буквенный код
- Cur_Name – наименование валюты
- Cur_Name_Eng – наименование на английском
- Cur_DateStart – дата включения валюты в перечень валют, к которым устанавливается официальный курс белорусского рубля
- Cur_DateEnd – дата исключения валюты из перечня валют, к которым устанавливается официальный курс белорусского рубля*
- Cur_ParentID – этот код используется для связи, при изменениях кодов или названий фактически одной и той же валюты.
Методы CurrenciesRefDaily и CurrenciesRefMonthly являются устаревшими.
| |
Получение динамики официального курса белорусского рубля по отношению к заданной иностранной валюте (не более чем за 365 дней):
- ExRatesDyn(ByVal сurId As Integer, ByVal fromDate As DateTime, ByVal toDate As DateTime) As DataSet
Параметры:
- сurId – внутренний код валюты (целое число)
- fromDate – дата начала запрашиваемого периода в формате System.DateTime
- toDate – дата окончания запрашиваемого периода в формате System.DateTime.
Метод возвращает XML-документ в формате System.Data.Dataset, содержащий таблицу Currency. Структура таблицы:
- Date – дата установления курса
- Cur_OfficialRate – курс.
Возвращаемый DataSet в свойстве ExtendedProperties содержит следующие элементы:
- ключ "Id", значение – внутренний код валюты
- ключ "fromDate", значение – первая дата внутри запрашиваемого периода, на которую установлен курс белорусского рубля к запрашиваемой валюте
- ключ "toDate", значение – последняя дата внутри запрашиваемого периода, на которую установлен курс белорусского рубля к запрашиваемой валюте.
| |
Последняя дата установления официального курса белорусского рубля по отношению к иностранным валютам, на
- ежедневной основе:
LastDailyExRatesDate() As DateTime
- ежемесячной основе:
LastMonthlyExRatesDate() As DateTime
Начальная дата установления официального курса белорусского рубля по отношению к иностранным валютам:
- StartDate (ByVal Periodicity As Integer) As DateTime
Параметр Periodicity – периодичность установления курса (0 – ежедневно, 1 – ежемесячно).
|
Учетные цены на драгоценные металлы в виде банковских слитков, устанавливаемые Национальным банком
Получение учетных цен на драгоценные металлы в виде банковских слитков за период (не более чем за 31 день):
- MetalsPrices(ByVal MetalId As Integer, ByVal fromDate As DateTime, ByVal toDate As DateTime) As DataSet
Параметры:
- MetalId – внутренний код драгоценного металла (целое число), если MetalId=-1, возвращаются цены на все драгоценные металлы
- fromDate – дата начала запрашиваемого периода в формате System.DateTime
- toDate – дата окончания запрашиваемого периода в формате System.DateTime.
Метод возвращает XML-документ в формате System.Data.Dataset, содержащий таблицу AccountPrice.
Структура таблицы AccountPrice:
- Date – дата установления цены
- MetalId – внутренний код драгоценного металла (целое число)
- Value – учетная цена.
Возвращаемый DataSet в свойстве ExtendedProperties содержит следующие элементы:
- ключ "fromDate", значение – первая дата внутри запрашиваемого периода, на которую установлены цены на драгоценные металлы
- ключ "toDate", значение – последняя дата внутри запрашиваемого периода, на которую установлены цены на драгоценные металлы.
| Получение перечня драгоценных металлов, на которые Национальный банк устанавливает цены:
Метод возвращает XML-документ в формате System.Data.Dataset, содержащий таблицу MetalsRef.
Структура таблицы MetalsRef:
- Id – внутренний код драгоценного металла (целое число)
- Name – наименование на русском языке
- NameBel – наименование на белорусском языке
- NameEng – наименование на английском языке.
| |
Последняя дата установления учетных цен на драгоценные металлы в виде банковских слитков:
- MetalsLastDate() As DateTime
|
Цены покупки и продажи Национальным банком драгоценных металлов в виде мерных слитков
Получение цен на драгоценные металлы в виде мерных слитков на дату:
- IngotsPrices(ByVal onDate As DateTime) As DataSet
Параметры:
- onDate – дата в формате System.DateTime, на которую запрашиваются цены.
Метод возвращает XML-документ в формате System.Data.Dataset, содержащий таблицу IngotsPrices.
Структура таблицы IngotsPrices:
- Date – дата установления цены
- MetalId – внутренний код драгоценного металла (целое число)
- NoCertificateDollars – цена покупки без сертификата качества (в долларах США)*
- NoCertificateRubles – цена покупки без сертификата качества (в белорусских рублях)*
- CertificateDollars – цена покупки с сертификатом качества (в долларах США)*
- CertificateRubles – цена покупки с сертификатом качества (в белорусских рублях)*
- BanksDollars – цена продажи банкам (в долларах США)*
- BanksRubles – цена продажи банкам (в белорусских рублях)*
- EntitiesDollars – цена продажи юридическим и физическим лицам (за исключением банков, в долларах США)*
- EntitiesRubles – цена продажи юридическим и физическим лицам
(за исключением банков, в белорусских рублях)*.
Возвращаемый DataSet в свойстве ExtendedProperties содержит следующие элементы:
- ключ "onDate", значение – дата установления цены.
| |
Последняя дата установления цен на драгоценные металлы в виде мерных слитков:
- IngotsLastDate () As DateTime
|
Курс белорусского рубля по отношению к иностранным валютам по итогам дополнительной торговой сессии ОАО БВФБ
Получение курса белорусского рубля по отношению к основным иностранным валютам по итогам дополнительной торговой сессии ОАО БВФБ на дату:
- StockAddRates(ByVal onDate As DateTime) As DataSet
Параметры:
- onDate – дата в формате System.DateTime, на которую запрашивается курс.
Метод возвращает XML-документ в формате System.Data.Dataset, содержащий таблицу StockAddRates.
Структура таблицы StockAddRates:
- Cur_QuotName – наименование валюты, содержащее номинал
- Cur_QuotName_Bel – наименование валюты на белорусском языке, содержащее номинал
- Cur_Scale – номинал
- Cur_Rate – курс
- Cur_Code – цифровой код
- Cur_Abbreviation – буквенный код.
Возвращаемый DataSet в свойстве ExtendedProperties содержит следующие элементы:
- ключ "onDate", значение – дата установления курса.
| |
Последняя дата установления курса белорусского рубля по отношению к основным иностранным валютам по итогам дополнительной торговой сессии ОАО БВФБ:
- StockAddRatesLastDate () As DateTime
|
Пример работы с веб–сервисом Demo.zip на VB.NET.
* Поле может принимать пустое значение DbNull. |
|