Polymarket reemplazó RTDS: migrar a PolyBolt

Si tu bot recibe precios spot por streaming para decidir algo (y en los mercados cripto Up/Down la mayoría lo hacen), esto te afecta. Cambiaron seis cosas a la vez, y lo incómodo es que varias fallan en silencio: sigues conectado, solo que dejas de recibir los precios que crees estar recibiendo.

Los seis cambios incompatibles

Mapeo de canales

Conexión

Primero autentícate en la conexión abierta, espera la confirmación y después suscríbete. Los canales de precios de referencia rechazan las suscripciones sin autenticar.

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

Esas credenciales son las mismas que derivas para operar en el CLOB: key, secret y passphrase juntos. Si nunca las has creado, la guía de endpoints explica el flujo L1/L2.

Tres cosas que PolyBolt te da y RTDS no

• Un snapshot en cada suscripción. Cada suscripción devuelve los dos minutos anteriores de precios con snapshot: true, posiblemente vacío. Inicializa tu estado local con él y luego aplica las actualizaciones en vivo. Con RTDS, un símbolo sin actividad solo te daba silencio y no tenías forma de saber si estabas conectado o simplemente entre ticks.
• Un seq denso y un contador dropped. Por fin puedes detectar huecos. RTDS no tenía secuencia, así que un mensaje perdido era invisible. Sigue seq por canal y trata cualquier salto como motivo para resincronizar.
• Códigos de cierre tipados en lugar del 1006 sin más: 4001 autenticación, 4002 consumidor lento, 4003 drenando, 4008 política. Un 4002 significa que tú eres demasiado lento vaciando el socket: es un bug del consumidor, no un problema de red, y reconectar no lo arreglará.

Límites de conexión

RTDS no publicaba ninguno. PolyBolt sí, y superar cualquiera de ellos cierra el socket con 4008:

Las 64 suscripciones son el límite con el que hay que planificar. Si sigues BTC, ETH y SOL en spot y TWAP, son seis, así que hay margen de sobra para un bot cripto; pero un sistema que se abra a todo el catálogo de acciones lo alcanzará.

Migrar un bot, en orden

1. Deriva credenciales de la API CLOB si no las tienes. RTDS era público; PolyBolt no. Este es el paso que bloquea todo lo demás.
2. Cambia la URL a wss://ws-live-v2.polymarket.com/ws.
3. Elimina el heartbeat del cliente. El bucle de PING cada 5 segundos no solo es innecesario: ahora es ruido. El servidor te hace ping cada 25 segundos.
4. Reescribe los frames de suscripción: action → op, topic → channel, y filter pasa a ser un objeto JSON en lugar de un string.
5. Corrige todos los símbolos: btcusdt y btc/usd pasan a ser btcusd. En minúsculas, USD.
6. Gestiona el frame de snapshot para no tratar dos minutos de relleno histórico como ticks en vivo.
7. Añade detección de huecos con seq y resincroniza cuando haya un salto.
8. Recalibra todo lo ajustado a los precios de Binance. Ahora la fuente es Pyth.

Lo que esto no cambia

Conviene ser preciso, porque es fácil migrar de más. Los canales market y user del CLOB no se tocan. wss://ws-subscriptions-clob.polymarket.com/ws/market sigue transmitiendo las actualizaciones del libro de órdenes y de precios, sigue pidiendo un PING del cliente cada 10 segundos y sigue ocultando best_bid_ask, new_market y market_resolved tras custom_feature_enabled. Solo se movieron los precios de referencia. Detalles en la guía de WebSocket.

Y la limitación de fondo tampoco cambia: un stream te da precios desde el momento en que te conectas. No puede decirte cómo estaba el libro el martes pasado. Polymarket devuelve 404 para el libro de un mercado resuelto y solo conserva aproximadamente un punto por minuto del historial de precios, por eso el backtesting necesita un archivo grabado mientras los mercados estaban activos. Consulta cómo funcionan los mercados Up/Down o busca un mercado concreto en la búsqueda de mercados.