Изменение лимитной заявки
Авторизация
Используемое WebSocket-соединение должно быть предварительно авторизовано с помощью запроса на авторизацию.
Альтернативная команда
Для этой операции есть альтернатива в виде HTTP-запроса.
Ограничение биржи
Из-за ограничения со стороны биржи параметры side
и symbol
не учитываются при изменении заявок, относящихся к срочному рынку. Ограничение не распространяется на первичное выставление заявок на срочном рынке и изменение заявок на прочих рынках.
Запрос создаёт новую лимитную заявку с изменёнными характеристиками, автоматически отменив созданную ранее. Для определения отменяемой заявки используется её номер в параметре orderid
.
Запрос
Для изменения заявки отправьте в установленное WebSocket-соединение сообщение с кодом операции update:limit
, содержащее новые детали заявки.
- Тело запроса
- Схема
{
"opcode": "update:limit",
"guid": "c328fcf1-e495-408a-a0ed-e20f95d6b813",
"orderId": "18995978560",
"side": "buy",
"quantity": 300,
"price": 142.52,
"instrument": {
"symbol": "SBER",
"exchange": "MOEX",
"instrumentGroup": "TQBR"
},
"comment": "Первая заявка",
"user": {
"portfolio": "D39004"
},
"allowMargin": false,
"icebergFixed": 100,
"checkDuplicates": 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
— ПродажаMOEX
— Московская БиржаSPBX
— СПБ Биржа- Для Московской Биржи список кодов доступен в таблице
- Для Биржи СПБ всегда SPBX
Код выполняемой операции:
Уникальный идентификатор запроса. Все ответные сообщения будут иметь такое же значение поля guid
Пример: c328fcf1-e495-408a-a0ed-e20f95d6b813
Направление сделки:
Пример: buy
Направление сделки:
Пример: buy
Количество (лоты)
Пример: 300
Цена
Пример: 142.52
instrument
object
Данные о финансовом инструменте
Тикер (Код финансового инструмента)
Пример: SBER
Биржа:
Пример: MOEX
Код режима торгов (Борд):
Пример: TQBR
Пользовательский комментарий к заявке. Максимальная длина комментария — 100 символов
Пример: Первая заявка
user
object
Данные о пользователе, от чьего имени создаётся заявка
Идентификатор клиентского портфеля
Пример: D39004
Флаг, подтверждающий согласие клиента с начальным уровнем риска (КНУР) на выставление заявки с потенциальной непокрытой позицией.
Должен быть true
для выставления заявки с маржинальной позицией от лица КНУР. В противном случае сервер вернёт ошибку, сообщающую об отсутствии подтверждения согласия с открытием маржинальной позиции.
Флаг игнорируется на срочном рынке и для клиентов с прочими уровнями риска.
Пример: false
Видимая постоянная часть айсберг-заявки в лотах. Указывается при создании заявки, может быть впоследствии изменена только в заявках на фондовом и валютном рынках
Пример: 100
Флаг, отвечающий за проверку уникальности команд. По умолчанию включен, препятствуя случайному множественному выполнению одного и того же запроса. При отключении ускоряет обработку запроса.
Пример: 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