Все сделки по инструменту
Приватный ресурс
Запрос нельзя выполнить анонимно. Обязательный параметр token должен содержать актуальный Access токен.
Альтернативная команда
Для этой операции есть альтернатива в виде HTTP-запроса.
Запрос создаёт подписку на получение информации обо всех сделках, совершённых на указанной бирже с выбранным финансовым инструментом.
Запрос
Для создания подписки на информационный канал отправьте в установленное WebSocket-соединение сообщение с телом запроса, содержащим детали создаваемой подписки.
- Тело запроса
- Схема
{
"opcode": "AllTradesGetAndSubscribe",
"exchange": "MOEX",
"code": "SBER",
"instrumentGroup": "TQBR",
"depth": 50,
"includeVirtualTrades": false,
"format": "Simple",
"guid": "c328fcf1-e495-408a-a0ed-e20f95d6b813",
"token": "eyJhbGciOiJ..."
}
Параметры тела запроса
OrderBookGetAndSubscribe— Подписка на биржевой стаканBarsGetAndSubscribe— Подписка на историю цен (свечи)QuotesSubscribe— Подписка на информацию о котировкахInstrumentsGetAndSubscribeV2— Подписка на изменение информации о финансовых инструментах на выбранной биржеAllTradesGetAndSubscribe— Подписка на все сделкиPositionsGetAndSubscribeV2— Подписка на информацию о текущих позициях по торговым инструментам и деньгамSummariesGetAndSubscribeV2— Подписка на сводную информацию по портфелюRisksGetAndSubscribe— Подписка на сводную информацию по портфельным рискамSpectraRisksGetAndSubscribe— Подписка на информацию по рискам срочного рынка (FORTS)TradesGetAndSubscribeV2— Подписка на информацию о сделкахOrdersGetAndSubscribeV2— Подписка на информацию о текущих заявках на рынке для выбранных биржи и финансового инструментаStopOrdersGetAndSubscribeV2— Подписка на информацию о текущих заявках на рынке для выбранных биржи и финансового инструментаunsubscribe— Отмена существующей подпискиMOEX— Московская БиржаSPBX— СПБ Биржа- Для Московской Биржи список кодов доступен в таблице
- Для Биржи СПБ всегда SPBX
Simple— оригинальный формат данных. Поддерживает устаревшие параметры для обеспечения обратной совместимостиSlim— облегчённый формат данных для быстрой передачи сообщений. Не поддерживает устаревшие параметрыHeavy— полный формат данных, развивающийся и дополняющийся новыми полями. Не поддерживает устаревшие параметры
Код выполняемой операции:
Биржа:
Пример: MOEX
Тикер (Код финансового инструмента)
Пример: SBER
Код режима торгов (Борд):
Пример: TQBR
Если указать, то перед актуальными данными придут данные о последних N сделках.
Пример: 50
Указывает, нужно ли отправлять виртуальные (индикативные) сделки
Пример: false
Формат возвращаемого сервером JSON-объекта:
От формата объекта также зависит минимальное значение параметра frequency для WebSocket-подписок.
Пример: Simple
Уникальный идентификатор запроса. Все ответные сообщения будут иметь такое же значение поля guid
Пример: c328fcf1-e495-408a-a0ed-e20f95d6b813
Access Токен для авторизации запроса
Пример: eyJhbGciOiJ...
Ответы
Содержимое ответа, возвращаемого в WebSocket-соединение, зависит от результатов обработки запроса:
- Если запрос обработан успешно, сервер передаст в ответ одно сообщение с кодом
200, подтверждающее создание подписки, после чего начнёт передачу сообщений с кодом100, содержащих запрошенную в рамках подписки информацию. - Если обработка запроса завершилась неудачей, сервер передаст в ответ одно сообщение с кодом ошибки, соответствующим причине отказа, после чего закроет WebSocket-соединение.
Сообщения
- 100
- 200
- 401
Сообщения от канала, содержащие в себе информацию, запрошенную в рамках подписки
- Формат Simple
- Формат Slim
- Формат Heavy
- Тело ответа
- Схема
{
"data": {
"id": 9328828503,
"orderno": 0,
"symbol": "SBER",
"board": "TQBR",
"qty": 5,
"price": 271.57,
"time": "2023-12-29T15:04:27.8005470Z",
"timestamp": 1703862267800,
"oi": 0,
"existing": false,
"side": "sell"
},
"guid": "c328fcf1-e495-408a-a0ed-e20f95d6b813"
}
Параметры тела ответа
- Для Московской Биржи список кодов доступен в таблице
- Для Биржи СПБ всегда SPBX
buy— Купляsell— Продажа
data
object
Блок данных от информационного канала
Уникальный идентификатор сделки
Пример: 9328828503
Уникальный идентификатор заявки
Пример: 2006665023417483347
Тикер (Код финансового инструмента). [N/A] используется, если symbol не определен
Пример: SBER
Код режима торгов (Борд):
Пример: TQBR
Количество
Пример: 5
Цена
Пример: 271.57
Дата и время (UTC) закрытия заявки
Пример: 2023-12-29T15:04:27.8005470Z
Время (UTC) в формате Unix Time Milliseconds
Пример: 1703862267800
Открытый интерес (open interest). Если не поддерживается инструментом — значение 0 или null
Пример: 0
True — для данных из снепшота, то есть из истории. False — для новых событий
Пример: false
Направление сделки:
Пример: sell
Уникальный идентификатор запроса. Все ответные сообщения будут иметь такое же значение поля guid
Пример: c328fcf1-e495-408a-a0ed-e20f95d6b813
- Тело ответа
- Схема
{
"data": {
"id": 9328828503,
"sym": "SBER",
"bd": "TQBR",
"q": 5,
"px": 271.57,
"t": 1703862267800,
"oi": 0,
"h": false,
"s": "sell"
},
"guid": "c328fcf1-e495-408a-a0ed-e20f95d6b813"
}
Параметры тела ответа
- Для Московской Биржи список кодов доступен в таблице
- Для Биржи СПБ всегда SPBX
buy— Купляsell— Продажа
data
object
Блок данных от информационного канала
Уникальный идентификатор сделки
Пример: 9328828503
Уникальный идентификатор заявки
Пример: 2006665023417483347
Тикер (Код финансового инструмента). [N/A] используется, если symbol не определен
Пример: SBER
Код режима торгов (Борд):
Пример: TQBR
Количество
Пример: 5
Цена
Пример: 271.57
Время (UTC) в формате Unix Time Milliseconds
Пример: 1703862267800
Открытый интерес (open interest). Если не поддерживается инструментом — значение 0 или null
Пример: 0
True — для данных из снепшота, то есть из истории. False — для новых событий
Пример: false
Направление сделки:
Пример: sell
Уникальный идентификатор запроса. Все ответные сообщения будут иметь такое же значение поля guid
Пример: c328fcf1-e495-408a-a0ed-e20f95d6b813
- Тело ответа
- Схема
{
"data": {
"id": 9328828503,
"symbol": "SBER",
"board": "TQBR",
"qty": 5,
"price": 271.57,
"time": "2023-12-29T15:04:27.8005470Z",
"timestamp": 1703862267800,
"oi": 0,
"existing": false,
"side": "sell"
},
"guid": "c328fcf1-e495-408a-a0ed-e20f95d6b813"
}
Параметры тела ответа
- Для Московской Биржи список кодов доступен в таблице
- Для Биржи СПБ всегда SPBX
buy— Купляsell— Продажа
data
object
Блок данных от информационного канала
Уникальный идентификатор сделки
Пример: 9328828503
Тикер (Код финансового инструмента). [N/A] используется, если symbol не определен
Пример: SBER
Код режима торгов (Борд):
Пример: TQBR
Количество
Пример: 5
Цена
Пример: 271.57
Дата и время (UTC) закрытия заявки
Пример: 2023-12-29T15:04:27.8005470Z
Время (UTC) в формате Unix Time Milliseconds
Пример: 1703862267800
Открытый интерес (open interest). Если не поддерживается инструментом — значение 0 или null
Пример: 0
True — для данных из снепшота, то есть из истории. False — для новых событий
Пример: false
Направление сделки:
Пример: sell
Уникальный идентификатор запроса. Все ответные сообщения будут иметь такое же значение поля 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!