Polymarket resolution explained

Polymarket resolution explained: esta guía recorre el ciclo de vida de extremo a extremo, desde el reporte hasta el canje de los tokens de resultado, la etapa de disputa optimista de UMA y las implicaciones prácticas para los traders. Aprenderás qué sucede on-chain y off-chain, qué pasos son gasless para los usuarios y los plazos y riesgos que importan para el arbitraje y la gestión de posiciones.

Puntos clave

• La resolución empieza con un reporte de resultado y puede entrar en un periodo de disputa optimista de UMA antes de la liquidación final.
• Aunque los tokens de resultado son activos CTF ERC-1155, split/merge/redeem y la colocación de órdenes son gasless para los usuarios gracias al Relayer.
• Disputas, retrasos del oráculo, fills parciales y tiempos de liquidación crean riesgos reales incluso cuando los precios implican una ventaja matemática.
• Conoce la secuencia: report → dispute window (UMA) → finalization → redeem winning tokens for pUSD.

Qué significa "resolución" en Polymarket

En Polymarket, la resolución es el proceso que convierte los tokens de resultado negociables en fondos canjeables. En mercados binarios y multi-outcome, un oráculo determina finalmente qué resultado(s) resuelven como YES. Cuando un resultado es definitivo, cada token ganador puede canjearse por $1.00 de pUSD; los tokens perdedores no tienen valor.

Los mercados usan el Gnosis Conditional Token Framework (CTF) para los tokens de resultado. Esos tokens se comportan como cualquier tenencia ERC-1155: puedes negociarlos en el CLOB, transferirlos o combinarlos con operaciones de split/merge. La diferencia clave en la resolución es que el reporte final del oráculo desbloquea el flujo de redeem del CTF que convierte los tokens ganadores en pUSD.

El paso de reporte: quién reporta y por qué importa

La resolución comienza cuando un reporter envía un resultado al sistema de oráculo. Polymarket utiliza el oráculo optimista UMA para el reporte. Un reporte nombrará el resultado que el reporter considera correcto y pone en marcha el temporizador para la siguiente etapa.

Por qué esto importa:

• El reporte es la primera señal pública de que el evento del mercado ha alcanzado un estado resoluble. Los traders que monitorizan los libros de órdenes pueden responder de inmediato.
• Los reportes son visibles en la UI de Polymarket y a través de la Gamma API, por lo que bots de arbitraje y traders humanos pueden detectarlos programáticamente.

Ventana de disputa optimista de UMA (qué es, no cuánto dura)

Después de publicar un reporte, el modelo optimista de UMA permite una ventana de disputa durante la cual los challengers pueden aportar evidencia en contra. Si se plantea una disputa, el flujo optimista se pausa y UMA resuelve el desacuerdo según su proceso.

Puntos prácticos importantes:

• La ventana de disputa introduce incertidumbre. Un mercado que parece resuelto puede reabrirse para investigación si UMA recibe una disputa.
• Dado que los detalles exactos de tiempo e implementación de los procedimientos de UMA son externos a Polymarket, los traders deben tratar cualquier mercado en o cerca de la fase de disputa como sujeto a riesgo de resolución.

Nota: El system prompt especifica que se usa UMA pero no proporciona la duración de la ventana de disputa. Consulta la sección Notes para esa laguna.

Finalización y canje de tokens CTF

Una vez que el proceso del oráculo se completa y el resultado es final, el mercado se finaliza on-chain. En ese momento los usuarios pueden canjear los tokens ERC-1155 ganadores por pUSD mediante la operación de redeem del CTF.

En la práctica en Polymarket:

• Las operaciones CTF (split / merge / redeem) se gestionan a través del Polymarket Relayer, por lo que son gasless para ti.
• El canje convierte cada token ganador en $1.00 de pUSD, que luego puedes retirar o usar para split en nuevas posiciones.

Si posees un conjunto completo de tokens de resultado antes de la resolución, el canje es sencillo: solo recibes pUSD por la(s) rama(s) ganadora(s). Si mantienes posiciones parciales, solo los tokens ganadores correspondientes se canjean.

Casos límite comunes que ven los traders en la resolución

• Finalizaciones disputadas: las disputas de UMA pueden retrasar la liquidación e impedir temporalmente el canje. Eso afecta la liquidez y puede inmovilizar capital.
• Fills parciales y ejecución de órdenes: una orden parcialmente fillada antes de la resolución puede dejarte largo en ciertos tokens y corto en otros; asegúrate de rastrear los fills para evitar exposiciones inesperadas.
• Cambio de tick-size y actualizaciones de precio: el tamaño de tick cambia cerca de la resolución y puede alterar las órdenes disponibles; el WebSocket emite eventos tick_size_change que importan para los bots.
• Efectos de tarifas y recompensas: las maker fees son cero; las taker fees varían por categoría. Las fees y la atribución de builder (si enrutas a través de un Builder) afectan los resultados netos pero no cambian el proceso de liquidación del oráculo.

Nunca asumas que un mercado liquidado no puede reabrirse si UMA inicia un flujo de disputa. Confirma siempre el estado del mercado antes de iniciar cualquier operación de redeem CTF o transferencias grandes.

Cómo esto afecta las estrategias de arbitraje y endgame

Para el arbitraje intra-market (comprar un conjunto cuando Σ bestAsk < $1.00), la mecánica de resolución es central: tu beneficio teórico se convierte en pUSD solo después de la finalización y el canje. Eso significa que el momento, el riesgo de disputa del oráculo y los retrasos de liquidación importan tanto como la ejecución de órdenes.

Reglas prácticas de referencia:

• Trata el spread como una ventaja matemática solo después de haber contabilizado fees, slippage y riesgos de disputa. Enumera siempre estos riesgos antes de etiquetar una operación como arbitraje.
• Para estrategias endgame (precios cercanos a resolución como $0.95–$0.99), ten especial precaución: márgenes más pequeños y disputas de UMA pueden convertir una jugada a corto plazo en una pérdida.
• Usa las APIs de Polymarket y el Market WebSocket para monitorizar reports, tick_size_change, best_bid_ask y last_trade_price en tiempo real.

Monitoreo de la resolución de forma programática

APIs y flujos a vigilar:

• Gamma API (https://gamma-api.polymarket.com): metadata de mercados y eventos, incluyendo campos relacionados con la resolución. Usa el endpoint /markets con paginación basada en cursor.
• Data API (https://data-api.polymarket.com): posiciones, trades y open interest para rastrear fills y exposición.
• Market WebSocket (wss://ws-subscriptions-clob.polymarket.com/ws/market): libro en tiempo real, price_change, best_bid_ask, last_trade_price y tick_size_change. PING cada 10s; suscríbete con custom_feature_enabled para obtener best_bid_ask.

Combina estos feeds para detectar un reporte, vigilar señales de disputa de UMA en la UI o en el feed de datos y retrasar la contabilidad final hasta que el estado del mercado sea final.

Checklist: qué hacer cuando un mercado reporta

• Confirma el resultado reportado en Gamma y en la UI de Polymarket.
• Pausa la automatización que asume finalidad inmediata hasta que termine la fase de disputa de UMA.
• Rastrea órdenes abiertas y fills; cancela o ajusta si es necesario para evitar exposición no deseada.
• Tras la finalización, canjea los tokens ganadores vía la UI, el SDK o tu flujo integrado con el Relayer.

Cómo esto afecta tu operativa

La resolución es el cuello de botella final entre la ejecución de la operación y el pUSD realizado. Para traders activos y arbitrajistas, eso significa que debes gestionar tres riesgos vinculados: ejecución (fills y slippage), resolución del oráculo (reportes y disputas) y tiempos de liquidación (redeem y retiros). La ejecución exitosa requiere tanto herramientas rápidas del lado del mercado como supuestos conservadores sobre el riesgo de disputa.

Si construyes automatización, registra cada fill y vigila los canales WebSocket listados arriba. Trata los mercados en o cerca de un estado reportado como de mayor riesgo hasta que UMA los limpie.

Nota de cierre: Polymarket resolution explained debería darte la lista operativa y el modelo mental para gestionar el riesgo de liquidación. Usa las APIs y el WebSocket para monitorizar eventos, recuerda que el redeem CTF es gasless a través del Relayer y siempre contabiliza las ventanas de disputa antes de asumir que una operación se ha convertido en pUSD.

Preguntas frecuentes

¿Quién reporta resultados en Polymarket?

Polymarket usa el oráculo optimista UMA para el reporte de resultados. Los reportes se envían a UMA y son visibles en la UI y las APIs de Polymarket; UMA gestiona las disputas posteriores según su proceso.

¿Qué ocurre durante la ventana de disputa de UMA?

Tras un reporte, UMA permite un periodo de disputa donde los challengers pueden impugnar el resultado reportado. Si hay impugnación, UMA pausa la liquidación optimista y sigue su flujo de resolución de disputas, lo que puede retrasar el canje de los tokens ganadores.

¿Son gasless las operaciones CTF en Polymarket?

Sí. Polymarket patrocina el gas vía su Relayer. Split, merge, redeem, transfers y la colocación de órdenes son gasless para el usuario final porque se enrutan a través del Relayer.

¿Puede reabrirse un mercado después de que parezca resuelto?

Sí. Si UMA recibe una disputa, un mercado que parecía resuelto puede reabrirse o retrasarse a la espera de la resolución de UMA. Trata cualquier mercado en o cerca de la fase de disputa como sujeto a riesgo de resolución.

¿Cómo puedo detectar programáticamente un reporte o una disputa?

Usa la Gamma API para metadata de mercados y el Market WebSocket (wss://ws-subscriptions-clob.polymarket.com/ws/market) para eventos en tiempo real como price_change, best_bid_ask, last_trade_price y tick_size_change. Combina esos feeds con los endpoints de la Data API para monitorizar posiciones y fills.