Перейти к основному содержимому

Изменения информации о финансовых инструментах

Приватный ресурс

Запрос нельзя выполнить анонимно. Обязательный параметр token должен содержать актуальный Access Токен.

HTTP API

Для этой операции есть альтернативный HTTP-запрос.

Подписка на изменение информации о финансовых инструментах на выбранной бирже.

Запрос​

Для создания подписки на информационный канал отправьте в установленное WebSocket-соединение сообщение с телом запроса, содержащим детали создаваемой подписки.

{
  "opcode": "InstrumentsGetAndSubscribeV2",
  "code": "SBER",
  "exchange": "MOEX",
  "instrumentGroup": "TQBR",
  "format": "Simple",
  "guid": "c328fcf1-e495-408a-a0ed-e20f95d6b813",
  "token": "eyJhbGciOiJ..."
}

Ответы​

Содержимое ответа, возвращаемого в WebSocket-соединение, зависит от результатов обработки запроса:

  • Если запрос обработан успешно, сервер передаст в ответ одно сообщение с кодом 200, подтверждающее создание подписки, после чего начнёт передачу сообщений с кодом 100, содержащих запрошенную в рамках подписки информацию.
  • Если обработка запроса завершилась неудачей, сервер передаст в ответ одно сообщение с кодом ошибки, соответствующим причине отказа, после чего закроет WebSocket-соединение.

Сообщения от канала, содержащие в себе информацию, запрошенную в рамках подписки

В первом ответе сервер возвращает полную информацию о выбранном инструменте.

{
  "data": {
    "symbol": "SBER",
    "exchange": "MOEX",
    "board": "TQBR",
    "tradingStatus": 17,
    "tradingStatusInfo": "нормальный период торгов",
    "priceMin": 228.78,
    "priceMax": 279.96
  },
  "guid": "c328fcf1-e495-408a-a0ed-e20f95d6b813"
}

Последующие сообщения содержат только те поля, значение которых изменилось.

{
  "data": {
    "symbol": "SBER",
    "priceMin": 228.78,
    "priceMax": 279.96
  },
  "guid": "c328fcf1-e495-408a-a0ed-e20f95d6b813"
}

Запросить текущее состояние по всем полям возможно через вызов группы /securities.