Создание лимитной заявки
Авторизация
Используемое WebSocket-соединение должно быть предварительно авторизовано с помощью запроса на авторизацию.
Альтернативная команда
Для этой операции есть альтернатива в виде HTTP-запроса.
Запрос создаёт от имени указанного портфеля лимитную заявку c указанными в теле сообщения характеристиками.
Запрос
Для создания заявки отправьте в установленное WebSocket-соединение сообщение с кодом операции create:limit, содержащее детали заявки.
- Тело запроса
- Схема
{
"opcode": "create:limit",
"guid": "c328fcf1-e495-408a-a0ed-e20f95d6b813",
"side": "buy",
"quantity": 300,
"price": 142.52,
"instrument": {
"symbol": "SBER",
"exchange": "MOEX",
"instrumentGroup": "TQBR"
},
"comment": "Первая заявка",
"user": {
"portfolio": "D39004"
},
"timeInForce": "OneDay",
"allowMargin": false,
"icebergFixed": 100,
"icebergVariance": 2,
"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— ПродажаMOEX— Московская БиржаSPBX— СПБ Биржа- Для Московской Биржи список кодов доступен в таблице
- Для Биржи СПБ всегда SPBX
OneDay— Исполнение в течение одного торгового дня. При истечении этого срока неисполненный остаток снимаетсяImmediateOrCancel— Исполнение немедленно на весь доступный объём встречных заявок. Неисполненный остаток отменяетсяFillOrKill— Исполнение немедленно на весь указанный объём без остатка. Если исполнение без остатка невозможно — заявка отменяетсяAtTheClose— Исполнение в момент закрытия торгов по достигнутой на тот момент рыночной цене. Только для SPBX (на MOEX автоматически меняется наfillorkill) и только для рыночных заявок, т.к. цена лота зависит от рыночной цены на момент исполненияGoodTillCancelled— Исполнение в течение максимально доступного периода на бирже. Например, в течение года для MOEX. Только для срочного рынкаBookOrCancel— Пассивная заявка. Выставляется на биржу только если её цена или величина спреда хуже аналогичных показателей встречных заявок
Код выполняемой операции:
Уникальный идентификатор запроса. Все ответные сообщения будут иметь такое же значение поля guid
Пример: c328fcf1-e495-408a-a0ed-e20f95d6b813
Направление сделки:
Пример: buy
Количество (лоты)
Пример: 300
Цена
Пример: 142.52
instrument
object
Данные о финансовом инструменте
Тикер (Код финансового инструмента)
Пример: SBER
Биржа:
Пример: MOEX
Код режима торгов (Борд):
Пример: TQBR
Пользовательский комментарий к заявке. Максимальная длина комментария — 100 символов
Пример: Первая заявка
user
object
Данные о пользователе, от чьего имени создаётся заявка
Идентификатор клиентского портфеля
Пример: D39004
Условие выставления заявки с учётом возможности её исполнения:
Пример: OneDay
Флаг, подтверждающий согласие клиента с начальным уровнем риска (КНУР) на выставление заявки с потенциальной непокрытой позицией.
Должен быть true для выставления заявки с маржинальной позицией от лица КНУР. В противном случае сервер вернёт ошибку, сообщающую об отсутствии подтверждения согласия с открытием маржинальной позиции.
Флаг игнорируется на срочном рынке и для клиентов с прочими уровнями риска.
Пример: false
Видимая постоянная часть айсберг-заявки в лотах. Указывается при создании заявки, может быть впоследствии изменена только в заявках на фондовом и валютном рынках
Пример: 100
Амплитуда отклонения (в % от icebergFixed) случайной надбавки к видимой части айсберг-заявки, указанная при создании стоп-лимитной заявки. Только срочный рынок
Пример: 2
Флаг, отвечающий за проверку уникальности команд. По умолчанию включен, препятствуя случайному множественному выполнению одного и того же запроса. При отключении ускоряет обработку запроса.
Пример: true
Ответы
В зависимости от результатов обработки полученного запроса сервер вернёт в WebSocket-соединение сообщение с соответствующим кодом ответа.
Сообщения
- 200
- 400
Сообщение об успешной обработке запроса
- Тело ответа
- Схема
{
"requestGuid": "c328fcf1-e495-408a-a0ed-e20f95d6b813",
"httpCode": 200,
"message": "An order '12345' has been created.",
"orderNumber": "12345"
}
Параметры тела ответа
Уникальный идентификатор запроса. Значением выступает параметр guid, указанный в теле запроса
Пример: c328fcf1-e495-408a-a0ed-e20f95d6b813
Код возвращаемого сообщения
Пример: 200
Текстовое представление возвращаемого сообщения
Пример: An order '12345' has been created.
Уникальный идентификатор заявки
Пример: "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