Polymarket Builder Program: Visión general para desarrolladores

El Polymarket Builder Program es una forma para que operadores terceros enruten órdenes a través del CLOB de Polymarket con atribución, ganen comisiones de builder expresadas en puntos básicos y accedan a beneficios del programa como mayores límites del relayer y recompensas. Esta guía explica cómo funciona el programa, los tres niveles, cómo funciona en principio el reparto de ingresos y notas prácticas de integración para equipos de ingeniería que usan el Polymarket Relayer Client.

Puntos clave

• El Builder Program permite que terceros enruten órdenes a través del CLOB con atribución y cobren comisiones de builder en puntos básicos.
• Hay tres niveles (Unverified, Verified, Partner) con límites diarios de relayer y recompensas crecientes.
• La integración de builders se hace mediante cabeceras de atribución y el Polymarket Relayer Client SDK (TypeScript y Python) gestiona el despliegue de wallets, aprobaciones, operaciones CTF y la colocación de órdenes.
• Las comisiones para makers en Polymarket son cero; las comisiones de builders se pagan al ejecutarse la orden y se expresan en puntos básicos.
• Las credenciales y la configuración de builders se gestionan en polymarket.com/settings; los detalles de ingresos y las tarifas exactas los controla Polymarket y pueden cambiar.

Por qué existe el Builder Program

Polymarket opera un Central Limit Order Book (CLOB) y patrocina el gas mediante un Relayer. El Builder Program proporciona una forma formal para que terceros añadan flujo de órdenes a ese CLOB mientras reciben atribución y una participación en los ingresos (comisiones de builder). Para desarrolladores que construyen lógica de enrutamiento, front ends de market-making o infraestructura de trading, el programa crea una vía directa y soportada para enviar flujo al exchange de Polymarket.

Program tiers and what they mean

H2: Los tres niveles

• Unverified
  • Límite diario del relayer: 100 órdenes por día.
  • Beneficios: solo trading gasless y atribución.
• Verified
  • Límite diario del relayer: 10,000 órdenes por día.
  • Beneficios: recompensas semanales en USDC basadas en volumen además de comisiones de builder expresadas en puntos básicos.
• Partner
  • Límite diario del relayer: Ilimitado.
  • Beneficios: los límites de tasa más altos y soporte elevado; acceso a los niveles de recompensa más altos.

Estas son las reglas de niveles publicadas por Polymarket. Los niveles afectan los límites de tasa del programa, la elegibilidad para recompensas y el nivel de soporte; no cambian la mecánica básica de cómo se aplican las comisiones de builder en la ejecución de una operación.

Cómo funcionan las comisiones de builder y la atribución

Las comisiones de builder se configuran como puntos básicos en las órdenes enrutadas y se pagan al builder cuando la orden se ejecuta. La atribución se implementa mediante cabeceras que identifican al builder que enruta; el Relayer utiliza esas cabeceras para acreditar al builder correspondiente en la ejecución.

Mecánicas importantes a recordar:

• Las comisiones se expresan en puntos básicos y se aplican en la ejecución; las comisiones para makers en Polymarket siguen siendo cero.
• Las cabeceras de atribución son obligatorias para que una operación se acredite a un builder. El Relayer y el CLOB esperan esas cabeceras en la solicitud.
• Las recompensas de builders para los Verified incluyen pagos semanales en USDC basados en volumen además de las comisiones acumuladas; el nivel Partner tiene recompensas y soporte mejorados.

Polymarket controla las tasas de comisión exactas y las fórmulas de recompensa. Los builders no deben asumir tasas fijas; consulten polymarket.com/settings para las credenciales actuales y la configuración de builders.

Integración con el Polymarket Relayer Client

H2: El Polymarket Relayer Client (TypeScript & Python)

Polymarket proporciona SDKs oficiales del Relayer Client en TypeScript y Python para simplificar la integración. El client gestiona tareas comunes del usuario final para que tu integración pueda centrarse en la lógica de enrutamiento y la estrategia de órdenes.

Lo que el client gestiona por ti:

• Despliegue de wallets y manejo de Proxy o Gnosis Safe
• Aprobaciones ERC-20 para pUSD
• Operaciones CTF (split/merge/redeem) para los tokens de resultado
• Creación y cancelación de órdenes, incluidas las órdenes de mercado expuestas como FAK
• Firma de solicitudes con las cabeceras de atribución de builder cuando se solicite

Usar el Relayer Client reduce la fricción de ingeniería y garantiza que las solicitudes cumplan con las expectativas del relayer de Polymarket (límites de tasa, cabeceras y semántica del CLOB).

Checklist de integración práctica

H2: Lista de implementación para builders

1. Obtén credenciales
   • Consigue tus credenciales de builder y establece tu nivel en polymarket.com/settings. Esto controla tus límites del relayer y la elegibilidad para recompensas.
2. Elige un SDK
   • Usa el Relayer Client en TypeScript o Python para acelerar la integración y evitar malas configuraciones a bajo nivel.
3. Añade atribución
   • Asegúrate de que cada orden enrutada incluya las cabeceras de atribución requeridas para que el Relayer pueda acreditar tu cuenta de builder.
4. Gestiona aprobaciones y wallets
   • Usa el client para gestionar las aprobaciones de pUSD y el despliegue de wallets; el Relayer patrocina el gas, por lo que los usuarios finales siguen sin pagar gas.
5. Monitorea límites
   • Implementa cuotas en tu sistema para evitar exceder los límites diarios del relayer para tu nivel. Los builders Unverified están limitados a 100/día, Verified 10,000/día, Partner es ilimitado.
6. Ten en cuenta comisiones y liquidación
   • Registra la acumulación de comisiones de builder en puntos básicos y concilia con las recompensas semanales si eres Verified o Partner.

Consideraciones contables y de reparto de ingresos

H2: Cómo fluyen los pagos

• Las comisiones de builder se acumulan en la ejecución y se denominan en puntos básicos de la operación.
• Los builders Verified reciben pagos semanales en USDC basados en volumen además de las comisiones de builder; el nivel Partner recibe recompensas mejoradas según el programa de Polymarket.
• Polymarket gestiona los pagos reales y las fórmulas detrás de las recompensas semanales; los builders deben usar el panel en polymarket.com/settings para informes y detalles de pago.

Notas operativas y de riesgo

• Los límites de tasa del Relayer importan: aplica throttles locales para evitar solicitudes rechazadas y comportamientos inesperados.
• Las órdenes enrutadas a través del Relayer están sujetas a las reglas del CLOB de Polymarket: comportamiento del tick size, semántica FAK para órdenes de mercado y reglas de comisiones maker/taker (los makers pagan cero maker fees).
• Los builders no eliminan otros riesgos inherentes al trading en mercados de predicción: riesgo de resolución (las disputas en UMA pueden retrasar la liquidación), deslizamiento y fills parciales, y riesgo de contratos inteligentes. Siempre comunica esos riesgos a tus usuarios.

Cómo afecta esto a tu infraestructura de trading

H2: Impacto práctico en tus sistemas

Si operas una capa de enrutamiento o un agregador, el Builder Program cambia dos cosas: puedes recibir ingresos directos por las órdenes que enrutes, y debes gestionar la atribución y los límites del relayer. Usa el Relayer Client para operaciones de wallets y tokens para evitar reimplementar la lógica CTF y gasless. Diseña tu sistema para registrar la atribución por orden, seguir las comisiones acumuladas en puntos básicos y conciliar los pagos semanales de Polymarket.

Resumen final

El Polymarket Builder Program es una vía enfocada a desarrolladores para añadir flujo de órdenes al CLOB de Polymarket con atribución y una participación en los ingresos. Para los builders, las tareas operativas principales son obtener credenciales, integrar las cabeceras de atribución, usar el Polymarket Relayer Client (TypeScript o Python) y respetar los límites por niveles del relayer. Las comisiones de builder se pagan en puntos básicos en la ejecución, y los builders Verified/Partner reciben mecanismos de recompensa adicionales gestionados por Polymarket.

Para más detalle técnico sobre el CLOB y la semántica del mercado, consulta /guides/polymarket-clob-explained y para entender la estructura de comisiones en Polymarket consulta /guides/polymarket-fees-explained.

Preguntas frecuentes

¿Cuáles son los niveles y límites del Polymarket Builder Program?

Hay tres niveles: Unverified (límite diario del relayer de 100), Verified (límite diario del relayer de 10,000 más recompensas semanales en USDC y comisiones de builder) y Partner (límite del relayer ilimitado y soporte elevado). Estos niveles controlan límites de tasa y elegibilidad para recompensas.

¿Cómo se pagan las comisiones de builder en Polymarket?

Las comisiones de builder se configuran en puntos básicos y se pagan al builder acreditado cuando una orden se ejecuta. Los builders Verified también reciben recompensas semanales en USDC basadas en volumen; la mecánica exacta de pagos la gestiona Polymarket.

¿Necesito gestionar gas o el despliegue de wallets?

No. El Relayer de Polymarket patrocina el gas para los usuarios finales. El Relayer Client SDK (TypeScript y Python) gestiona el despliegue de wallets (Proxy o Gnosis Safe), las aprobaciones de pUSD y las operaciones CTF para que puedas concentrarte en la lógica de enrutamiento.

¿Cómo me aseguro de que mis operaciones se acrediten a mi cuenta de builder?

Incluye las cabeceras de atribución requeridas en las solicitudes enrutadas. El Relayer utiliza esas cabeceras para acreditar a tu builder. Usa el Relayer Client oficial para asegurar que las cabeceras y la firma sean correctas.

¿Dónde obtengo credenciales y la configuración de builder?

Las credenciales y la configuración de nivel de builder se gestionan en polymarket.com/settings. Ese panel controla la emisión de credenciales, la asignación de niveles y los informes.