Создание лимитной заявки
Используемое 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"
},
"comment": "Первая заявка",
"board": "TQBR",
"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
— СПБ БиржаOneDay
— До конца дняImmediateOrCancel
— Снять остатокFillOrKill
— Исполнить целиком или отклонитьGoodTillCancelled
— Активна до отмены
Код выполняемой операции:
Уникальный идентификатор запроса. Все ответные сообщения будут иметь такое же значение поля guid
Пример: c328fcf1-e495-408a-a0ed-e20f95d6b813
Направление сделки:
Пример: buy
Количество (лоты)
Пример: 300
Цена
Пример: 142.52
instrument
object
Данные о финансовом инструменте
Тикер (Код финансового инструмента)
Пример: SBER
Биржа:
Пример: MOEX
Пользовательский комментарий к заявке
Пример: Первая заявка
Код режима торгов (Борд)
Пример: TQBR
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