Изменение стоп-заявки
Авторизация
Используемое WebSocket-соединение должно быть предварительно авторизовано с помощью запроса на авторизацию.
Альтернативная команда
Для этой операции есть альтернатива в виде HTTP-запроса.
Обеспечение заявки
Условные заявки не требуют обеспечения, но выставляемые ими лимитные и рыночные заявки — требуют. Убедитесь, что на момент срабатывания условной заявки в портфеле будет достаточно средств для обеспечения выставляемой биржевой заявки с помощью запроса на оценку заявки.
Запрос создаёт новую стоп-заявку с изменёнными характеристиками, автоматически отменив созданную ранее. Для определения отменяемой заявки используется её номер в параметре orderid.
Запрос
Для изменения заявки отправьте в установленное WebSocket-соединение сообщение с кодом операции update:stop, содержащее новые детали заявки.
- Тело запроса
- Схема
{
"opcode": "update:stop",
"guid": "c328fcf1-e495-408a-a0ed-e20f95d6b813",
"orderId": "18995978560",
"side": "buy",
"quantity": 300,
"condition": "More",
"triggerPrice": 191.33,
"stopEndUnixTime": 1590094740,
"instrument": {
"symbol": "SBER",
"exchange": "MOEX",
"instrumentGroup": "TQBR"
},
"user": {
"portfolio": "D39004"
},
"allowMargin": false,
"checkDuplicates": true,
"protectingSeconds": 15,
"comment": "Первая заявка",
"activate": true
}
Параметры тела запроса
authorize— Авторизация WebSocket-соединенияcreate:market— Создание рыночной заявкиcreate:limit— Создание лимитной заявкиcreate:stop— Создание стоп-заявкиcreate:stopLimit— Создание стоп-лимитной заявкиupdate:market— Изменение рыночной заявкиupdate:limit— Изменение лимитной заявкиupdate:stop— Изменение стоп-заявкиupdate:stopLimit— Изменение стоп-лимитной заявкиdelete:market— Снятие рыночной заявкиdelete:limit— Снятие лимитной заявкиdelete:stop— Снятие стоп-заявкиdelete:stopLimit— Снятие стоп-лимитной заявкиbuy— Покупкаsell— Продажаbuy— Покупкаsell— Продажаmore— Цена срабатывания больше текущей ценыless— Цена срабатывания меньше текущей ценыmoreorequal— Цена срабатывания больше или равна текущей ценеlessorequal— Цена срабатывания меньше или равна текущей ценеMOEX— Московская БиржаSPBX— СПБ Биржа- Для Московской Биржи список кодов доступен в таблице
- Для Биржи СПБ всегда SPBX
Код выполняемой операции:
Уникальный идентификатор запроса. Все ответные сообщения будут иметь такое же значение поля guid
Пример: c328fcf1-e495-408a-a0ed-e20f95d6b813
Направление сделки:
Пример: buy
Направление сделки:
Пример: buy
Количество (лоты)
Пример: 300
Условие срабатывания стоп/стоп-лимитной заявки:
Пример: lessorequal
Стоп-цена
Пример: 191.33
Срок действия (UTC) в формате Unix Time Seconds
Пример: 1590094740
instrument
object
Данные о финансовом инструменте
Тикер (Код финансового инструмента)
Пример: SBER
Биржа:
Пример: MOEX
Код режима торгов (Борд):
Пример: TQBR
user
object
Данные о пользователе, от чьего имени создаётся заявка
Идентификатор клиентского портфеля
Пример: D39004
Флаг, подтверждающий согласие клиента с начальным уровнем риска (КНУР) на выставление заявки с потенциальной непокрытой позицией.
Должен быть true для выставления заявки с маржинальной позицией от лица КНУР. В противном случае сервер вернёт ошибку, сообщающую об отсутствии подтверждения согласия с открытием маржинальной позиции.
Флаг игнорируется на срочном рынке и для клиентов с прочими уровнями риска.
Пример: false
Флаг, отвечающий за проверку уникальности команд. По умолчанию включен, препятствуя случайному множественному выполнению одного и того же запроса. При отключении ускоряет обработку запроса.
Пример: true
Защитное время. Непрерывный период времени в секундах, в течение которого рыночная цена инструмента должна соответствовать указанным в заявке цене и условию срабатывания (triggerPrice|stopPrice и condition). Предназначено для защиты условных заявок от срабатывания при краткосрочных колебаниях цены.
Пример: 15
15Пользовательский комментарий к заявке. Максимальная длина комментария — 100 символов
Пример: Первая заявка
Флаг указывает, создать активную заявку, или не активную. Не активная заявка отображается в системе, но не участвует в процессе выставления на биржу, пока не станет активной. Данный флаг необходим при создании группы заявок с типом TriggerBracketOrders
Пример: true
Ответы
В зависимости от результатов обработки полученного запроса сервер вернёт в WebSocket-соединение сообщение с соответствующим кодом ответа.
Сообщения
- 200
- 400
Сообщение об успешной обработке запроса
- Тело ответа
- Схема
{
"requestGuid": "c328fcf1-e495-408a-a0ed-e20f95d6b813",
"httpCode": 200,
"message": "An order has been updated. New order ID is '12346'.",
"orderNumber": "12346"
}
Параметры тела ответа
Уникальный идентификатор запроса. Значением выступает параметр guid, указанный в теле запроса
Пример: c328fcf1-e495-408a-a0ed-e20f95d6b813
Код возвращаемого сообщения
Пример: 200
Текстовое представление возвращаемого сообщения
Пример: An order has been updated. New order ID is '12346'.
Уникальный идентификатор заявки
Пример: "12346"
Не удалось обработать запрос. Проверьте корректность переданного сообщения и повторите попытку.
- Тело ответа
- Схема
{
"requestGuid": "c328fcf1-e495-408a-a0ed-e20f95d6b813",
"httpCode": 400,
"message": "Invalid or unsupported quantity"
}
Параметры тела ответа
Уникальный идентификатор запроса. Значением выступает параметр guid, указанный в теле запроса
Пример: c328fcf1-e495-408a-a0ed-e20f95d6b813
Код возвращаемого сообщения
Пример: 400
Текстовое представление возвращаемого сообщения
Пример: Invalid or unsupported quantity