Все сделки по инструменту
Запрос нельзя выполнить анонимно. Обязательный параметр token должен содержать актуальный Access Токен.
Для этой операции есть альтернативный HTTP-запрос.
Запрос создаёт подписку на получение информации обо всех сделках, совершённых на указанной бирже с выбранным финансовым инструментом.
Запрос
Для создания подписки на информационный канал отправьте в установленное WebSocket-соединение сообщение с телом запроса, содержащим детали создаваемой подписки.
- Тело запроса
- Схема
{
"opcode": "AllTradesGetAndSubscribe",
"exchange": "ITS",
"code": "SOGN",
"instrumentGroup": "ITS",
"depth": 50,
"includeVirtualTrades": false,
"format": "Simple",
"guid": "c328fcf1-e495-408a-a0ed-e20f95d6b813",
"token": "eyJhbGciOiJ..."
}
Параметры тела запроса
OrderBookGetAndSubscribe— Подписка на биржевой стаканBarsGetAndSubscribe— Подписка на историю цен (свечи)QuotesSubscribe— Подписка на информацию о котировкахInstrumentsGetAndSubscribeV2— Подписка на изменение информации о финансовых инструментах на выбранной биржеAllTradesGetAndSubscribe— Подписка на все сделкиPositionsGetAndSubscribeV2— Подписка на информацию о текущих позициях по торговым инструментам и деньгамSummariesGetAndSubscribeV2— Подписка на сводную информацию по портфелюRisksGetAndSubscribe— Подписка на сводную информацию по портфельным рискамTradesGetAndSubscribeV2— Подписка на информацию о сделкахOrdersGetAndSubscribeV2— Подписка на информацию о текущих заявках на рынке для выбранных биржи и финансового инструментаStopOrdersGetAndSubscribeV2— Подписка на информацию о текущих заявках на рынке для выбранных биржи и финансового инструментаunsubscribe— Отмена существующей подпискиSimple— оригинальный формат данных. Поддерживает устаревшие параметры для обеспечения обратной совместимостиSlim— облегчённый формат данных для быстрой передачи сообщений. Не поддерживает устаревшие параметрыHeavy— полный формат данных, развивающийся и дополняющийся новыми полями. Не поддерживает устаревшие параметры
Код выполняемой операции:
Код биржи
Пример: ITS
Тикер (Код финансового инструмента)
Пример: SOGN
Код режима торгов (Борд). Для биржи ITS всегда ITS
Пример: ITS
Если указать, то перед актуальными данными придут данные о последних 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": "SOGN",
"board": "ITS",
"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"
}
Параметры тела ответа
buy— Купляsell— Продажа
data
object
Блок данных от информационного канала
Уникальный идентификатор
Пример: 9328828503
Уникальный идентификатор заявки
Пример: 2006665023417483347
Тикер (Код финансового инструмента). [N/A] используется, если symbol не определен
Пример: SOGN
Код режима торгов (Борд). Для биржи ITS всегда ITS
Пример: ITS
Количество
Пример: 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": "SOGN",
"bd": "ITS",
"q": 5,
"px": 271.57,
"t": 1703862267800,
"oi": 0,
"h": false,
"s": "sell"
},
"guid": "c328fcf1-e495-408a-a0ed-e20f95d6b813"
}
Параметры тела ответа
buy— Купляsell— Продажа
data
object
Блок данных от информационного канала
Уникальный идентификатор
Пример: 9328828503
Уникальный идентификатор заявки
Пример: 2006665023417483347
Тикер (Код финансового инструмента). [N/A] используется, если symbol не определен
Пример: SOGN
Код режима торгов (Борд). Для биржи ITS всегда ITS
Пример: ITS
Количество
Пример: 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": "SOGN",
"board": "ITS",
"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"
}
Параметры тела ответа
buy— Купляsell— Продажа
data
object
Блок данных от информационного канала
Уникальный идентификатор
Пример: 9328828503
Тикер (Код финансового инструмента). [N/A] используется, если symbol не определен
Пример: SOGN
Код режима торгов (Борд). Для биржи ITS всегда ITS
Пример: ITS
Количество
Пример: 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!