Все сделки по портфелю
Запрос нельзя выполнить анонимно. Обязательный параметр token
должен содержать актуальный Access Токен.
Для этой операции есть альтернативный HTTP-запрос.
Запрос создаёт подписку на получение информации о всех сделках, совершённых с использованием указанного портфеля.
Запрос
Для создания подписки на информационный канал отправьте в установленное WebSocket-соединение сообщение с телом запроса, содержащим детали создаваемой подписки.
- Тело запроса
- Схема
{
"opcode": "TradesGetAndSubscribeV2",
"portfolio": "D39004",
"skipHistory": false,
"exchange": "MOEX",
"instrumentGroup": "TQBR",
"format": "Simple",
"guid": "c328fcf1-e495-408a-a0ed-e20f95d6b813",
"token": "eyJhbGciOiJ..."
}
Параметры тела запроса
OrderBookGetAndSubscribe
— Подписка на биржевой стаканBarsGetAndSubscribe
— Подписка на историю цен (свечи)QuotesSubscribe
— Подписка на информацию о котировкахInstrumentsGetAndSubscribeV2
— Подписка на изменение информации о финансовых инструментах на выбранной биржеAllTradesGetAndSubscribe
— Подписка на все сделкиPositionsGetAndSubscribeV2
— Подписка на информацию о текущих позициях по торговым инструментам и деньгамSummariesGetAndSubscribeV2
— Подписка на сводную информацию по портфелюRisksGetAndSubscribe
— Подписка на сводную информацию по портфельным рискамSpectraRisksGetAndSubscribe
— Подписка на информацию по рискам срочного рынка (FORTS)TradesGetAndSubscribeV2
— Подписка на информацию о сделкахOrdersGetAndSubscribeV2
— Подписка на информацию о текущих заявках на рынке для выбранных биржи и финансового инструментаStopOrdersGetAndSubscribeV2
— Подписка на информацию о текущих заявках на рынке для выбранных биржи и финансового инструментаunsubscribe
— Отмена существующей подпискиtrue
— отображать только новые данныеfalse
— отображать в том числе данные из историиworking
— На исполненииfilled
— Исполненаcanceled
— Отмененаrejected
— ОтклоненаMOEX
— Московская БиржаSPBX
— СПБ Биржа- Для Московской Биржи список кодов доступен в таблице
- Для Биржи СПБ всегда SPBX
Simple
— оригинальный формат данных. Поддерживает устаревшие параметры для обеспечения обратной совместимостиSlim
— облегчённый формат данных для быстрой передачи сообщений. Не поддерживает устаревшие параметрыHeavy
— полный формат данных, развивающийся и дополняющийся новыми полями. Не поддерживает устаревшие параметры
Код выполняемой операции:
Идентификатор клиентского портфеля
Пример: D39004
Флаг отсеивания исторических данных:
Пример: false
Опциональный фильтр по статусам заявок. Влияет только на фильтрацию первичных исторических данных при подписке. Возможные значения:
Пример: filled
Биржа:
Пример: MOEX
Код режима торгов (Борд):
Пример: TQBR
Формат возвращаемого сервером JSON-объекта:
От формата объекта также зависит минимальное значение параметра frequency
для WebSocket-подписок.
Пример: Simple
Уникальный идентификатор запроса. Все ответные сообщения будут иметь такое же значение поля guid
Пример: c328fcf1-e495-408a-a0ed-e20f95d6b813
Access Токен для авторизации запроса
Пример: eyJhbGciOiJ...
Ответы
Содержимое ответа, возвращаемого в WebSocket-соединение, зависит от результатов обработки запроса:
- Если запрос обработан успешно, сервер передаст в ответ одно сообщение с кодом
200
, подтверждающее создание подписки, после чего начнёт передачу сообщений с кодом100
, содержащих запрошенную в рамках подписки информацию. - Если обработка запроса завершилась неудачей, сервер передаст в ответ одно сообщение с кодом ошибки, соответствующим причине отказа, после чего закроет WebSocket-соединение.
- 100
- 200
- 401
Сообщения от канала, содержащие в себе информацию, запрошенную в рамках подписки
- Формат Simple
- Формат Slim
- Формат Heavy
- Тело ответа
- Схема
{
"data": {
"id": "4421925358",
"orderno": "42030831469",
"comment": null,
"symbol": "GAZP",
"brokerSymbol": "MOEX:GAZP",
"exchange": "MOEX",
"date": "2023-12-29T12:35:06.0000000Z",
"board": "TQBR",
"qtyUnits": 10,
"qtyBatch": 1,
"qty": 1,
"price": 170.21,
"accruedInt": 0,
"side": "buy",
"existing": true,
"commission": 1.361050,
"repoSpecificFields": null,
"volume": 1702.10
},
"guid": "c328fcf1-e495-408a-a0ed-e20f95d6b813"
}
Параметры тела ответа
MOEX
— Московская БиржаSPBX
— СПБ Биржа- Для Московской Биржи список кодов доступен в таблице
- Для Биржи СПБ всегда SPBX
buy
— Купляsell
— Продажа
data
object
Блок данных от информационного канала
Уникальный идентификатор сделки
Пример: 4421925358
Идентификатор заявки
Пример: 0
Пользовательский комментарий к заявке
Пример: Первая заявка
Тикер (Код финансового инструмента). [N/A]
используется, если symbol
не определен
Пример: SBER
Пара Биржа:Тикер
Пример: MOEX:ALRS-3.24
Биржа:
Пример: MOEX
Дата и время (UTC) закрытия заявки
Пример: 2023-12-29T12:35:06.0000000Z
Код режима торгов (Борд):
Пример: TQBR
Количество (штуки)
Пример: 1
Количество (лоты)
Пример: 1
Количество
Пример: 5
Цена
Пример: 271.57
Начислено (НКД)
Пример: 0
Направление сделки:
Пример: sell
True
— для данных из снепшота, то есть из истории. False
— для новых событий
Пример: false
Суммарная комиссия (null для Срочного рынка)
Пример: 1,36
repoSpecificFields
object
Специальные поля для сделок РЕПО
Цена репо в процентах годовых.
Пример: 23.45
Поле-примечание, используется для обратной связи с внешними системами. Например, идентификатор пользователя внешней системы, поставившего заявку.
Пример: MB0014100002
Срок РЕПО - промежуток времени, выраженный в календарных днях, между датами исполнения первой и второй частей сделки РЕПО.
Пример: 2
Торговый счет, в счет которого заключена данная сделка
Пример: MB0014100002
Описание типа сделки
Пример: Расчетная по операции своп
Объем сделки, выраженный в валюте расчетов
Пример: 46
Доходность, рассчитанная по цене сделки
Пример: null
Объём, рассчитанный по средней цене
Пример: 1702.10
Уникальный идентификатор запроса. Все ответные сообщения будут иметь такое же значение поля guid
Пример: c328fcf1-e495-408a-a0ed-e20f95d6b813
- Тело ответа
- Схема
{
"data": {
"id": "4421925358",
"eid": "42030831469",
"cmt": null,
"sym": "GAZP",
"tic": "MOEX:GAZP",
"ex": "MOEX",
"d": "2023-12-29T12:35:06.0000000Z",
"b": "TQBR",
"q": 10,
"qb": 1,
"px": 170.21,
"ai": 0,
"s": "buy",
"h": true,
"cms": 1.361050,
"r": null,
"v": 1702.10
},
"guid": "c328fcf1-e495-408a-a0ed-e20f95d6b813"
}
Параметры тела ответа
MOEX
— Московская БиржаSPBX
— СПБ Биржа- Для Московской Биржи список кодов доступен в таблице
- Для Биржи СПБ всегда SPBX
buy
— Купляsell
— Продажа
data
object
Блок данных от информационного канала
Уникальный идентификатор сделки
Пример: 4421925358
Идентификатор заявки
Пример: 0
Пользовательский комментарий к заявке
Пример: Первая заявка
Тикер (Код финансового инструмента). [N/A]
используется, если symbol
не определен
Пример: SBER
Пара Биржа:Тикер
Пример: MOEX:ALRS-3.24
Биржа:
Пример: MOEX
Дата и время (UTC) закрытия заявки
Пример: 2023-12-29T12:35:06.0000000Z
Код режима торгов (Борд):
Пример: TQBR
Количество (штуки)
Пример: 1
Количество (лоты)
Пример: 1
Цена
Пример: 271.57
Начислено (НКД)
Пример: 0
Направление сделки:
Пример: sell
True
- для данных из снепшота, то есть из истории. False
- для новых событий
Пример: false
Суммарная комиссия (null для Срочного рынка)
Пример: 1,36
r
object
Специальные поля для сделок РЕПО
Цена репо в процентах годовых.
Пример: 23.45
Поле-примечание, используется для обратной связи с внешними системами. Например, идентификатор пользователя внешней системы, поставившего заявку.
Пример: MB0014100002
Срок РЕПО - промежуток времени, выраженный в календарных днях, между датами исполнения первой и второй частей сделки РЕПО.
Пример: 2
Торговый счет, в счет которого заключена данная сделка
Пример: MB0014100002
Описание типа сделки
Пример: Расчетная по операции своп
Объем сделки, выраженный в валюте расчетов
Пример: 46
Доходность, рассчитанная по цене сделки
Пример: null
Объём, рассчитанный по средней цене
Пример: 1702.10
Уникальный идентификатор запроса. Все ответные сообщения будут иметь такое же значение поля guid
Пример: c328fcf1-e495-408a-a0ed-e20f95d6b813
- Тело ответа
- Схема
{
"data": {
"id": "4421925358",
"orderNo": "42030831469",
"comment": null,
"symbol": "GAZP",
"brokerSymbol": "MOEX:GAZP",
"exchange": "MOEX",
"date": "2023-12-29T12:35:06.0000000Z",
"board": "TQBR",
"qtyUnits": 10,
"qtyBatch": 1,
"qty": 1,
"price": 170.21,
"accruedInt": 0,
"side": "buy",
"existing": true,
"commission": 1.361050,
"repoSpecificFields": null,
"volume": 1702.10,
"settleDate": "2024-12-31T23:59:59.9990000Z"
},
"guid": "c328fcf1-e495-408a-a0ed-e20f95d6b813"
}
Параметры тела ответа
MOEX
— Московская БиржаSPBX
— СПБ Биржа- Для Московской Биржи список кодов доступен в таблице
- Для Биржи СПБ всегда SPBX
buy
— Купляsell
— Продажа
data
object
Блок данных от информационного канала
Уникальный идентификатор сделки
Пример: 4421925358
Идентификатор заявки
Пример: 0
Пользовательский комментарий к заявке
Пример: Первая заявка
Тикер (Код финансового инструмента). [N/A]
используется, если symbol
не определен
Пример: SBER
Пара Биржа:Тикер
Пример: MOEX:ALRS-3.24
Биржа:
Пример: MOEX
Дата и время (UTC) закрытия заявки
Пример: 2023-12-29T12:35:06.0000000Z
Код режима торгов (Борд):
Пример: TQBR
Количество (штуки)
Пример: 1
Количество (лоты)
Пример: 1
Количество
Пример: 5
Цена
Пример: 271.57
Начислено (НКД)
Пример: 0
Направление сделки:
Пример: sell
True
- для данных из снепшота, то есть из истории. False
- для новых событий
Пример: false
Суммарная комиссия (null для Срочного рынка)
Пример: 1,36
repoSpecificFields
object
Специальные поля для сделок РЕПО
Цена репо в процентах годовых.
Пример: 23.45
Поле-примечание, используется для обратной связи с внешними системами. Например, идентификатор пользователя внешней системы, поставившего заявку.
Пример: MB0014100002
Срок РЕПО - промежуток времени, выраженный в календарных днях, между датами исполнения первой и второй частей сделки РЕПО.
Пример: 2
Торговый счет, в счет которого заключена данная сделка
Пример: MB0014100002
Описание типа сделки
Пример: Расчетная по операции своп
Объем сделки, выраженный в валюте расчетов
Пример: 46
Доходность, рассчитанная по цене сделки
Пример: null
Объём, рассчитанный по средней цене
Пример: 1702.10
Дата исполнения обязательств по сделке в формате UTC
Пример: 2024-12-31T23:59:59.9990000Z
Уникальный идентификатор запроса. Все ответные сообщения будут иметь такое же значение поля guid
Пример: c328fcf1-e495-408a-a0ed-e20f95d6b813
Сообщение об успешной обработке запроса на подписку
- Тело ответа
- Схема
{
"message": "Handled successfully",
"httpCode": 200,
"requestGuid": "c328fcf1-e495-408a-a0ed-e20f95d6b813"
}
Параметры тела ответа
Текстовое представление возвращаемого сообщения
Пример: Handled successfully
Код возвращаемого сообщения
Пример: 200
Уникальный идентификатор запроса. Значением выступает параметр guid
, указанный в теле запроса
Пример: c328fcf1-e495-408a-a0ed-e20f95d6b813
Не удалось авторизовать запрос — Access Токен не указан в теле запроса, срок его действия истёк или он относится к другому контуру системы
- Тело ответа
- Схема
{
"requestGuid": "c328fcf1-e495-408a-a0ed-e20f95d6b813",
"httpCode": 401,
"message": "Invalid JWT token!"
}
Параметры тела ответа
Уникальный идентификатор запроса. Значением выступает параметр guid
, указанный в теле запроса
Пример: c328fcf1-e495-408a-a0ed-e20f95d6b813
Код возвращаемого сообщения
Пример: 401
Текстовое представление возвращаемого сообщения
Пример: Invalid JWT token!