Информация для автоматизаторов и программистов

Обращаем внимание, что при использовании данных интерфейсов (или в принципе любых страниц сайта wm.exchanger.ru) в случае автоматизированного обращения к ним с одними и теми же параметрами бессмысленно часто, в течение продолжительного врмени (чаще 1 раза в минуту) мы оставляем за собой право ограничить или прекратить вообще, как использование интерфейсов, такими лицами, так и использование ими всего сайта в целом.

Обращаем внимание использующих аутентификацию с сертификатами X.509 - для вызова необходимо использовать домен wmeng.exchanger.ru. Например, https://wmeng.exchanger.ru/asp/XMLWMList.asp?exchtype=1. При этом теги wmid и signstr в запросе можно не указывать.

1. XML интерфейс получения текущих доступных объемов обмена

В секции реализован XML интерфейс для автоматического получения информации о текущих объемах торгов по различным направлениям обмена. URL интерфейса https://wm.exchanger.ru/asp/XMLbestRates.asp (https://wm.exchanger.ru/asp/XMLbestRatesMinus.asp для объемов до базового курса) . Интерфейс актуализирует информацию раз в 3 минуты.
Описание полей (атрибутов):

• Direct - направление обмена, первым всегда идет валюта, которая выставлена к обмену. Например, для направления WMZ-WMR в последующих полях будут представлены объемы WMZ, которые в данный момент могут быть обменяны на бирже на WMR по курсам, соответствующим каждому последующему полю.
  
• BaseRate - базовый курс обмена , это курс ЦБ РФ или НБУ или кросс-курс ЦБ РФ в зависимости от направлений обмена. Знак курса означает что необходимо делать с курсом, уменьшать или увеличивать, чтобы понять какой объем средств относительно базового курса выставлен на бирже к обмену.
  
• Plus05, Plus1, Plus2, Plus3 проценты (0.5%, 1%, 2%, 3%) относительно базового курса, которые надо прибавлять или вычитать из базового курса в зависимости от его знака, чтобы понять какой объем средств выставлен на бирже в данный момент для данного процента отличия от базового курса.
  
  
• exchtype числовое обозначение данного направления обмена (будет использоваться в последующих интерфейсах).
  

Пример информационной строки, возвращаемой интерфейсом:

<row Direct="WMU - WMZ" BaseRate="-5.3065" Plus05="687" Plus1="1578.87" Plus2="1578.87" Plus3="1877.96" />

- данная строка означает, что в данный момент на бирже можно обменять 687 WMU на WMZ по курсу на 0.5% отличающемуся от базвого курса WMU к WMZ. То есть из базового курса 5.3065 вычесть (0.5%) получиться 5.2799 - это курс по которому можно обменять в данный момент 687 WMU на WMZ. Аналогично 1877.96 WMU на WMZ можно обменять по курсу 5.3065 -3% = 5.1473.

2. XML интерфейс получения текущих заявок

В секции реализован XML интерфейс для автоматического получения информации о текущих заявках.
URL интерфейса https://wm.exchanger.ru/asp/XMLWMList.asp?exchtype=1. Интерфейс актуализирует информацию раз в 1 минуту.
Для запроса интерфейса в строке URL надо передать параметр exchtype - который определяет числовое значение (от 1 до 10) требуемого направления обмена (см. предыдущий интерфейс).
Описание возвращаемых полей (атрибутов):

• BankRate - тэг курса ЦБ (НБУ) соответсвующий запросу (exchtype)
  • Direction - атрибут тэга BankRate, означающий направление обмена возвращаемых в данном запросе интерфейсом выставленных на обмен заявок
  
  
  
• WMExchangerQuerys - тэг общего списка возвращенных заявок
  • amountin - тип WM выставленный на обмен
    
  • amountout - тип WM который хочет получить после обмена респондент выставивший заявку
    
  • inoutrate - прямое соотношение типов WM выставленных на обмен
    
  • outinrate - обратное соотношение типов WM выставленных на обмен
    
  
  
  
• Query - тэг конкретной заявки
  • id - номер новой выставленной на обмен заявки
    
  • amountin - сумма WM выставленная на обмен
    
  • amountout - сумма WM которую хочет получить после обмена респондент выставивший заявку
    
  • inoutrate - прямой курс выставленной заявки
    
  • outinrate - обратный курс выставленной заявки
    
  • procentbankrate - процент отличия данной заявки от текущего курса ЦБ (НБУ)
    
  • allamountin - сумма WM выставленная на обмен во всех предыдущих и текущей заявке
    
  • querydate - дата последнего изменения в заявке
    

3. XML-интерфейс списка новых заявок конкретного ВМ-идентификатора

В секции реализован XML интерфейс для автоматического получения информации о новых заявках конкретного ВМ-идентификатора.
URL интерфейса https://wm.exchanger.ru/asp/XMLWMList2.asp.

Для запроса интерфейса по указанному URL необходимо передать методом POST следующий XML запрос:
<wm.exchanger.request>
<wmid></wmid>
<signstr></signstr>
<type></type>
<queryid></queryid>
</wm.exchanger.request>

Описание тэгов запроса:

• wmid - 12 цифр - ВМ-идентификатор, чьи новые заявки необходимо вернуть в результате запроса
• signstr - 132-символьная цифровая подпись (ключами .kwm идентификатора wmid) значений 3-х тэгов запроса склееных в одну строку без пробелов "wmid + type + queryid" (формирование цифровой подписи см. в описании общих ВМ-интерфейсов для разработчиков)
• type - тип запроса, число:
  • 0 - вернуть только неоплаченные заявки
  • 1 - вернуть оплаченные заявки, но еще не погашенные (по которым еще идет обмен)
  • 2 - вернуть только уже погашенные заявки
  • 3 - вернуть все заявки независимо от сосотояния
• queryid - номер (id) новой заявки идентификатора wmid, информацию по которой необходимо вернуть, если параметр не указан, то возвращаются последние 20 новых заявок данного идентификатора по типу запроса

Описание возвращаемых интерфейсом полей (атрибутов):

• WMExchangerQuerys - тэг общего списка возвращенных заявок
  • wmid - идентификатор выставивший заявки
    
  • type - тип запроса
    
  
  
  
• Query - тэг конкретной заявки
  • id - номер новой выставленной на обмен заявки
    
  • exchtype - направление обмена см. интерфейс X1
    
  • state - текущее состояние данной заявки
    • 0 - заявка еще не оплачена
    • 1 - оплачена, идет обмен
    • 2 - погашена полностью
    • 3 - объединена с другой новой
    • 4 - удалена, средства не возвращены
    • 5 - удалена, средства возвращены
    
    
  • amountin - сумма WM, которую осталось обменять в данной заявке
    
  • amountout - сумма WM которую осталось получить в данной заявке
    
  • inoutrate - прямой курс выставленной заявки
    
  • outinrate - обратный курс выставленной заявки
    
  • inpurse - кошелек с которого была произведена оплата заявки
    
  • outpurse - кошелек на который переводятся обменяные средства
    
  • querydatecr - дата постановки заявки
    
  • querydate - дата последнего изменения в заявке
    
  • direction - направление обмена в заявке
    

4. XML-интерфейс списка встречных заявок конкретного ВМ-идентификатора

В секции реализован XML интерфейс для автоматического получения информации о встречных заявках конкретного ВМ-идентификатора.
URL интерфейса https://wm.exchanger.ru/asp/XMLWMList3.asp.

Для запроса интерфейса по указанному URL необходимо передать методом POST следующий XML запрос:
<wm.exchanger.request>
<wmid></wmid>
<signstr></signstr>
<type></type>
<queryid></queryid>
</wm.exchanger.request>

Описание тэгов запроса:

• wmid - 12 цифр - ВМ-идентификатор, чьи встречные заявки необходимо вернуть в результате запроса
• signstr - 132-символьная цифровая подпись (ключами .kwm идентификатора wmid) значений 3-х тэгов запроса склееных в одну строку без пробелов "wmid + type + queryid" (формирование цифровой подписи см. в описании общих ВМ-интерфейсов для разработчиков)
• type - тип запроса, зарезервировано для будуших применений
• queryid - номер (id) встречной заявки идентификатора wmid, информацию по которой необходимо вернуть, если параметр не указан, то возвращаются последние 20 встречных заявок данного идентификатора

Описание возвращаемых интерфейсом полей (атрибутов):

• WMExchangerQuerys - тэг общего списка возвращенных заявок
  • wmid - идентификатор выставивший заявки
    
  • type - тип запроса
    
  
  
  
• Query - тэг конкретной заявки
  • id - номер встречной выставленной на обмен заявки
    
  • isxid - номер новой заявки, по которой выставлена данная встречная заявка
    
  • exchtype - направление обмена см. интерфейс X1
    
  • state - текущее состояние данной заявки
    • 0 - заявка еще не оплачена
    • 1 - оплачена, и обмен по ней произведен, но выплаты на кошелек еще не завершены
    • 2 - погашена полностью и произведены выплаты на кошелек
    • 3 - обмен не произведен, заявка превращена в новую заявку данного wmid (по причине того, что обмен не удалось произвести по какой-либо зи причин, изменился курс новой заявки по которой производился обмен, или в новой заявке нехватило средств для удовлетворения этой встречной заявки)
    
    
  • amountin - сумма WM, которая обменивается в данной встречной заявке
    
  • amountout - сумма WM которую получает wmid в данной встречной заявке
    
  • inoutrate - прямой курс выставленной заявки
    
  • outinrate - обратный курс выставленной заявки
    
  • inpurse - кошелек с которого была произведена оплата заявки
    
  • outpurse - кошелек на который переводятся обменяные средства
    
  • querydatecr - дата постановки заявки
    
  • querydate - дата последнего изменения в заявке
    
  • direction - направление обмена в заявке
    

5. XML-интерфейс удаления новой заявки конкретного ВМ-идентификатора

В секции реализован XML интерфейс для автоматического удаления своей новой заявки конкретного ВМ-идентификатора с возвратом остатка необменяных средств.
URL интерфейса https://wm.exchanger.ru/asp/XMLTransDel.asp.

Для запроса интерфейса по указанному URL необходимо передать методом POST следующий XML запрос:
<wm.exchanger.request>
<wmid></wmid>
<signstr></signstr>
<operid></operid>
</wm.exchanger.request>

Описание тэгов запроса:

• wmid - 12 цифр - ВМ-идентификатор, чью новую заявку необходимо удалить в результате запроса интерфейса
• signstr - 132-символьная цифровая подпись (ключами .kwm идентификатора wmid) значений 2-х тэгов запроса склееных в одну строку без пробелов "wmid + operid" (формирование цифровой подписи см. в описании общих ВМ-интерфейсов для разработчиков)
• operid - номер, выставленной идентификатором wmid, новой заявки, которую необходимо удалить и вернуть остаток средств на кошелек с которого она была выставлена

Описание возвращаемых интерфейсом полей (тэгов):

• retval - "0" в случае успешного выполнения операции, цифровое обозначение ошибки противном случае
• retdesc - описание ошибки в случае если тэг RetVal не равен 0

6. XML-интерфейс изменения курса новой заявки конкретного ВМ-идентификатора

В секции реализован XML интерфейс для автоматического изменения курса обмена своей новой заявки у конкретного ВМ-идентификатора.
URL интерфейса https://wm.exchanger.ru/asp/XMLTransIzm.asp.

Для запроса интерфейса по указанному URL необходимо передать методом POST следующий XML запрос:
<wm.exchanger.request>
<wmid></wmid>
<signstr></signstr>
<operid></operid>
<curstype></curstype>
<cursamount></cursamount>
</wm.exchanger.request>

Описание тэгов запроса:

• wmid - 12 цифр - ВМ-идентификатор, чью новую заявку необходимо изменить в результате запроса интерфейса
• signstr - 132-символьная цифровая подпись (ключами .kwm идентификатора wmid) значений 4-х тэгов запроса склееных в одну строку без пробелов "wmid + operid + curstype + cursamount" (формирование цифровой подписи см. в описании общих ВМ-интерфейсов для разработчиков)
• operid - номер, выставленной идентификатором wmid, новой заявки, курс обмена которой необходимо изменить
• cursamount - новое числовое значение курса обмена завки operid, как прямое или обратное отношение суммы выставленой на обмен к сумме которую нужно получить в результате обмена
• curstype - тип курса обмена в тэге cursamount, "0" - прямой курс (отношение суммы выставленной на обмен, к сумме которую необходимо получить), обратный курс (отношение суммы которую необходимо получить к сумме выставленной на обмен)

Описание возвращаемых интерфейсом полей (тэгов):

• retval - "0" в случае успешного выполнения операции, цифровое обозначение ошибки противном случае
• retdesc - описание ошибки в случае если тэг RetVal не равен 0

7. XML-интерфейс объединенеия двух новых заявок конкретного ВМ-идентификатора

В секции реализован XML интерфейс для автоматического объединения двух новых заявок у конкретного ВМ-идентификатора.
URL интерфейса https://wm.exchanger.ru/asp/XMLTransUnion.asp.

Для запроса интерфейса по указанному URL необходимо передать методом POST следующий XML запрос:
<wm.exchanger.request>
<wmid></wmid>
<signstr></signstr>
<operid></operid>
<unionoperid></unionoperid>
</wm.exchanger.request>

Описание тэгов запроса:

• wmid - 12 цифр - ВМ-идентификатор, чьи новые заявки необходимо объединить в результате запроса интерфейса
• signstr - 132-символьная цифровая подпись (ключами .kwm идентификатора wmid) значений 3-х тэгов запроса склееных в одну строку без пробелов "wmid + operid + unionoperid" (формирование цифровой подписи см. в описании общих ВМ-интерфейсов для разработчиков)
• operid - номер, выставленной идентификатором wmid, новой заявки, к которой необходимо присоединить заявку unionoperid
• unionoperid - номер, выставленной идентификатором wmid, новой заявки, которую необходимо присоединить к заявке operid, при этом обе суммы к обмену будут объеденены и курс получившейся заявки operid останется прежним

Описание возвращаемых интерфейсом полей (тэгов):

• retval - "0" в случае успешного выполнения операции, цифровое обозначение ошибки противном случае
• retdesc - описание ошибки в случае если тэг RetVal не равен 0

8. XML-интерфейс постановки новой заявки на обмен

В секции реализован XML интерфейс для автоматической постановки на обмен новой заявки.
URL интерфейса https://wm.exchanger.ru/asp/XMLTrustPay.asp.

Для запроса интерфейса по указанному URL необходимо передать методом POST следующий XML запрос:
<wm.exchanger.request>
<wmid></wmid>
<signstr></signstr>
<inpurse></inpurse>
<outpurse></outpurse>
<inamount></inamount>
<outamount></outamount>
</wm.exchanger.request>

Описание тэгов запроса:

• wmid - 12 цифр - ВМ-идентификатор, с которого будет выставляться новая заявка
• signstr - 132-символьная цифровая подпись (ключами .kwm идентификатора wmid) значений 5-ти тэгов запроса склееных в одну строку без пробелов "wmid + inpurse + outpurse + inamount + outamount" (формирование цифровой подписи см. в описании общих ВМ-интерфейсов для разработчиков)
• inpurse - номер кошелька ВМ-идентификатора wmid, с которого необходимо взять сумму к обмену для постановки заявки, на данный кошелек должно быть установлено доверие на выполнение переводов от имени идентификатора сервиса системы WMT - WM#128984249415 - секции wm.exchanger
• outpurse - номер кошелька ВМ-идентификатора wmid, на который будут поступать средства по мере обмена
• inamount - сумма, которая будет автоматически переведена с кошелька inpurse на кошелек сервиса секции wm.exchanger и выставлена к обмену
• outamount - сумма, которую необходимо перевести на кошелек outpurse по завершению обмена

Описание возвращаемых интерфейсом полей (тэгов):

• retval - "0" в случае успешного выполнения операции, цифровое обозначение ошибки противном случае. При успешном результате в атрибутах тэга RetVal находятся номер посталвенной заявки (атрибут operid) и номер транзакции в WMT (атрибут wmtransid).
• retdesc - описание ошибки в случае если тэг RetVal не равен 0

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

В секции реализован XML интерфейс для автоматической покупки из своей новой заявки чужой новой, противоположной по направлению обмена.
URL интерфейса https://wm.exchanger.ru/asp/XMLQrFromTrIns.asp.

Для запроса интерфейса по указанному URL необходимо передать методом POST следующий XML запрос:
<wm.exchanger.request>
<wmid></wmid>
<signstr></signstr>
<isxtrid></isxtrid>
<desttrid></desttrid>
<deststamp></deststamp>
</wm.exchanger.request>

Описание тэгов запроса:

• wmid - 12 цифр - ВМ-идентификатор, чья новая заявка номер isxtrid будет использоваться для покупки чужой заявки.
• signstr - 132-символьная цифровая подпись (ключами .kwm идентификатора wmid) значений 3-х тэгов запроса склееных в одну строку без пробелов "wmid + isxtrid + desttrid" (формирование цифровой подписи см. в описании общих ВМ-интерфейсов для разработчиков)
• isxtrid - номер, выставленной идентификатором wmid, новой заявки, c которой будет производится покупка чужой заявки номер desttrid
• desttrid - номер чужой заявки, которую необходимо купить
• deststamp - число равное сумме часа, минуты и секунды из даты заявки, которую необходимо купить (querydate в интерфейсе 2), в случае если заявка, которую необходимо купить - изменялась и у нее будет другое время (другая сумма часа минуты и секунды), траназкция не пройдет. Для совместимости в данном параметре можно ничего не передавать или передавать число 1001, в этом случае проверка на измененность заявки производиться не будет.

Описание возвращаемых интерфейсом полей (тэгов):

• retval - "0" в случае успешного выполнения операции, цифровое обозначение ошибки противном случае
• retdesc - описание ошибки в случае если тэг RetVal не равен 0