Polymarket ha sostituito RTDS: la migrazione a PolyBolt

Se il tuo bot riceve in streaming i prezzi spot per decidere qualcosa (e sui mercati crypto Up/Down quasi tutti lo fanno), la cosa ti riguarda. Sono cambiate sei cose insieme, e il problema è che diverse falliscono in silenzio: resti connesso, semplicemente smetti di ricevere i prezzi che credi di ricevere.

Le sei breaking change

Mappatura dei canali

Connessione

Prima autenticati sulla connessione aperta, attendi la conferma, poi fai subscribe. I canali dei prezzi di riferimento rifiutano le sottoscrizioni non autenticate.

{
  "op": "auth",
  "rid": "a1",
  "auth": {
    "apiKey": "<api key>",
    "secret": "<api secret>",
    "passphrase": "<api passphrase>"
  }
}

Sono le stesse credenziali che derivi per il trading sul CLOB: chiave, secret e passphrase insieme. Se non le hai mai create, la guida agli endpoint spiega il flusso L1/L2.

Tre cose che PolyBolt ti dà e RTDS no

• Uno snapshot a ogni subscribe. Ogni sottoscrizione restituisce i prezzi dei due minuti precedenti con snapshot: true, eventualmente vuoti. Inizializza lo stato locale da lì, poi applica gli aggiornamenti live. Con RTDS un simbolo poco attivo ti dava solo silenzio, e non avevi idea se fossi connesso o semplicemente tra un tick e l’altro.
• Un seq denso e un contatore dropped. Finalmente puoi rilevare i buchi. RTDS non aveva alcuna sequenza, quindi un messaggio perso era invisibile. Tieni traccia di seq per canale e tratta ogni salto come un segnale per risincronizzarti.
• Codici di chiusura tipizzati invece del semplice 1006: 4001 autenticazione, 4002 consumer lento, 4003 draining, 4008 policy. Un 4002 significa che sei tu troppo lento a svuotare il socket: è un bug del consumer, non un problema di rete, e riconnettersi non lo risolverà.

Limiti di connessione

RTDS non ne pubblicava nessuno. PolyBolt sì, e superarne uno qualsiasi chiude il socket con 4008:

Il limite di 64 sottoscrizioni è quello su cui pianificare. Se segui BTC, ETH e SOL su spot e TWAP sono sei, quindi c’è ampio margine per un bot crypto, ma un sistema che si estende a tutto il catalogo equity lo raggiungerà.

Migrare un bot, in ordine

1. Deriva le credenziali API del CLOB se non le hai. RTDS era pubblico; PolyBolt no. È il passo che blocca tutto il resto.
2. Cambia l’URL in wss://ws-live-v2.polymarket.com/ws.
3. Elimina l’heartbeat del client. Il loop di PING ogni 5 secondi non è solo inutile, ora è rumore. Il server ti manda un ping ogni 25 secondi.
4. Riscrivi i frame di subscribe: action → op, topic → channel, e filter diventa un oggetto JSON invece di una stringa.
5. Correggi ogni simbolo: btcusdt e btc/usd diventano entrambi btcusd. Minuscolo, USD.
6. Gestisci il frame di snapshot, così non tratti due minuti di backfill come tick live.
7. Aggiungi il rilevamento dei buchi su seq e risincronizzati in caso di salto.
8. Ricalibra tutto ciò che era tarato sui prezzi di Binance. Ora la fonte è Pyth.

Cosa non cambia

Vale la pena essere precisi, perché è facile migrare più del necessario. I canali market e user del CLOB non sono stati toccati. wss://ws-subscriptions-clob.polymarket.com/ws/market trasporta ancora gli aggiornamenti dell’order book e dei prezzi, vuole ancora un PING dal client ogni 10 secondi e nasconde ancora best_bid_ask, new_market e market_resolved dietro custom_feature_enabled. Si sono spostati solo i prezzi di riferimento. I dettagli sono nella guida ai WebSocket.

E anche il limite più profondo resta invariato: uno stream ti dà i prezzi dal momento in cui ti connetti. Non può dirti com’era il book martedì scorso. Polymarket restituisce 404 per il book di un mercato risolto e conserva solo circa un punto al minuto di storico dei prezzi, ed è per questo che il backtesting richiede un archivio registrato mentre i mercati erano attivi. Vedi come funzionano i mercati Up/Down o cerca un mercato specifico nella ricerca mercati.