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

Собственная книга ордеров (стакан)

Цель: Использовать необработанные данные книги ордеров (стакана цен) из API xRocket для создания собственной визуализации в режиме реального времени вне стандартного интерфейса.

Ключевые используемые функции API xRocket:

  • Публичный метод: GET /api/v1/orderbook (для первоначальной загрузки).
  • WebSocket API: для обновлений в реальном времени.
Внимание

Дельта-обновления книги ордеров являются инкрементальными. Если ваше WebSocket-соединение разрывается и переподключается, необходимо повторно загрузить полный снимок книги ордеров через REST-эндпоинт перед применением новых дельт, иначе ваше локальное состояние будет рассинхронизировано.

Порядок работы:

  1. Начальная загрузка: Клиентское приложение делает первоначальный GET-запрос к эндпоинту книги ордеров для нужного символа (TON-USDT), чтобы заполнить начальное отображение данных.
  2. Соединение WebSocket: Приложение открывает WebSocket-соединение с потоковым эндпоинтом xRocket.
  3. Обновления в реальном времени: Приложение подписывается на канал книги ордеров для TON-USDT. Оно постоянно получает дельта-обновления (изменения отдельных ордеров на покупку/продажу).
  4. Обновление визуализации: Приложение обрабатывает дельты в реальном времени, обновляя визуализацию (например, график или таблицу), без необходимости перезагружать весь набор данных, что обеспечивает плавный пользовательский опыт.
подсказка

Когда дельта-обновление содержит количество 0 для ценового уровня, этот уровень полностью исполнен и должен быть удален из вашей локальной книги ордеров.