WebMoney

Wiki

Exchanger Stats

XML-интерфейс получения истории курсов обмена

В секции реализован XML-интерфейс для автоматического получения информации о среднем курсе обмена в указанном направлении на любую дату и время с точностью до 1 часа.
Интерфейс актуализирует информацию несколько раз в час. Входящие параметры интерфейса передаются в строке URL.
  • параметры запроса:
    название назначение примечание
    exchtype числовое значение направления обмена числовое значение направления обмена (числа в диапазоне 1-40), по которому необходимо получить историю соответствия чисел направлениям обмена, приведены в интерфейсе XML-интерфейс получения текущих доступных объемов обмена. Параметр обязателен.
    grouptype минимальный интервал времени, внутри которого необходимо получить среднее значение курса имеет четыре значения 1-месячный интервал, 2-недельный интервал, 3-дневной интервал, 4-часовой интервал. Например, при выборе дневного интервала (значение 3) в результате будут выданы средние значения курса в указанном направлении по дням. Параметр обязателен.
    yearstats год, за который необходимо получить историю по значениям среднего курса в указанном направлении обмена. Числовое значение в диапазоне от 2003 до 2020, параметр необязателен при значении 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->WMR или WMR->WMZ (то есть exchtype =1 или exchtype=2) значение курса avgrate, minrate, maxrate будет одинаково больше 0, но ratetype =0 или ratetype=1. Иными словами, данный тег определяет, какой в данной паре номинал в данный момент больше. Особое внимание необходимо обращать на моменты "переворота", когда курс в какой либо паре приближается к 1:1 и уходит дальше - в этот момент ratetype в такой паре меняется местами.