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