WebSocket

Зв’язок, підписка та серцебиття

Підключайтеся до 6MM WebSocket потоків, підписуйтеся на теми, підтримуйте зв’язки живими та безпечно обробляйте конверти повідомлень.

View as Markdown

Використовуйте WebSocket потоки для ринкових даних та приватних оновлень стану користувачів, які мають залишатися актуальними без опитувань.

Зв’язок URL

wss://ws.6mm.com/ws

Приватні потоки потребують контексту автентифікації, такого як listenKey або токен доступу, як описано в документації приватного каналу.

Підписатися

1{ "id": "1772007814666", "op": "subscribe", "args": ["market.depth.BTCUSDT"] }

Успішне підтвердження підписки:

1{
2  "id": "1772007814666",
3  "event": "subscribe",
4  "success": true,
5  "data": ["market.depth.BTCUSDT"]
6}

Відписатися

1{ "id": "1772007814667", "op": "unsubscribe", "args": ["market.depth.BTCUSDT"] }

Пінг застосування

1{ "id": "1772007814668", "op": "ping", "args": [] }

Конверт повідомлення

Публічні просування використовують узгоджену оболонку:

1{
2  "topic": "market.depth.BTCUSDT",
3  "event": "data",
4  "ts": 1772007815000,
5  "data": {}
6}

Оперативні рекомендації

  • Генерувати унікальний клієнтський id для кожного запиту на підписку, відписку та пінг.
  • Розглядайте повторне підключення як нову сесію та повторно підписуйтеся на необхідні теми.
  • Перевірити, чи повернений topic відповідає каналу, який очікує ваш сервіс.
  • Підтримувати ідемпотентну обробку повідомлень, коли йдеться про приватні замовлення або події облікового запису.
  • Зміни стану з’єднання журналу, підтвердження підписки та аномальні відключення.

Робочий процес повторного підключення

  1. Закрийте або відкиньте попередній роз’єм і створіть нове з’єднання.
  2. Повторна автентифікація приватних потоків за допомогою дійсного listenKey або доступного токену.
  3. Підпишіться на всі необхідні теми і чекайте на успішні подяки.
  4. Замініть стан локальної книги замовлень на новий знімок перед поступовими оновленнями.
  5. Узгодити відкриті ордери, позиції та баланси через REST , якщо приватні події могли бути пропущені.

Використовуйте обмежене експоненціальне відключення з джиттером для спроб повторного підключення. Клієнт, що постійно підключається, повинен попереджати операторів замість безкінечних повторних спроб без видимості.

Серцебиття та застарілі зв’язки

  • Відстежувати останнє вхідне повідомлення та успішне підтвердження пінгу.
  • Використовуйте інтервал серцебиття та поріг очікування, дозволений для виробничого середовища.
  • Вважати з’єднання застарілим при перевищенні налаштованого порогу, навіть якщо роз’єм TCP все ще виглядає відкритим.
  • Не використовувати повторно підписки зі старого сокета; повторно підписуватися явно після кожного повторного підключення.