A Polymarket substituiu o RTDS: migrando para o PolyBolt

Se o seu bot faz streaming de preços spot para decidir qualquer coisa — e nos mercados cripto Up/Down a maioria faz —, isso afeta você. Seis coisas mudaram de uma vez, e a parte chata é que várias delas falham em silêncio: você continua conectado, só para de receber os preços que acha que está recebendo.

As seis mudanças incompatíveis

Mapeamento de canais

Conectando

Autentique-se primeiro na conexão aberta, espere a confirmação e depois assine. Os canais de preços de referência rejeitam assinaturas não autenticadas.

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

Essas credenciais são as mesmas que você deriva para operar no CLOB — chave, secret e passphrase juntos. Se você nunca as criou, o guia de endpoints cobre o fluxo L1/L2.

Três coisas que o PolyBolt oferece e o RTDS não oferecia

• Um snapshot a cada assinatura. Cada assinatura retorna os dois minutos anteriores de preços com snapshot: true, possivelmente vazio. Inicialize o estado local a partir dele e depois aplique as atualizações ao vivo. No RTDS, um símbolo parado só dava silêncio, e você não fazia ideia se estava conectado ou apenas entre dois ticks.
• Um seq denso e um contador dropped. Finalmente dá para detectar lacunas. O RTDS não tinha sequência nenhuma, então uma mensagem perdida era invisível. Acompanhe o seq por canal e trate qualquer salto como gatilho de ressincronização.
• Códigos de fechamento tipados em vez do 1006 cru: 4001 autenticação, 4002 consumidor lento, 4003 drenando, 4008 política. Um 4002 significa que você está lento demais para drenar o socket — é um bug no consumidor, não um problema de rede, e reconectar não vai resolver.

Limites de conexão

O RTDS não publicava nenhum. O PolyBolt publica, e violar qualquer um deles fecha o socket com 4008:

As 64 assinaturas são o limite com que você precisa se planejar. Se você acompanha BTC, ETH e SOL em spot e TWAP, são seis, então sobra bastante folga para um bot cripto — mas um sistema que se espalha pelo catálogo de ações vai bater nele.

Migrando um bot, em ordem

1. Derive as credenciais da API CLOB, se você não as tem. O RTDS era público; o PolyBolt não é. Este é o passo que bloqueia todo o resto.
2. Troque a URL para wss://ws-live-v2.polymarket.com/ws.
3. Apague o heartbeat do cliente. O loop de PING a cada 5 segundos não só é desnecessário como agora é ruído. O servidor envia ping para você a cada 25 segundos.
4. Reescreva os frames de assinatura — action → op, topic → channel, e filter vira um objeto JSON em vez de uma string.
5. Corrija todos os símbolos: btcusdt e btc/usd viram btcusd. Minúsculas, USD.
6. Trate o frame de snapshot para não confundir dois minutos de histórico com ticks ao vivo.
7. Adicione detecção de lacunas no seq e ressincronize quando houver um salto.
8. Recalibre tudo o que foi ajustado com preços da Binance. A fonte agora é a Pyth.

O que isto não muda

Vale ser preciso, porque é fácil migrar demais. Os canais market e user do CLOB não foram alterados. wss://ws-subscriptions-clob.polymarket.com/ws/market continua transmitindo atualizações do livro de ofertas e de preços, continua exigindo um PING do cliente a cada 10 segundos e continua escondendo best_bid_ask, new_market e market_resolved atrás de custom_feature_enabled. Só os preços de referência mudaram. Detalhes no guia de WebSocket.

E a limitação mais profunda também não mudou: um stream dá a você preços a partir do momento em que você se conecta. Ele não consegue dizer como estava o livro na última terça-feira. A Polymarket retorna 404 para o livro de um mercado resolvido e guarda só cerca de um ponto por minuto de histórico de preços, e é por isso que o backtesting precisa de um arquivo gravado enquanto os mercados estavam ativos. Veja como funcionam os mercados Up/Down ou procure um mercado específico na busca de mercados.