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

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

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

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

HTTP API

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

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

Запрос​

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

{
  "opcode": "OrderBookGetAndSubscribe",
  "code": "SBER",
  "depth": 10,
  "exchange": "MOEX",
  "format": "Simple",
  "frequency": 100,
  "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,
    "depth": 20,
    "existing": true
  },
  "guid": "c328fcf1-e495-408a-a0ed-e20f95d6b813"
}