Текущие позиции по торговым инструментам и деньгам
Приватный ресурс
Запрос нельзя выполнить анонимно. Обязательный параметр token
должен содержать актуальный Access токен.
Альтернативная команда
Для этой операции есть альтернатива в виде HTTP-запроса.
Запрос создаёт подписку на информацию о наличии и свойствах позиций финансовых и валютных инструментов в указанном портфеле.
Запрос
Для создания подписки на информационный канал отправьте в установленное WebSocket-соединение сообщение с телом запроса, содержащим детали создаваемой подписки.
- Тело запроса
- Схема
{
"opcode": "PositionsGetAndSubscribeV2",
"exchange": "MOEX",
"portfolio": "D39004",
"skipHistory": 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
— СПБ Биржаtrue
— отображать только новые данныеfalse
— отображать в том числе данные из историиSimple
— оригинальный формат данных. Поддерживает устаревшие параметры для обеспечения обратной совместимостиSlim
— облегчённый формат данных для быстрой передачи сообщений. Не поддерживает устаревшие параметрыHeavy
— полный формат данных, развивающийся и дополняющийся новыми полями. Не поддерживает устаревшие параметры
Код выполняемой операции:
Биржа:
Пример: MOEX
Идентификатор клиентского портфеля
Пример: D39004
Флаг отсеивания исторических данных:
Пример: false
Формат возвращаемого сервером JSON-объекта:
От формата объекта также зависит минимальное значение параметра frequency
для WebSocket-подписок.
Пример: Simple
Уникальный идентификатор запроса. Все ответные сообщения будут иметь такое же значение поля guid
Пример: c328fcf1-e495-408a-a0ed-e20f95d6b813
Access Токен для авторизации запроса
Пример: eyJhbGciOiJ...
Ответы
Содержимое ответа, возвращаемого в WebSocket-соединение, зависит от результатов обработки запроса:
- Если запрос обработан успешно, сервер передаст в ответ одно сообщение с кодом
200
, подтверждающее создание подписки, после чего начнёт передачу сообщений с кодом100
, содержащих запрошенную в рамках подписки информацию. - Если обработка запроса завершилась неудачей, сервер передаст в ответ одно сообщение с кодом ошибки, соответствующим причине отказа, после чего закроет WebSocket-соединение.
Сообщения
- 100
- 200
- 401
Сообщения от канала, содержащие в себе информацию, запрошенную в рамках подписки
- Формат Simple
- Формат Slim
- Формат Heavy
- Тело ответа
- Схема
{
"data": {
"volume": 549.198,
"currentVolume": 555.24,
"symbol": "APTK",
"brokerSymbol": "MOEX:APTK",
"portfolio": "D00013",
"exchange": "MOEX",
"avgPrice": 9.1533,
"qtyUnits": 60,
"openUnits": 60,
"lotSize": 10,
"shortName": "Аптеки36и6",
"qtyT0": 60,
"qtyT1": 60,
"qtyT2": 60,
"qtyTFuture": 60,
"qtyT0Batch": 6,
"qtyT1Batch": 6,
"qtyT2Batch": 6,
"qtyTFutureBatch": 6,
"qtyBatch": 6,
"openQtyBatch": 6,
"qty": 6,
"open": 6,
"dailyUnrealisedPl": 1.92,
"unrealisedPl": 7.962,
"isCurrency": false,
"existing": true
},
"guid": "c328fcf1-e495-408a-a0ed-e20f95d6b813"
}
Параметры тела ответа
MOEX
— Московская БиржаSPBX
— СПБ Биржа
data
object
Блок данных от информационного канала
Объём позиции в валюте расчётов, определённый по средней цене лота (avgPrice
|pxavg
)
Пример: 1702.10
Объём позиции в валюте расчётов, определённый по текущей цене лота
Пример: 1603.20
Тикер (Код финансового инструмента)
Пример: SBER
Пара Биржа:Тикер
Пример: MOEX:ALRS-3.24
Идентификатор клиентского портфеля
Пример: D39004
Биржа:
Пример: MOEX
Средняя цена
Пример: 170.21
Количество (штуки)
Пример: 1
Количество открытых позиций на момент открытия (начала торгов)
Пример: 0
Размер лота
Пример: 10
Короткое наименование
Пример: ГАЗПРОМ ао
Агрегированное количество T0 (штуки)
Пример: 0
Агрегированное количество T1 (штуки)
Пример: 10
Агрегированное количество T2 (штуки)
Пример: 10
Количество (штуки)
Пример: 10
Агрегированное количество T0 (лоты)
Пример: 0
Агрегированное количество T1 (лоты)
Пример: 1
Агрегированное количество T2 (лоты)
Пример: 1
Агрегированное количество TFuture (лоты)
Пример: 1
Агрегированное количество TFuture (лоты)
Пример: 1
Агрегированное количество на момент открытия (начала торгов) (лоты)
Пример: 0
Агрегированное количество (штуки)
Пример: 1
Агрегированное количество на момент открытия (начала торгов) (штуки)
Пример: 0
Дневная неисполненная прибыль или убыток по открытым позициям в валюте расчётов. Отображает разницу между ценой позиции на момент открытия текущей торговой сессии и её текущей ценой
Пример: 1.92
Суммарная неисполненаня прибыль или убыток по открытым позициям в валюте расчётов. Отображает разницу между ценой позиции в момент открытия и её текущей ценой
Пример: 7.962
True
для валютных остатков (денег), false
— для торговых инструментов
Пример: false
True
— для данных из снепшота, то есть из истории. False
— для новых событий
Пример: false
Уникальный идентификатор запроса. Все ответные сообщения будут иметь такое же значение поля guid
Пример: c328fcf1-e495-408a-a0ed-e20f95d6b813
- Тело ответа
- Схема
{
"data": {
"v": 549.198,
"cv": 555.24,
"sym": "APTK",
"tic": "MOEX:APTK",
"p": "D00013",
"ex": "MOEX",
"pxavg": 9.1533,
"q": 60,
"o": 60,
"lot": 10,
"n": "Аптеки36и6",
"q0": 60,
"q1": 60,
"q2": 60,
"qf": 60,
"upd": 1.92,
"up": 7.962,
"cur": false,
"h": true
},
"guid": "c328fcf1-e495-408a-a0ed-e20f95d6b813"
}
Параметры тела ответа
MOEX
— Московская БиржаSPBX
— СПБ Биржа
data
object
Блок данных от информационного канала
Объём позиции в валюте расчётов, определённый по средней цене лота (avgPrice
|pxavg
)
Пример: 1702.10
Объём позиции в валюте расчётов, определённый по текущей цене лота
Пример: 1603.20
Тикер (Код финансового инструмента)
Пример: SBER
Пара Биржа:Тикер
Пример: MOEX:ALRS-3.24
Идентификатор клиентского портфеля
Пример: D39004
Биржа:
Пример: MOEX
Средняя цена
Пример: 170.21
Количество (штуки)
Пример: 1
Количество открытых позиций на момент открытия (начала торгов)
Пример: 0
Размер лота
Пример: 10
Короткое наименование
Пример: ГАЗПРОМ ао
Агрегированное количество T0 (штуки)
Пример: 0
Агрегированное количество T1 (штуки)
Пример: 10
Агрегированное количество T2 (штуки)
Пример: 10
Количество (штуки)
Пример: 10
Дневная неисполненная прибыль или убыток по открытым позициям в валюте расчётов. Отображает разницу между ценой позиции на момент открытия текущей торговой сессии и её текущей ценой
Пример: 1.92
Суммарная неисполненаня прибыль или убыток по открытым позициям в валюте расчётов. Отображает разницу между ценой позиции в момент открытия и её текущей ценой
Пример: 7.962
True
для валютных остатков (денег), false
— для торговых инструментов
Пример: false
True
— для данных из снепшота, то есть из истории. False
— для новых событий
Пример: false
Уникальный идентификатор запроса. Все ответные сообщения будут иметь такое же значение поля guid
Пример: c328fcf1-e495-408a-a0ed-e20f95d6b813
- Тело ответа
- Схема
{
"data": {
"volume": 549.198,
"currentVolume": 555.24,
"symbol": "APTK",
"brokerSymbol": "MOEX:APTK",
"portfolio": "D00013",
"exchange": "MOEX",
"avgPrice": 9.1533,
"qtyUnits": 60,
"openUnits": 60,
"lotSize": 10,
"shortName": "Аптеки36и6",
"qtyT0": 60,
"qtyT1": 60,
"qtyT2": 60,
"qtyTFuture": 60,
"qtyT0Batch": 6,
"qtyT1Batch": 6,
"qtyT2Batch": 6,
"qtyTFutureBatch": 6,
"openQtyBatch": 6,
"dailyUnrealisedPl": 1.92,
"unrealisedPl": 7.962,
"isCurrency": false,
"existing": true
},
"guid": "c328fcf1-e495-408a-a0ed-e20f95d6b813"
}
Параметры тела ответа
MOEX
— Московская БиржаSPBX
— СПБ Биржа
data
object
Блок данных от информационного канала
Объём позиции в валюте расчётов, определённый по средней цене лота (avgPrice
|pxavg
)
Пример: 1702.10
Объём позиции в валюте расчётов, определённый по текущей цене лота
Пример: 1603.20
Тикер (Код финансового инструмента)
Пример: SBER
Пара Биржа:Тикер
Пример: MOEX:ALRS-3.24
Идентификатор клиентского портфеля
Пример: D39004
Биржа:
Пример: MOEX
Средняя цена
Пример: 170.21
Количество (штуки)
Пример: 1
Количество открытых позиций на момент открытия (начала торгов)
Пример: 0
Размер лота
Пример: 10
Короткое наименование
Пример: ГАЗПРОМ ао
Агрегированное количество T0 (штуки)
Пример: 0
Агрегированное количество T1 (штуки)
Пример: 10
Агрегированное количество T2 (штуки)
Пример: 10
Количество (штуки)
Пример: 10
Агрегированное количество T0 (лоты)
Пример: 0
Агрегированное количество T1 (лоты)
Пример: 1
Агрегированное количество T2 (лоты)
Пример: 1
Агрегированное количество TFuture (лоты)
Пример: 1
Агрегированное количество на момент открытия (начала торгов) (лоты)
Пример: 0
Дневная неисполненная прибыль или убыток по открытым позициям в валюте расчётов. Отображает разницу между ценой позиции на момент открытия текущей торговой сессии и её текущей ценой
Пример: 1.92
Суммарная неисполненаня прибыль или убыток по открытым позициям в валюте расчётов. Отображает разницу между ценой позиции в момент открытия и её текущей ценой
Пример: 7.962
True
для валютных остатков (денег), false
— для торговых инструментов
Пример: false
True
— для данных из снепшота, то есть из истории. False
— для новых событий
Пример: false
Уникальный идентификатор запроса. Все ответные сообщения будут иметь такое же значение поля 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!