Перейти в режим автора

Получение истории курсов обмена

XML-интерфейс для автоматического получения информации о среднем курсе обмена в указанном направлении на любую дату и время с точностью до 1 часа.
Интерфейс актуализирует информацию несколько раз в час.

  • параметры запроса:
    название назначение примечание
    exchtype числовое значение направления обмена числовое значение направления обмена (числа в диапазоне 1-116), по которому необходимо получить историю соответствия чисел направлениям обмена, приведены в интерфейсе получение текущих доступных объемов обмена. Параметр обязателен.
    grouptype минимальный интервал времени, внутри которого необходимо получить среднее значение курса имеет четыре значения 1-месячный интервал, 2-недельный интервал, 3-дневной интервал, 4-часовой интервал. Например, при выборе дневного интервала (значение 3) в результате будут выданы средние значения курса в указанном направлении по дням. Параметр обязателен.
    yearstats год, за который необходимо получить историю по значениям среднего курса в указанном направлении обмена. Числовое значение в диапазоне от 2003 до 2021, параметр необязателен при значении grouptype=1, при всех остальных значениях параметра grouptype - обязателен. Параметр обязателен при указании любого из параметров monthstats, weekstats, daystats или hourstats.
    monthstats месяц, за который необходимо получить историю по значениям среднего курса в указанном направлении обмена. Числовое значение в диапазоне от 1 до 12, параметр обязателен при значении grouptype=4, при всех остальных значениях параметра grouptype - необязателен. Параметр обязателен при указании любого из параметров daystats или hourstats.
    weekstats неделя (по порядку в году), за которую необходимо получить историю по значениям среднего курса в указанном направлении обмена. Числовое значение в диапазоне от 1 до 54, параметр необязателен при любом значении grouptype.
    daystats день, за который необходимо получить историю по значениям среднего курса в указанном направлении обмена. Числовое значение в диапазоне от 1 до 31, параметр необязателен при любом значении grouptype. Параметр обязателен при указании параметра hourstats.
    hourstats час, за который необходимо получить историю по значениям среднего курса в указанном направлении обмена. Числовое значение в диапазоне от 0 до 23, параметр необязателен при любом значении grouptype.
    В случае если какой-либо необязательный параметр не будет указан, будут возвращены все результаты в рамках последнего указанного параметра. Например, вот в этой ссылке не указан параметр hourstats и в результате будут выданы все средние курсы за каждый час 11 ноября 2011 года.
  • параметры ответа:
    название назначение примечание
    mindateid начало интервала времени, внутри которого производился подсчет среднего курса
    maxdateid начало интервала времени, внутри которого производился подсчет среднего курса
    avgrate средний курс обмена в указанном направлении на интервале от mindateid до maxdateid включительно при расчете среднего курса учитываются только сделки совершенные по верхней границе текущего курса направления обмена (клирингуемые сделки).
    minrate при значении grouptype = 1,2 или 3 минимальное значение среди всех часовых значений avgrate на интервале от mindateid до maxdateid включительно, при grouptype=4 значение атрибута равно avgrate
    maxrate при значении grouptype = 1,2 или 3 минимальное значение среди всех часовых значений avgrate на интервале от mindateid до maxdateid включительно, при grouptype=4 значение атрибута равно avgrate
    cntall общее количество сделок, произведенное в указанном направлении обмена на интервале от mindateid до maxdateid включительно
    ratetype может принимать значения 0 или 1. Данным значением определяется прямой или обратный курс приводится в avgrate, minrate, maxrate в данной паре. Например, для WMZ->WME или WME->WMZ (то есть exchtype =1 или exchtype=2) значение курса avgrate, minrate, maxrate будет одинаково больше 0, но ratetype =0 или ratetype=1. Иными словами, данный тег определяет, какой в данной паре номинал в данный момент больше. Особое внимание необходимо обращать на моменты "переворота", когда курс в какой либо паре приближается к 1:1 и уходит дальше - в этот момент ratetype в такой паре меняется местами.