Котировки
Приватный ресурс
Запрос нельзя выполнить анонимно. Обязательный параметр token должен содержать актуальный Access токен.
Альтернативная команда
Для этой операции есть альтернатива в виде HTTP-запроса.
Запрос создаёт подписку на получение информации о котировках для выбранного финансового инструмента на указанной бирже.
Запрос
Для создания подписки на информационный канал отправьте в установленное WebSocket-соединение сообщение с телом запроса, содержащим детали создаваемой подписки.
- Тело запроса
- Схема
{
"opcode": "QuotesSubscribe",
"exchange": "MOEX",
"code": "SBER",
"instrumentGroup": "TQBR",
"format": "Simple",
"frequency": 250,
"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— полный формат данных, развивающийся и дополняющийся новыми полями. Не поддерживает устаревшие параметрыSimple— 25 миллисекундSlim— 10 миллисекундHeavy— 500 миллисекунд
Код выполняемой операции:
Биржа:
Пример: MOEX
Тикер (Код финансового инструмента)
Пример: SBER
Код режима торгов (Борд):
Пример: TQBR
Формат возвращаемого сервером JSON-объекта:
От формата объекта также зависит минимальное значение параметра frequency для WebSocket-подписок.
Пример: Simple
Частота (интервал) передачи данных сервером. Сервер вернёт последние данные по запросу за тот временной интервал, который указан в качестве значения параметра. Пример: биржа передаёт данные каждые 2 мс, но, при значении параметра 10 мс, сервер вернёт только последнее значение, отбросив предыдущие.
Минимальное значение параметра зависит от выбранного формата возвращаемого JSON-объекта:
Пример: 100
Уникальный идентификатор запроса. Все ответные сообщения будут иметь такое же значение поля guid
Пример: c328fcf1-e495-408a-a0ed-e20f95d6b813
Access Токен для авторизации запроса
Пример: eyJhbGciOiJ...
Ответы
Содержимое ответа, возвращаемого в WebSocket-соединение, зависит от результатов обработки запроса:
- Если запрос обработан успешно, сервер передаст в ответ одно сообщение с кодом
200, подтверждающее создание подписки, после чего начнёт передачу сообщений с кодом100, содержащих запрошенную в рамках подписки информацию. - Если обработка запроса завершилась неудачей, сервер передаст в ответ одно сообщение с кодом ошибки, соответствующим причине отказа, после чего закроет WebSocket-соединение.
Сообщения
- 100
- 200
- 401
Сообщения от канала, содержащие в себе информацию, запрошенную в рамках подписки
- Формат Simple
- Формат Slim
- Формат Heavy
- Тело ответа
- Схема
{
"data": {
"symbol": "SBER",
"exchange": "MOEX",
"description": "Сбербанк России ПАО ао",
"prev_close_price": 271.74,
"last_price": 272,
"last_price_timestamp": 1703844426,
"high_price": 272.59,
"low_price": 271.48,
"accruedInt": 0,
"volume": 5614360,
"open_interest": null,
"ask": 272,
"bid": 271.99,
"ask_vol": 4097,
"bid_vol": 237,
"ob_ms_timestamp": null,
"open_price": 272.19,
"yield": null,
"lotsize": 10,
"lotvalue": 2720,
"facevalue": 3,
"type": "CS",
"total_bid_vol": 328865,
"total_ask_vol": 543594,
"accrued_interest": 0,
"change": 0.26,
"change_percent": 0.10
},
"guid": "c328fcf1-e495-408a-a0ed-e20f95d6b813"
}
Параметры тела ответа
MOEX— Московская БиржаSPBX— СПБ Биржа- Для фондового рынка — номинальная стоимость единицы финансового инструмента
- Для срочного рынка — размер одного лота
- Для валютного рынка — количество валюты лота, за которое указывается цена в котировках
FOR— ВалютаCS— Обыкновенные акции компанииPS— Привилегированные акции компанииMF— Паевой инвестиционный фондRDR— Российская депозитарная распискаEUSOV— Облигация федерального займаMUNI— Муниципальная облигацияCORP— Корпоративная облигацияФьючерсный контракт X— Фьючерсный контракт с указанием базового активаМарж. амер. Call X— Опцион с указанием основных параметров контракта
data
object
Блок данных от информационного канала
Тикер (Код финансового инструмента)
Пример: SBER
Биржа:
Пример: MOEX
Короткое описание на русском языке
Пример: Сбербанк России ПАО ао
Цена предыдущего закрытия
Пример: 271.74
Последняя цена
Пример: 272
UTC-timestamp для значения поля last_price
Пример: 1703844426
Максимальная цена
Пример: 279.96
Минимальная цена
Пример: 228.78
Начислено (НКД)
Пример: 0
Объём
Пример: 1960
Открытый интерес (open interest). Если не поддерживается инструментом — значение 0 или null
Пример: 0
Цена лота в ближайшем аске
Пример: 272
Цена лота в ближайшем биде
Пример: 271.99
Количество лотов в ближайшем аске в стакане по данным с биржи
Пример: 4097
Количество лотов в ближайшем биде в стакане по данным с биржи
Пример: 237
Временная метка (UTC) сообщения о состоянии биржевого стакана в формате Unix Time Milliseconds
Пример: null
Цена при открытии
Пример: 192.18
Доходность, рассчитанная по цене сделки
Пример: null
Размер лота
Пример: 10
Суммарная стоимость лота
Пример: 2720
Показатель, значение которого варьируется в зависимости от выбранного рынка:
Пример: 3
Тип финансового инструмента.
Возможные значения для MOEX:
От SPBX возвращается только тип t, присваиваемый всем доступным инструментам.
Пример: CS
Суммарное количество лотов во всех бидах в биржевом стакане
Пример: 328865
Суммарное количество лотов во всех асках в биржевом стакане
Пример: 543594
Начислено (НКД)
Пример: 0
Разность цены и цены предыдущего закрытия
Пример: 0.26
Относительное изменение цены
Пример: 0.10
Уникальный идентификатор запроса. Все ответные сообщения будут иметь такое же значение поля guid
Пример: c328fcf1-e495-408a-a0ed-e20f95d6b813
- Тело ответа
- Схема
{
"data": {
"sym": "SBER",
"ex": "MOEX",
"desc": "Сбербанк России ПАО ао",
"tst": 1703844426,
"tso": null,
"o": 272.19,
"h": 272.59,
"l": 271.48,
"c": 272,
"v": 5614360,
"acci": 0,
"oi": null,
"y": null,
"ask": 272,
"bid": 271.99,
"av": 4097,
"bv": 237,
"tbv": 328865,
"tav": 543594,
"lot": 10,
"lotv": 2720,
"fv": 3,
"t": "CS"
},
"guid": "c328fcf1-e495-408a-a0ed-e20f95d6b813"
}
Параметры тела ответа
MOEX— Московская БиржаSPBX— СПБ Биржа- Для фондового рынка — номинальная стоимость единицы финансового инструмента
- Для срочного рынка — размер одного лота
- Для валютного рынка — количество валюты лота, за которое указывается цена в котировках
FOR— ВалютаCS— Обыкновенные акции компанииPS— Привилегированные акции компанииMF— Паевой инвестиционный фондRDR— Российская депозитарная распискаEUSOV— Облигация федерального займаMUNI— Муниципальная облигацияCORP— Корпоративная облигацияФьючерсный контракт X— Фьючерсный контракт с указанием базового активаМарж. амер. Call X— Опцион с указанием основных параметров контракта
data
object
Блок данных от информационного канала
Тикер (Код финансового инструмента)
Пример: SBER
Биржа:
Пример: MOEX
Короткое описание на русском языке
Пример: Сбербанк России ПАО ао
UTC-timestamp для значения поля last_price
Пример: 1703844426
Временная метка (UTC) сообщения о состоянии биржевого стакана в формате Unix Time Milliseconds
Пример: null
Цена при открытии
Пример: 192.18
Максимальная цена
Пример: 279.96
Минимальная цена
Пример: 228.78
Последняя цена
Пример: 272
Объём
Пример: 1960
Начислено (НКД)
Пример: 0
Открытый интерес (open interest). Если не поддерживается инструментом — значение 0 или null
Пример: 0
Доходность, рассчитанная по цене сделки
Пример: null
Цена лота в ближайшем аске
Пример: 272
Цена лота в ближайшем биде
Пример: 271.99
Количество лотов в ближайшем аске в стакане по данным с биржи
Пример: 4097
Количество лотов в ближайшем биде в стакане по данным с биржи
Пример: 237
Суммарное количество лотов во всех бидах в биржевом стакане
Пример: 328865
Суммарное количество лотов во всех асках в биржевом стакане
Пример: 543594
Размер лота
Пример: 10
Суммарная стоимость лота
Пример: 2720
Показатель, значение которого варьируется в зависимости от выбранного рынка:
Пример: 3
Тип финансового инструмента.
Возможные значения для MOEX:
От SPBX возвращается только тип t, присваиваемый всем доступным инструментам.
Пример: CS
Уникальный идентификатор запроса. Все ответные сообщения будут иметь такое же значение поля guid
Пример: c328fcf1-e495-408a-a0ed-e20f95d6b813
- Тело ответа
- Схема
{
"data": {
"symbol": "SBER",
"exchange": "MOEX",
"description": "Сбербанк России ПАО ао",
"currency": "RUB",
"prevClosePrice": 271.74,
"lastPrice": 272,
"lastPriceTimestamp": 1703844426,
"highPrice": 272.59,
"lowPrice": 271.48,
"accruedInterest": 0,
"volume": 5614360,
"openInterest": null,
"ask": 272,
"bid": 271.99,
"askVol": 4097,
"bidVol": 237,
"obMsTimestamp": null,
"openPrice": 272.19,
"yield": null,
"lotSize": 10,
"lotValue": 2720,
"faceValue": 3,
"type": "CS",
"totalBidVol": 328865,
"totalAskVol": 543594,
"change": 0.26,
"changePercent": 0.10
},
"guid": "c328fcf1-e495-408a-a0ed-e20f95d6b813"
}
Параметры тела ответа
MOEX— Московская БиржаSPBX— СПБ Биржа- Для фондового рынка — номинальная стоимость единицы финансового инструмента
- Для срочного рынка — размер одного лота
- Для валютного рынка — количество валюты лота, за которое указывается цена в котировках
FOR— ВалютаCS— Обыкновенные акции компанииPS— Привилегированные акции компанииMF— Паевой инвестиционный фондRDR— Российская депозитарная распискаEUSOV— Облигация федерального займаMUNI— Муниципальная облигацияCORP— Корпоративная облигацияФьючерсный контракт X— Фьючерсный контракт с указанием базового активаМарж. амер. Call X— Опцион с указанием основных параметров контракта
data
object
Блок данных от информационного канала
Тикер (Код финансового инструмента)
Пример: SBER
Биржа:
Пример: MOEX
Короткое описание на русском языке
Пример: Сбербанк России ПАО ао
Валюта расчетов
Пример: RUB
Цена предыдущего закрытия
Пример: 271.74
Последняя цена
Пример: 272
UTC-timestamp для значения поля last_price
Пример: 1703844426
Максимальная цена
Пример: 279.96
Минимальная цена
Пример: 228.78
Начислено (НКД)
Пример: 0
Объём
Пример: 1960
Открытый интерес (open interest). Если не поддерживается инструментом — значение 0 или null
Пример: 0
Цена лота в ближайшем аске
Пример: 272
Цена лота в ближайшем биде
Пример: 271.99
Количество лотов в ближайшем аске в стакане по данным с биржи
Пример: 4097
Количество лотов в ближайшем биде в стакане по данным с биржи
Пример: 237
Временная метка (UTC) сообщения о состоянии биржевого стакана в формате Unix Time Milliseconds
Пример: null
Цена при открытии
Пример: 192.18
Доходность, рассчитанная по цене сделки
Пример: null
Размер лота
Пример: 10
Суммарная стоимость лота
Пример: 2720
Показатель, значение которого варьируется в зависимости от выбранного рынка:
Пример: 3
Тип финансового инструмента.
Возможные значения для MOEX:
От SPBX возвращается только тип t, присваиваемый всем доступным инструментам.
Пример: CS
Суммарное количество лотов во всех бидах в биржевом стакане
Пример: 328865
Суммарное количество лотов во всех асках в биржевом стакане
Пример: 543594
Только срочный рынок. Цена предыдущего клиринга, установленная биржей по результатам предыдущих торгов
Пример: 4.145
Разность цены и цены предыдущего закрытия
Пример: 0.26
Относительное изменение цены
Пример: 0.10
Уникальный идентификатор запроса. Все ответные сообщения будут иметь такое же значение поля 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!