Heartbeat

Définition

Un WebSocket heartbeat est un message périodique envoyé via une connexion WebSocket pour confirmer que la connexion est toujours active. Sur le market WebSocket de Polymarket, le serveur attend un PING toutes les 10 secondes ; l'absence de heartbeats peut amener le serveur ou des intermédiaires à fermer la connexion.

Contexte

Lorsque vous vous abonnez au flux market de Polymarket (wss://ws-subscriptions-clob.polymarket.com/ws/market), le cycle de vie de la connexion dépend des heartbeats réguliers. Le serveur émet des events market (best_bid_ask, last_trade_price, price_change, tick_size_change) et attend un PING à intervalles d'environ 10 secondes pour éviter les timeouts. Les implémentations doivent à la fois répondre aux trames PING/PONG entrantes et envoyer périodiquement des PING côté client si le transport ou un intermédiaire risque de fermer des sockets inactifs.

Notes pratiques

• Utilisez un minuteur légèrement inférieur à 10 secondes (par exemple, 9–10 secondes) pour tolérer la gigue réseau et les délais de traitement.
• Gérez les heartbeats manquants en tentant une reconnexion propre et en vous réabonnant à vos instruments. La logique de reconnexion doit inclure un backoff pour éviter les effets de masse (thundering herds).
• Respectez la limite de 500 instruments par connexion lors du réabonnement ; le WebSocket rejettera les requêtes d'abonnement surdimensionnées.

Voir aussi

• /glossary/market-channel