Heartbeat

Definizione

Un heartbeat di WebSocket è un messaggio periodico inviato su una connessione WebSocket per confermare che la connessione è ancora attiva. Sul WebSocket di mercato di Polymarket, il server si aspetta un PING ogni 10 secondi; l'assenza di heartbeat può indurre il server o intermediari a chiudere la connessione.

In contesto

Quando ti iscrivi al feed di mercato di Polymarket (wss://ws-subscriptions-clob.polymarket.com/ws/market), il ciclo di vita della connessione dipende da heartbeat regolari. Il server emette eventi di mercato (best_bid_ask, last_trade_price, price_change, tick_size_change) e si aspetta un PING a intervalli di circa 10 secondi per evitare timeout. Le implementazioni dovrebbero sia rispondere ai frame PING/PONG in arrivo sia inviare PING periodici dal lato client se il trasporto o un intermediario potrebbero chiudere socket inattivi.

Note pratiche

• Usa un timer leggermente inferiore a 10 secondi (per esempio 9–10 secondi) per tollerare jitter di rete e ritardi di elaborazione.
• Gestisci heartbeat mancati tentando una riconnessione pulita e riescrivendoti agli strumenti. La logica di riconnessione dovrebbe includere backoff per evitare thundering herds.
• Rispetta il limite di 500 strumenti per connessione quando ti riscrivi; il WebSocket respingerà richieste di sottoscrizione sovradimensionate.

Vedi anche

• /glossary/market-channel