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


Обращаем внимание, что при использовании данных интерфейсов (или в принципе любых страниц сайта 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 - направление обмена, первым всегда идет тип титульных знаков WM, которые выставлены к обмену. Например, для направления 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 до 46) требуемого направления обмена (см. предыдущий интерфейс).
Описание возвращаемых полей (атрибутов):

  • BankRate - тэг курса ЦБ (НБУ) соответсвующий запросу (exchtype)
    • Direction - атрибут тэга BankRate, означающий направление обмена возвращаемых в данном запросе интерфейсом выставленных на обмен заявок
    • ratetype - атрибут тэга BankRate, может принимать значения 0 или 1. Так как в теге Bankrate курс не может быть меньше 1, то этим тегом определяется прямой или обратный курс по отношению к Direction в данной паре. Например для WMZ->WMR или WMR->WMZ (то есть exchtype =1 или exchtype=2) значение курса будет одинаковым, но ratetype =0 или ratetype=1


  • 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>
<capitallerwmid></capitallerwmid>
</wm.exchanger.request>

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

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

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

  • 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>
<capitallerwmid></capitallerwmid>
</wm.exchanger.request>

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

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

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

  • 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 - направление обмена в заявке
    • newtrid - если данная встречная заявка была превращена в новую (выплаты на кошелек не было), то в данном аттртибуте номер этой новой заявки


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

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

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

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

  • wmid - 12 цифр - ВМ-идентификатор, чью новую заявку необходимо удалить в результате запроса интерфейса
  • signstr - 132-символьная цифровая подпись (ключами .kwm идентификатора wmid) значений 2-х тэгов запроса склееных в одну строку без пробелов "wmid + operid" (формирование цифровой подписи см. в описании общих ВМ-интерфейсов для разработчиков)
  • operid - номер, выставленной идентификатором wmid, новой заявки, которую необходимо удалить и вернуть остаток средств на кошелек с которого она была выставлена
  • capitallerwmid - необязательно поле, если в данном поле передать ВМИД капиталлера (www.capitaller.ru), то данным запросом может быть удалена заявка operid не принадлежащая wmid, а принадлежащая capitallerwmid. При этом у идентификатора 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>
<capitallerwmid></capitallerwmid>
</wm.exchanger.request>

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

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

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

  • 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>
<capitallerwmid></capitallerwmid>
</wm.exchanger.request>

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

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

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

  • 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>
<capitallerwmid></capitallerwmid>
</wm.exchanger.request>

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

  • wmid - 12 цифр - ВМ-идентификатор, с которого будет выставляться новая заявка
  • signstr - 132-символьная цифровая подпись (ключами .kwm идентификатора wmid) значений 5-ти тэгов запроса склееных в одну строку без пробелов "wmid + inpurse + outpurse + inamount + outamount" (формирование цифровой подписи см. в описании общих ВМ-интерфейсов для разработчиков)
  • inpurse - номер кошелька ВМ-идентификатора wmid, с которого необходимо взять сумму к обмену для постановки заявки, на данный кошелек должно быть установлено доверие на выполнение переводов от имени идентификатора сервиса системы WMT - WM#128984249415 - секции wm.exchanger. Обратите внимание, что для выставления заявки с указанным тегом capitallerwmid это доверие устанавливается управляющим капиталлера в разделе Интеграция сайта capitaller.ru
  • outpurse - номер кошелька ВМ-идентификатора wmid, на который будут поступать средства по мере обмена
  • inamount - сумма, которая будет автоматически переведена с кошелька inpurse на кошелек сервиса секции wm.exchanger и выставлена к обмену
  • outamount - сумма, которую необходимо перевести на кошелек outpurse по завершению обмена, если в данном поле указать сумму, равную 0.0 то заявка будет выставлена через БЫСТРЫЙ ОБМЕН, то есть сразу же после постановки этой заявки с нее будет полностью выкуплена очередь самых выгодных из противоположных к ней по направлению
  • capitallerwmid - необязательно поле, если в данном поле передать ВМИД капиталлера (www.capitaller.ru), то данным запросом может быть поставлена на обмен заявка от имени capitallerwmid. При этом у идентификатора wmid, осуществляющего подпись запроса, должен быть доступ, описанный на странице имперсонализации капиталлера.

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

  • 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>
<capitallerwmid></capitallerwmid>
</wm.exchanger.request>

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

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

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

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


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

В секции реализован XML-интерфейс для автоматического получения информации о среднем курсе обмена в указанном направлении на любую дату и время с точностью до 1 часа. URL интерфейса https://wm.exchanger.ru/asp/XMLQuerysStats.asp?exchtype=1&grouptype=4&yearstats=2011&monthstats=11&daystats=11&hourstats=11. Интерфейс актуализирует информацию несколько раз в час. Входящие параметры интерфейса передаются в строке URL. Описание парметров приведено ниже:

  • exchtype - числовое значение направления обмена (числа в диапазоне 1-40) по которому необходимо получить историю , соответствия чисел направлениям обмена приведены в интерфейсе 1. Параметр обязателен.
  • 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 включительно


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

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

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

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

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

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

  • WMExchangerQuerys - тэг списка возвращенных заявок
    • wmid - идентификатор выставивший заявки
    • isxid - номер новой заявки


  • Query - тэг конкретной заявки
    • id - номер встречной заявки
    • exchtype - направление обмена см. интерфейс X1
    • state - текущее состояние данной заявки
      • 0 - заявка еще не оплачена
      • 1 - оплачена, и обмен по ней произведен, но выплаты на кошелек еще не завершены
      • 2 - погашена полностью и произведены выплаты на кошелек
      • 4 - часть новой заявки превращена во встречную (часть исходной новой заявки была потрачена на скупку чужой новой из списка, противоположного по направлению к данной)
      • 5 - часть новой заявки была превращена в другую новую заявку (путем разделения на две)

    • amountin - сумма WM, которую получает wmid в данной встречной заявке
    • amountout - сумма WM которую отдает wmid в данной встречной заявке
    • inoutrate - прямой курс выставленной заявки
    • outinrate - обратный курс выставленной заявки
    • querydatecr - дата постановки заявки
    • querydate - дата последнего изменения в заявке
    • direction - направление обмена в заявке
    • newtrid - если данная встречная заявка была превращена в новую (выплаты на кошелек не было), то в данном аттртибуте номер этой новой заявки


12. XML-интерфейс разделения новой заявки на две

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

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

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

  • wmid - 12 цифр - ВМ-идентификатор, с которого будет выставляться новая заявка
  • signstr - 132-символьная цифровая подпись (ключами .kwm идентификатора wmid) значений 5-ти тэгов запроса склееных в одну строку без пробелов "wmid + operid + exchtype + outpurse + inamount + outamount" (формирование цифровой подписи см. в описании общих ВМ-интерфейсов для разработчиков)
  • operid - номер, выставленной идентификатором wmid, новой заявки, которую необходимо разделить на две заявки
  • exchtype - тип новой заявки (в терминах XML интерфейса 1 см. выше), которая появится после разделения
  • outpurse - номер кошелька ВМ-идентификатора wmid, на который будут поступать средства в новой заявке, которая появится после разделения
  • inamount - сумма, которая будет автоматически убрана из существующей заявки с номером operid и перенесена в новую заявку
  • outamount - сумма, которую необходимо перевести на кошелек outpurse в новой заявке, которая появится после разделения
  • capitallerwmid - необязательно поле, если в данном поле передать ВМИД капиталлера (www.capitaller.ru), то данным запросом может быть произведено разделение заявки от имени capitallerwmid. При этом у идентификатора wmid, осуществляющего подпись запроса, должен быть доступ, описанный на странице имперсонализации капиталлера.

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

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