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

Изменение курса новой заявки конкретного WMID

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

  • формат XML запроса:
<?xml version=\"1.0\"?>
<wm.exchanger.request>
    <wmid></wmid>
    <signstr></signstr>
    <operid></operid>
    <curstype></curstype>
    <cursamount></cursamount>
    <capitallerwmid></capitallerwmid>
</wm.exchanger.request>
  • формат JSON запроса:
{
    "wmid":"",
    "signstr":"",
    "operid":"",
    "curstype":"",
    "cursamount":"",
    "capitallerwmid":"" 
}
  • параметры запроса:
    название назначение примечание
    wmid WMID подписавшего запрос 12 цифр - WMID, чьи новые заявки необходимо вернуть в результате запроса
    signstr подпись запроса 132-символьная цифровая подпись (ключами .kwm идентификатора wmid) значений 3-х тэгов запроса склеенных в одну строку без пробелов "wmid + operid + curstype + cursamount" (формирование цифровой подписи см. в описании общих WM-интерфейсов для разработчиков)
    operid номер заявки номер, выставленной идентификатором wmid, новой заявки, курс обмена которой необходимо изменить
    cursamount значение курса новое числовое значение курса обмена заявки operid, как прямое или обратное отношение суммы выставленной на обмен к сумме которую нужно получить в результате обмена
    curstype тип курса обмена тип курса в тэге cursamount, "0" - прямой курс (отношение суммы выставленной на обмен, к сумме которую необходимо получить), "1" - обратный курс (отношение суммы которую необходимо получить к сумме выставленной на обмен)
    capitallerwmid wmid капиталлера необязательное поле, если в данном поле передать WMID капиталлера (www.capitaller.ru), то данным запросом может быть изменен курс заявки operid не принадлежащей wmid, а принадлежащей capitallerwmid. При этом у идентификатора wmid, осуществляющего подпись запроса, должен быть доступ, описанный на странице имперсонализации капиталлера.
  • формат XML ответа:
<?xml version=\"1.0\"?>
<wm.exchanger.response>
    <retval></retval>
    <retdesc></retdesc>
    <AmountRestIn></AmountRestIn>
    <AmountRestOut></AmountRestOut>
</wm.exchanger.response>
  • формат JSON ответа:
{    
    "retval":"",
    "retdesc":"",
    "AmountRestIn":"",
    "AmountRestOut":"" 
}
  • параметры ответа:
    название назначение примечание
    retval код выполнения "0" в случае успешного выполнения операции, цифровое обозначение ошибки в противном случае
    retdesc описание ошибки в случае если тэг RetVal не равен 0
  • пример:
<?xml version=\"1.0\"?>
<wm.exchanger.request>
    <wmid>500000000008</wmid>
    <signstr>7a2987749e5453a5cb66a74a51837f0c7006c35ec7f4699e8a1fa5e26331fbd8d1c8a19ca1dec79d1403d1a8c89957bddf65bcf6409083a82805bd79388dbe9600e4</signstr>
    <operid>27795291</operid>
    <curstype>2</curstype>
    <cursamount>58.0645</cursamount>
    <capitallerwmid>0</capitallerwmid>
</wm.exchanger.request>

<?xml version=\"1.0\"?>
<wm.exchanger.response>
    <retval>0</retval>
    <retdesc></retdesc>
    <AmountRestIn>90</AmountRestIn>
    <AmountRestOut>1,55</AmountRestOut>
</wm.exchanger.response>
  • Описание ошибок:
    код описание
    -10 Идентификатор клиента не указан
    -11 Ошибка при указании подписи, тег signstr
    -12 Ошибка при указании номера заявки, которую необходимо изменить
    -13 Ошибка при указании нового курса заявки. Он должен содержать только цифры и знак разделителя без пробелов и посторонних символов, должен быть обязательно указан и не должнен превышать 10 символов
    -14 Подпись не прошла. "&outtxt&ClientPlanStr
    -15 Ошибка загрузки XML c параметрами запроса
    1 Заявка которую Вы выбрали для изменения курса не найдена, возможно она уже удалена или полностью погашена
    7 Вы изменили курс заявки более чем на 200% (в выгодную для Вас сторону) или более чем на 1-2% в невыгодную, либо Вы неправильно указали курс, либо Вам необходимо приближаться к требуемому курсу путем нескольких изменений шагами. <percentporog>0.75</percentporog> - тег появляется только при возникновении этой ошибки, в нем содержится процент, на который может быть изменен курс, например 0.75 - это 75%. Если курс заявки понижается в стакане (от топа в списке заявок), то его можно менять на 200%. Если курс повышается (но не превышает курса топовой заявки), то курс также можно изменить на 200%. Если итоговый курс выше курса топовой заявки, то изменить курс по отношению к предыдущему значению, можно только на 1% (для не криптовалютных пар) и на 2% для криптовалютных пар. Иными словами , если курс вашей заявки существенно ниже топвой заявки, то поднять ее в топ можно только двумя шагами, сначала необходимо поднять заявку изменением курса , который будет ниже самой топовой, но близким к ней, а следующим изменением в 1% или 2% вывести ее в топ.
    8 Курс указан слишком низким (высоким), при таком курсе, сумма которую Вы хотите получить становится равной 0. Повысьте или понизьте курс
    9 Изменение курса заявки не произведено
    11 Изменение курса заявки не произведено. Старое и новое значения курса одинаковы.
    19 Данная заявка заблокирована под обмен, попробуйте произвести операцию еще раз позднее через 1 минуту
    23 Вы слишком часто или быстро меняете курс заявки (более 3 раз в минуту), подождите полторы минуты, если сменили курс только что.
    25 Сервисом подсчитывается общее количество операций (со всеми заявками), сделанных каждым WMID в каждом направлении обмена (WMZ->WMX, WMX->WMZ, WMZ->WME и т.п.) за текущие календарные сутки.
    К таким операциям относится 4 вида операций: постановка новой заявки, разделение заявки, объединение заявок, изменение курса заявки. Если при выполнении операции среднее количество выполняемых операций в час для данного WMID превышает 360 (для заявок с участием криптовалют) и 180 для всех остальных, то выдается данная ошибка. При этом ошибка выдается только в случае изменения курса, которое приводит к повышению позиции заявки в общем списке заявок, в случае понижения позиции (увеличения в заявке суммы к получению) ошибка не выдается.
    Операции выполняемые в трейдерском режиме сервисом автоматически (постановка обмененных средств в новую заявку и если необходимо, объединение этой новой заявки с уже существующей) в подсчете данного количества операций не учитываются.
    Если у WMID в текущие сутки на бирже используется больше одного WMID из аттестата, то подсчитываемое значение операций для конкретного WMID умножается на количество WMID из аттестата, совершавших операции в текущие сутки.
    27 Тоже самое что и ошибка 23, но для пар в которых присутствуют криптовалюты (WMX, WMH, WML) и более 4 раз в минуту
    43 В противоположном направлении у Вас уже стоит заявка с таким курсом, что данная заявка, если Вы закончите данную операцию, будет вынуждена скупить (склиринговать) Вашу же заявку в противоположном направлении. Скорректируйте курс данной или противоположной Вашей заявки.
    121 Курс заявки не может быть меньше или равен 0.
    122 Тип указываемого курса должен быть обязательно выбран.