Перейти к основному содержимому

Рыночные заявки

Рыночная заявка или заявка «по рынку» — распоряжение на совершение сделки на покупку/продажу указанного количества лотов финансового инструмента по текущей рыночной цене. Рыночной ценой при этом считается лучшая цена встречной заявки в биржевом стакане.

Общая информация​

Рыночные заявки обладают рядом свойств, которые необходимо учитывать при ведении торгов с их помощью. В частности, следует помнить, что:

Рыночная заявка — это прямая заявка.

Прямые заявки передаются бирже без дополнительной обработки или ожидания дополнительных условий выставления со стороны торговой системы. Такие заявки видны всем участникам торгов и с момента выставления отражаются на состоянии биржевого стакана целевого финансового инструмента. Кроме того, средства (деньги/лоты), необходимые для выполнения прямой заявки, резервируются непосредственно в момент её выставления.

Рыночная заявка влияет на биржевой стакан, но не наполняет его.

В отличии от лимитных заявок, рыночная заявка не ставится в очередь на исполнение в биржевой стакан. Вместо этого такая заявка извлекает лучшее встречное предложение из стакана и поглощает его на тот объём, который запрошен или доступен. Исключение составляют случаи, когда запрошенный объём превышает весь доступный объём встречных предложений.

Рыночная заявка имеет наибольшую вероятность исполнения.

Сделка по рыночной заявке совершается по текущей рыночной цене, что означает отсутствие необходимости ждать подходящего встречного предложения, как это бывает с лимитными заявками. Единственное условие, при котором рыночная заявка не будет выполнена в полном объёме — отсутствие на рынке достаточного объёма встречных предложений.

Пример 1

Участник торгов выставляет рыночную заявку на покупку (бид) 1000 лотов инструмента. Если общий объём встречных предложений (асков) в биржевом стакане больше этого значения — заявка будет выполнена. Если меньше — заявка будет выполнена частично или отменена в зависимости от выбранного значения timeInForce.

Средняя цена лота может отличаться от лучшей цены лота на момент выставления заявки.

Рыночные заявки подвержены влиянию эффекта «проскальзывания» (slippage): если встречное предложение с лучшей ценой лота не позволяет полностью удовлетворить выставленную заявку, после его исчерпания будет задействовано следующее встречное предложение. Соответственно, цена следующего предложения станет новой лучшей ценой лота и сделка на остаток пройдёт по этой цене.

Пример 2

Участник торгов выставляет рыночную заявку на покупку (бид) 1000 лотов инструмента. Встречное предложение с лучшей ценой 300 рублей за лот содержит только 200 лотов. Следующее за ним предложение с ценой 301 рубль содержит 600 лотов. Третье предложение в стакане также содержит 600 лотов, но уже по цене 302 рубля. При выполнении заявки первые два предложения будут исчерпаны полностью, а третье — на объём остатка после первых двух. Сделки будут заключаться по цене встречных предложений, из-за чего средняя цена лота в такой заявке будет равна 301 рублю вместо 300 рублей цены, бывшей лучшей на момент выставления заявки.

Обеспечение заявки

Выставляемая рыночная заявка должна быть обеспечена в соответствии с уровнем риска клиента и подходом к ведению торгов:

  • При немаржинальной торговле обеспечение заявки составляет полную стоимость заявки с надбавкой в 5% на случай изменения цены;

  • Для маржинальной торговли обеспечение зависит от уровня риска клиента с надбавкой в 1% от этой суммы на случай изменения цены.

Убедиться в достаточности средств можно с помощью запроса на оценку заявки. Ознакомиться с условиями обеспечения заявки в зависимости от уровня риска можно здесь.

Рыночные заявки стоит рассматривать как практически гарантированный способ заключить сделку по выбранному инструменту любой ценой и быстро.

Если этот подход не соответствует используемой торговой стратегии, рекомендуем воспользоваться лимитными заявками для заключения сделок по желаемой цене.

Условия выполнения​

Основным условием выполнения заявки является параметр timeInForce, регулирующий обработку остатка заявки после исчерпания всех встречных предложений рынка. Возможные значения:

Условие

Описание

oneday

Заявка действительна в течение торгового дня. Остаток после изъятия всего доступного объёма встречных заявок ставится в очередь на исполнение и удерживается до полного выполнения заявки, её отмены или завершения торгового дня, в рамках которого была выставлена заявка.

goodtillcancelled

Аналогично oneday, но без ограничения по времени — остаток удерживается в очереди до полного выполнения заявки или её отмены.

immediateorcancel

Заявка выполняется на доступный на момент выставления объём, остаток снимается с торгов.

fillorkill

Заявка может быть выполнена только полностью. Если доступный объём не позволяет выполнить заявку, она не будет выставлена вовсе.

Примеры запросов​

Общие требования​

Заявку через API можно выставить на исполнение, изменить и снять с исполнения, если она не была выполнена ранее. При этом, независимо от выбранного действия и протокола взаимодействия, все запросы должны:

  • Быть авторизованными
  • Быть идентифицируемыми
  • Содержать сообщение со всеми необходимыми характеристиками заявки

От протокола взаимодействия же зависит, как эти условия соблюсти.

Авторизация

Авторизация нужна для подтверждения у отправителя наличия прав на использование запрошенного ресурса. Для авторизации запросов используется JWT токен, выполняющий роль Access токена. Полное описание доступных способов авторизации представлено в разделе Авторизация.

В HTTP API для передачи токена используется параметр заголовка Authorization. Заголовок должен передаваться с каждым выполняемым запросом.

Передаётся этот токен как Bearer-токен, в связи с чем заголовок должен содержать префикс Bearer перед передаваемым значением. Выглядит корректно заполненный заголовок Authorization так:

Authorization: Bearer eyJhbGciOiJFUzI1NiIsInR5cCI6IkpXVCIsImN0eSI6IkpXVCJ9.eyJzdWIiOiJMb2dpblNhbXBsZSIsImVudCI6ImNsaWVudCIsImVpbiI6IjAxMjM0IiwiY2xpZW50aWQiOiIwMTIzNDU2IiwiYXpwIjoiMDEyMzQ1Njc4OWFiY2RlZjAxMjMiLCJhZ3JlZW1lbnRzIjoiQWdyZWVtZW50U2FtcGxlMSBBZ3JlZW1lbnRTYW1wbGUyIEFncmVlbWVudFNhbXBsZTMiLCJwb3J0Zm9saW9zIjoiUG9ydGZvbGlvU2FtcGxlMSBQb3J0Zm9saW9TYW1wbGUyIFBvcnRmb2xpb1NhbXBsZTMiLCJzY29wZSI6Ik9yZGVyc1JlYWQgT3JkZXJzQ3JlYXRlIFRyYWRlcyBQZXJzb25hbCBTdGF0cyIsImV4cCI6Mjg3MTc2MzE5OSwiaWF0IjowLCJpc3MiOiJBbG9yLklkZW50aXR5IiwiYXVkIjoiQ2xpZW50IFdBUlAgV2FycEFUQ29ubmVjdG9yIHN1YnNjcmlwdGlvbnNBcGkgQ29tbWFuZEFwaSBJbnN0cnVtZW50QXBpIFRyYWRpbmdWaWV3UGxhdGZvcm0ifQ.QOQVMIAoZ6SnF5urnIzJ0EvtQd9P5Sx355069kXoID207wHOTW0wkKNMcrIKXmENEQQ_0yDjqH_kjeqWLBJuqA

Идентификация

Идентификация запроса нужна для разделения десятка однотипных запросов на уникальные. Идентификатор задаётся со стороны пользователя и передаётся в виде значения параметра заголовка X-ALOR-REQID, в связи с чем рекомендуем предусмотреть механизм его генерации в используемом ПО.

В качестве идентификатора запроса можно использовать любую символьную комбинацию, включая специальные символы !@№;%:?*()-_=+/|"'. На идентификатор действуют два ограничения:

  • Значение идентификатора должно быть уникальным для торговой системы. Если значение ранее уже использовалось для другого запроса, вместо повторного выполнения будет возвращена копия ответа на первый запрос с этим идентификатором

  • Спец.символы, нарушающие целостность JSON объекта, должны быть экранированы

Таким образом, в качестве идентификатора запроса система готова принять как Dxxxxx-Order-Market-No-812643-@-MOEX, так и d3c886f1-ea1e-4634-aff4-119c902ad926 при условии, что эти значения не передавались ни одним из пользователей API ранее.

Корректно заполненный заголовок X-ALOR-REQID не требует дополнительных префиксов и выглядит следующим образом:

X-ALOR-REQID: d3c886f1-ea1e-4634-aff4-119c902ad926

Управление заявками​

Взаимозаменяемость запросов

Способы создания заявок взаимозаменяемы. Например, заявку, выставленную через HTTP API, можно изменить или снять через WebSocket API, и наоборот.

Выставление заявки

Интерактивный запрос

Интерактивное описание запроса доступно на странице Создание рыночной заявки

Для создания рыночной заявки через HTTP API используется POST-запрос к конечной точке /commandapi/warptrans/TRADE/v2/client/orders/actions/market с сообщением, содержащим все параметры заявки.

Полный URL конечной точки выглядит так:

https://api.alor.ru/commandapi/warptrans/TRADE/v2/client/orders/actions/market
https://apidev.alor.ru/commandapi/warptrans/TRADE/v2/client/orders/actions/market

В теле сообщения необходимо указать основную информацию о заявке: направление сделки, количество лотов, данные об инструменте, портфель и условие выполнения заявки. При необходимости можно добавить пользовательский комментарий, облегчающий идентификацию заявки человеком.

Пример тела запроса
{
	"side": "buy",
	"quantity": 100,
	"instrument": {
		"symbol": "SBER",
		"exchange": "MOEX",
		"instrumentGroup": "TQBR"
	},
	"comment": "Пользовательский комментарий к заявке",
	"user": {
		"portfolio": "D39004"
	},
	"timeInForce": "oneday"
}
Ожидаемый результат

Создана рыночная заявка на покупку 100 лотов инструмента SBER на Московской Бирже (MOEX) в режиме T+2 (TQBR) по той цене, которая является лучшей ценой лота в момент исполнения.

В случае успешного выполнения запроса API вернёт сообщение с кодом ответа 200, содержащее в себе биржевой номер заявки:

Пример тела ответа
{
  "message": "success",
  "orderNumber": "189...559"
}

Если обработка запроса завершилась ошибкой, API вернёт информацию о причинах этой ошибки.

Параметры запроса

Полный список всех параметров и возможных ответов доступен на странице описания запроса.

Изменение заявки

Интерактивный запрос

Интерактивное описание запроса доступно на странице Изменение рыночной заявки

Для изменения ранее выставленной заявки через HTTP API используется PUT-запрос к конечной точке /commandapi/warptrans/TRADE/v2/client/orders/{orderId}, где {orderId} — Path-параметр, в котором передаётся номер заявки.

Изменение заявки

Изменение происходит через отмену ранее выставленной заявки и публикацию новой. Изменение исполненной или отменённой заявки невозможно.

Полный URL конечной точки выглядит так:

https://api.alor.ru/commandapi/warptrans/TRADE/v2/client/orders/actions/market/189...559
https://apidev.alor.ru/commandapi/warptrans/TRADE/v2/client/orders/actions/market/189...559

Где 189...559 — фактическое значение параметра {orderId}.

При изменении существующей заявки используется сообщение, идентичное запросу на выставление заявки. Отличие заключается в других значениях параметров.

Пример тела запроса
{
	"side": "buy",
	"quantity": 10,
	"instrument": {
		"symbol": "SBER",
		"exchange": "MOEX",
		"instrumentGroup": "TQBR"
	},
	"comment": "Пользовательский комментарий к заявке",
	"user": {
		"portfolio": "D39004"
	},
	"timeInForce": "oneday"
}
Ожидаемый результат

Заявка с номером 189...559 отменена. Создана новая рыночная заявка на покупку 10 лотов инструмента SBER на Московской Бирже (MOEX) в режиме T+2 (TQBR) по той цене, которая является лучшей ценой лота в момент исполнения.

В случае успешного выполнения запроса прежняя заявка будет отменена и API вернёт сообщение с кодом ответа 200, содержащее в себе биржевой номер новой заявки:

Пример тела ответа
{
  "message": "success",
  "orderNumber": "189...560"
}

Если обработка запроса завершилась ошибкой, API вернёт информацию о причинах этой ошибки.

Параметры запроса

Полный список всех параметров и возможных ответов доступен на странице описания запроса.

Снятие заявки

Интерактивный запрос

Интерактивное описание запроса доступно на странице Снятие заявки

Отмена заявки

Отменить можно только ожидающую исполнения заявку. Отмена исполненной заявки невозможна.

Для снятия ранее выставленной заявки через HTTP API используется DELETE-запрос к конечной точке /commandapi/warptrans/TRADE/v2/client/orders/{orderId}, где {orderId} — Path-параметр, в котором передаётся номер заявки.

Помимо номера заявки необходимо также указать следующие атрибуты заявки:

Query-параметры

    portfolio stringrequired

    Идентификатор клиентского портфеля

    Example: D39004
    exchange stringrequired

    Possible values: [MOEX]

    Биржа

    stop booleanrequired

    Является стоп-заявкой?

    Example: false

Таким образом, полный URL запроса для снятия заявки выглядит так:

https://api.alor.ru/commandapi/warptrans/TRADE/v2/client/orders/189...560?portfolio=D39004&exchange=MOEX&stop=false
https://apidev.alor.ru/commandapi/warptrans/TRADE/v2/client/orders/189...560?portfolio=D39004&exchange=MOEX&stop=false
Ожидаемый результат

Заявка с номером 189...560 отменена.

В случае успешного выполнения запроса прежняя заявка будет отменена и API вернёт сообщение с кодом ответа 200:

success

Если обработка запроса завершилась ошибкой, API вернёт информацию о причинах этой ошибки.

Параметры запроса

Полный список всех параметров и возможных ответов доступен на странице описания запроса.

Группы заявок

При необходимости рыночную заявку можно объединить в группу с другими заявками для связности выполнения.

Что дальше?​

Для быстрого погружения в процессы использования API можете воспользоваться руководствами по быстрому старту для тестового и боевого контуров системы.