Котировки
Запрос нельзя выполнить анонимно. Обязательный параметр token
должен содержать актуальный Access Токен.
Для этой операции есть альтернативный HTTP-запрос.
Запрос создаёт подписку на получение информации о котировках для выбранного финансового инструмента на указанной бирже.
Запрос
Для создания подписки на информационный канал отправьте в установленное WebSocket-соединение сообщение с телом запроса, содержащим детали создаваемой подписки.
- Тело запроса
- Схема
{
"opcode": "QuotesSubscribe",
"code": "SBER",
"exchange": "MOEX",
"instrumentGroup": "TQBR",
"format": "Simple",
"frequency": 100,
"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 миллисекунд
Код выполняемой операции:
Тикер (Код финансового инструмента)
Пример: SBER
Биржа:
Пример: MOEX
Код режима торгов (Борд):
Пример: 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
Максимальная цена
Пример: 272.59
Минимальная цена
Пример: 271.48
Начислено (НКД)
Пример: 0
Объём
Пример: 1960
Открытый интерес (open interest). Если не поддерживается инструментом — значение 0
или null
Пример: null
Цена лота в ближайшем аске
Пример: 272
Цена лота в ближайшем биде
Пример: 271.99
Количество лотов в ближайшем аске в стакане по данным с биржи
Пример: 4097
Количество лотов в ближайшем биде в стакане по данным с биржи
Пример: 237
Временная метка (UTC) сообщения о состоянии биржевого стакана в формате Unix Time Milliseconds
Пример: null
Цена открытия
Пример: 272.19
Доходность, рассчитанная по цене сделки
Пример: 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
Цена открытия
Пример: 272.19
Максимальная цена
Пример: 272.59
Минимальная цена
Пример: 271.48
Последняя цена
Пример: 272
Объём
Пример: 1960
Начислено (НКД)
Пример: 0
Открытый интерес (open interest). Если не поддерживается инструментом — значение 0
или null
Пример: null
Доходность, рассчитанная по цене сделки
Пример: 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
Максимальная цена
Пример: 272.59
Минимальная цена
Пример: 271.48
Начислено (НКД)
Пример: 0
Объём
Пример: 1960
Открытый интерес (open interest). Если не поддерживается инструментом — значение 0
или null
Пример: null
Цена лота в ближайшем аске
Пример: 272
Цена лота в ближайшем биде
Пример: 271.99
Количество лотов в ближайшем аске в стакане по данным с биржи
Пример: 4097
Количество лотов в ближайшем биде в стакане по данным с биржи
Пример: 237
Временная метка (UTC) сообщения о состоянии биржевого стакана в формате Unix Time Milliseconds
Пример: null
Цена открытия
Пример: 272.19
Доходность, рассчитанная по цене сделки
Пример: null
Размер лота
Пример: 10
Суммарная стоимость лота
Пример: 2720
Показатель, значение которого варьируется в зависимости от выбранного рынка:
Пример: 3
Тип финансового инструмента.
Возможные значения для MOEX:
От SPBX возвращается только тип t
, присваиваемый всем доступным инструментам.
Пример: CS
Суммарное количество лотов во всех бидах в биржевом стакане
Пример: 328865
Суммарное количество лотов во всех асках в биржевом стакане
Пример: 543594
Разность цены и цены предыдущего закрытия
Пример: 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!