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

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

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

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

HTTP API

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

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

Запрос​

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

{
  "opcode": "InstrumentsGetAndSubscribeV2",
  "code": "SBER",
  "instrumentGroup": "TQBR",
  "exchange": "MOEX",
  "format": "Simple",
  "frequency": 100,
  "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.