Изменение стоп-лимитной заявки
Авторизация
Используемое WebSocket-соединение должно быть предварительно авторизовано с помощью запроса на авторизацию.
Альтернативная команда
Для этой операции есть альтернатива в виде HTTP-запроса.
Обеспечение заявки
Условные заявки не требуют обеспечения, но выставляемые ими лимитные и рыночные заявки — требуют. Убедитесь, что на момент срабатывания условной заявки в портфеле будет достаточно средств для обеспечения выставляемой биржевой заявки с помощью запроса на оценку заявки.
Запрос создаёт новую стоп-лимитную заявку с изменёнными характеристиками, автоматически отменив созданную ранее. Для определения отменяемой заявки используется её номер в параметре orderid.
Запрос
Для изменения заявки отправьте в установленное WebSocket-соединение сообщение с кодом операции create:stopLimit, содержащее новые детали заявки.
- Тело запроса
- Схема
{
"opcode": "update:stopLimit",
"guid": "c328fcf1-e495-408a-a0ed-e20f95d6b813",
"orderId": "18995978560",
"side": "buy",
"quantity": 300,
"price": 142.52,
"condition": "More",
"triggerPrice": 191.33,
"stopEndUnixTime": 1590094740,
"instrument": {
"symbol": "SBER",
"exchange": "MOEX",
"instrumentGroup": "TQBR"
},
"comment": "Первая заявка",
"user": {
"portfolio": "D39004"
},
"timeInForce": "OneDay",
"allowMargin": false,
"icebergFixed": 100,
"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
OneDay— Исполнение в течение одного торгового дня. При истечении этого срока неисполненный остаток снимаетсяImmediateOrCancel— Исполнение немедленно на весь доступный объём встречных заявок. Неисполненный остаток отменяетсяFillOrKill— Исполнение немедленно на весь указанный объём без остатка. Если исполнение без остатка невозможно — заявка отменяетсяAtTheClose— Исполнение в момент закрытия торгов по достигнутой на тот момент рыночной цене. Только для SPBX (на MOEX автоматически меняется наfillorkill) и только для рыночных заявок, т.к. цена лота зависит от рыночной цены на момент исполненияGoodTillCancelled— Исполнение в течение максимально доступного периода на бирже. Например, в течение года для MOEX. Только для срочного рынкаBookOrCancel— Пассивная заявка. Выставляется на биржу только если её цена или величина спреда хуже аналогичных показателей встречных заявок
Код выполняемой операции:
Уникальный идентификатор запроса. Все ответные сообщения будут иметь такое же значение поля guid
Пример: c328fcf1-e495-408a-a0ed-e20f95d6b813
Направление сделки:
Пример: buy
Направление сделки:
Пример: buy
Количество (лоты)
Пример: 300
Цена
Пример: 142.52
Условие срабатывания стоп/стоп-лимитной заявки:
Пример: lessorequal
Стоп-цена
Пример: 191.33
Срок действия (UTC) в формате Unix Time Seconds
Пример: 1590094740
instrument
object
Данные о финансовом инструменте
Тикер (Код финансового инструмента)
Пример: SBER
Биржа:
Пример: MOEX
Код режима торгов (Борд):
Пример: TQBR
user
object
Данные о пользователе, от чьего имени создаётся заявка
Идентификатор клиентского портфеля
Пример: D39004
Условие выставления заявки с учётом возможности её исполнения:
Пример: OneDay
Флаг, подтверждающий согласие клиента с начальным уровнем риска (КНУР) на выставление заявки с потенциальной непокрытой позицией.
Должен быть true для выставления заявки с маржинальной позицией от лица КНУР. В противном случае сервер вернёт ошибку, сообщающую об отсутствии подтверждения согласия с открытием маржинальной позиции.
Флаг игнорируется на срочном рынке и для клиентов с прочими уровнями риска.
Пример: false
Видимая постоянная часть айсберг-заявки в лотах. Указывается при создании заявки, может быть впоследствии изменена только в заявках на фондовом и валютном рынках
Пример: 100
Флаг, отвечающий за проверку уникальности команд. По умолчанию включен, препятствуя случайному множественному выполнению одного и того же запроса. При отключении ускоряет обработку запроса.
Пример: 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