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

Биржевой стакан

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

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

Альтернативная команда

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

Запрос создаёт подписку на получение информации о текущем количестве лотов и их цене в бидах и асках биржевого стакана для указанного финансового инструмента.

Запрос​

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

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

Ответы​

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

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

Сообщения

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

{
  "data": {
    "snapshot": true,
    "bids": [
      {
        "price": 257.70,
        "volume": 157
      }
    ],
    "asks": [
      {
        "price": 257.71,
        "volume": 288
      }
    ],
    "timestamp": 1702631123,
    "ms_timestamp": 1702631123780,
    "existing": true
  },
  "guid": "c328fcf1-e495-408a-a0ed-e20f95d6b813"
}