Работа над ошибками

📢 Уважаемые клиенты! 📢

Делимся с Вами новостями о последних изменениях!

✏ В этом дайджесте:

• Удаление instrumentGroup из ряда подписок
• Обновление ответа на запрос ставок риска
• Исправление нескольких ошибочных формулировок

А также перенос кнопки раздела изменений.

---

Исправление ошибки с instrumentGroup в подписках

Некоторые страницы описания WebSocket-подписок содержали в теле запроса параметр instrumentGroup, добавленный туда ошибочно. Хорошая новость в том, что этот параметр не влиял на выполнение тех запросов, где он был лишним. Это же и плохая новость — наличие instrumentGroup в описании создавало ошибочное представление о возможном функционале системы.

В текущем обновлении документации наличие instrumentGroup в описании тела запроса приведено в соответствие с логикой работы системы.

Влияет на запросы

WebSocket-подписки

Оставлен	Удалён
AllTradesGetAndSubscribe BarsGetAndSubscribe InstrumentsGetAndSubscribeV2 OrderBookGetAndSubscribe QuotesSubscribe	OrdersGetAndSubscribe PositionsGetAndSubscribe RisksGetAndSubscribe SpectraRisksGetAndSubscribe StopOrdersGetAndSubscribeV2 SummariesGetAndSubscribeV2 TradesGetAndSubscribe

---

Обновление ответа на запрос ставок риска

В ответе на запрос Ставки риска произошли целых два изменения:

1. Поле isDirect (boolean) было заменено другим — sngR (int32) — с тем же предназначением, но другими возможными значениями. Полное описание поля доступно на странице запроса.
2. Поля CreatedAt, UpdatedAt и UpdatedBy были полностью удалены из ответа. Они были добавлены исключительно для внутреннего использования и были добавлены в публичный доступ по ошибке.

Рекомендуем обновить ваше ПО во избежание ошибок обработки ответов.

---

Исправление ошибочных формулировок

Нереализованная прибыль или убыток

Исправлены некорректные описания полей, отражающих нереализованную прибыль или убыток по позиции:

unrealisedPl / up

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

dailyUnrealisedPl / upd

Было	суммарная прибыль или суммарный убыток за день в процентах
Стало	Дневная неисполненная прибыль или убыток по открытым позициям в валюте расчётов. Отображает разницу между ценой позиции на момент открытия текущей торговой сессии и её текущей ценой

Влияет на запросы

HTTP

• /md/v2/Clients/{exchange}/{portfolio}/positions
• /md/v2/Clients/{exchange}/{portfolio}/positions/symbol
• /md/v2/Clients/{login}/positions

WebSocket-подписки

• PositionsGetAndSubscribe

Условие выполнения заявки attheclose

Описание значения attheclose дополнено логикой его поведения и сферой применения:

timeInForce / tf

Было	attheclose — Исполнение в момент закрытия торгов по достигнутой на тот момент рыночной цене. Только для рыночных заявок, т.к. цена лота зависит от рыночной цены на момент исполнения
Стало	attheclose — Исполнение в момент закрытия торгов по достигнутой на тот момент рыночной цене. Только для SPBX (на MOEX автоматически меняется на fillorkill) и только для рыночных заявок, т.к. цена лота зависит от рыночной цены на момент исполнения

Влияет на запросы

HTTP

• /md/v2/Clients/{exchange}/{portfolio}/orders
• /md/v2/Clients/{exchange}/{portfolio}/orders/{orderId}
• /md/v2/Clients/{exchange}/{portfolio}/stoporders
• /md/v2/Clients/{exchange}/{portfolio}/stoporders/{orderId}
• /commandapi/warptrans/TRADE/v2/client/orders/actions/limit
• /commandapi/warptrans/TRADE/v2/client/orders/actions/market
• /commandapi/warptrans/TRADE/v2/client/orders/actions/market/{orderId}
• /commandapi/warptrans/TRADE/v2/client/orders/actions/stopLimit
• /commandapi/warptrans/TRADE/v2/client/orders/actions/stopLimit/{stopOrderId}

Устаревшие HTTP

• /warptrans/{tradeServerCode}/v2/client/orders/actions/takeProfitLimit
• /warptrans/{tradeServerCode}/v2/client/orders/actions/stopLossLimit
• /warptrans/{tradeServerCode}/v2/client/orders/actions/takeProfitLimit/{orderId}
• /warptrans/{tradeServerCode}/v2/client/orders/actions/stopLossLimit/{orderId}

WebSocket-подписки

• OrdersGetAndSubscribeV2
• StopOrdersGetAndSubscribeV2

WebSocket-команды

• create:limit
• create:market
• create:stopLimit
• update:market
• update:stopLimit

Для соответствия изменениям в описании параметра были обновлены соответствующие таблицы на страницах описания для разных типов заявок.

---

Перенос кнопки раздела изменений

Некоторых пользователей вводила в заблуждение кнопка "Изменения", размещённая прежде в правой части экрана, так как она копировала кнопку Кабинет разработчика и из-за этого визуально сливалась с ней воедино. По их просьбам кнопка была заменена на простую ссылку и перенесена в левую часть навигационной панели к ссылкам на прочие разделы портала документации.

---

Если у вас возникли вопросы о работе системы, свяжитесь с нами любым удобным способом:

Чат OpenAPI	support@alor.ru	8 800 775-11-99
Чат Astras	Личный кабинет	+7 495 980-24-98

А через Портал обратной связи вы можете передать нам свои идеи по дальнейшему развитию системы.

Спасибо, что помогаете нам делать систему лучше!