Guía para principiantes: usa Polymarket de forma segura

Cómo usar Polymarket para principiantes se reduce a dos flujos de trabajo separados: un camino de solo lectura donde cualquiera puede navegar o extraer datos de mercado públicos, y un camino de riesgo donde la autenticación y los depósitos se vuelven irreversibles. Los clics son fáciles, pero la infraestructura importa: códigos de inicio de sesión, selección correcta de cadena en Polygon, tipo de billetera, gas y aprobaciones.

Puntos clave

• Polymarket los datos del mercado se pueden obtener públicamente sin una API clave, pero realizar pedidos requiere credenciales de API derivadas de la billetera de L2.
• El registro admite Google, correo electrónico con un código de 6 dígitos, o conectar una billetera cripto y firmar mensajes para habilitar el comercio.
• Los depósitos requieren elegir el token y la red correctos y enviar a la dirección proporcionada.dirección. Los depósitos en cadenas incorrectas o direcciones incorrectas no se pueden revertir.
• La elección de la billetera cambia la fricción operativa: un EOA típicamente necesita POL para gas, mientras que un Safe desplegado por un relayer puede habilitar operaciones en cadena sin gas.

Cómo funciona la incorporación a Polymarket

Una guía amigable para principiantes de Polymarket comienza con una división clara: lo que se puede hacer sin autenticación frente a lo que pone inmediatamente en riesgo los fondos y el acceso. En el lado de solo lectura, la documentación para desarrolladores de Polymarket hace explícito el límite. Los puntos finales de datos del mercado son públicos, y no se requiere clave API ni autenticación para obtener mercados.

Eso significa que un principiante puede aprender sobre el producto, seguir precios y construir una mentalidad de lista de seguimiento sin crear una cuenta o tocar una billetera.

En el momento en que el flujo de trabajo cruza hacia el comercio, los requisitos cambian. La documentación de ayuda de Polymarket enumera tres métodos de registro: inicio de sesión con Google, inicio de sesión por correo electrónico usando un código de 6 dígitos, o iniciar sesión con una billetera de criptomonedas conectándose y firmando mensajes (incluyendo un segundo mensaje para habilitar el comercio). Ese último paso es importante porque es el puente entre “puedo ver mercados” y “puedo realizar acciones autenticadas.”

Aquí es donde la mayoría del contenido tutorial de Polymarket se vuelve descuidado. Trata la incorporación como un solo embudo, cuando la plataforma se comporta más como dos sistemas cosidos juntos: datos públicos por un lado, comercio autenticado por el otro. Para los usuarios técnicos, la misma división aparece en la API.

Obtener mercados es abierto, pero realizar órdenes requiere derivar credenciales de API L2 de una billetera e inicializar el cliente de comercio con esas credenciales.

Los principiantes deben decidir temprano qué camino están tomando. Si el objetivo es entender los mercados de predicción y cómo se expresan las probabilidades, permanecer en modo solo lectura durante una sesión es racional. Si el objetivo es comerciar, la lista de verificación previa al vuelo es operativa: método de cuenta, tipo de billetera, red de depósito y si la configuración requerirá POL para gas.

Depositar fondos sin perderlos

La pantalla de depósito es el punto donde los errores dejan de ser 'oops' y comienzan a ser permanentes. Las instrucciones de depósito de Polymarket son sencillas: haz clic en Depositar, elige un método como Transferir Cripto, selecciona el token y la red, copia la dirección de depósito, envía al menos la cantidad mínima requerida, luego actualiza después de la confirmación para ver el saldo.

La parte que merece la paranoia de nivel comerciante es la advertencia adjunta: las transacciones enviadas a la cadena o dirección incorrecta no se pueden revertir.

Un principiante que pregunta '¿cuánto necesito para empezar en Polymarket?' generalmente está tratando de evitar financiar en exceso un lugar desconocido. La documentación referenciada aquí no enumera mínimos exactos o tokens soportados para cada ruta, pero sí indica que hay una cantidad mínima requerida para el método de depósito elegido.

El flujo de trabajo correcto es dejar que el flujo de Depósito en la aplicación te indique el mínimo para ese token y red, luego dimensionar la primera transferencia para superar el mínimo mientras se mantiene la prueba pequeña.

El hábito más seguro es una verificación de dos pestañas. Mantén visible la pantalla de depósito de Polymarket mientras preparas el envío en la interfaz de usuario de retiro de la billetera o el intercambio. Antes de confirmar, revisa visualmente dos campos: el nombre de la red y los primeros y últimos cuatro caracteres de la dirección de depósito. Esto no es ceremonia. Es la única defensa contra los dos errores irreversibles que la documentación menciona.

Aquí es donde los términos de plomería interna comienzan a importar. Si el flujo de depósito está financiando un saldo de Polymarket que finalmente comercia utilizando polymarket usd pusd, el usuario aún tiene que seleccionar correctamente la red en el momento de la transferencia.

La plataforma no puede 'arreglar' un envío a la cadena incorrecta después del hecho, porque la finalización de la transacción está en la cadena, no en la base de datos de Polymarket.

Selección de billetera y expectativas de gas

La selección de billetera cambia el modelo de costos de usar Polymarket más de lo que la mayoría de los principiantes espera. La documentación para iniciarse como creador de mercado traza una línea clara entre una EOA y una billetera Safe. Una EOA es un estándarEthereum-style wallet donde el usuario paga por transacciones onchain, incluyendo aprobaciones y ejecución de operaciones.

Una billetera Safe en la documentación de Polymarket es una billetera de contrato basada en Gnosis Safe desplegada a través del relayer de Polymarket, con el beneficio declarado de que se pueden habilitar transacciones sin gas donde Polymarket paga las tarifas de gas para operaciones onchain.

Esa distinción responde a la pregunta de los principiantes “¿necesito una billetera para Polymarket?” con matices. No se requiere una billetera para navegar por los mercados o extraer datos públicos. Una billetera se vuelve central una vez que el usuario desea operar con autenticación basada en billetera, o una vez que el usuario está interactuando con el flujo de API que deriva credenciales de un firmante.

Las expectativas de gas son donde los principiantes se ven sorprendidos. El Quickstart es explícito en que el ejemplo utiliza la red principal de Polygon con el id de cadena 137, y señala un requisito concreto: antes de operar, la dirección del financiador necesita pUSD para comprar outcome tokens y POL para gas si usa un EOA (tipo de firma 0).

La idea errónea común es que “Polygon significa que el gas es básicamente gratis, así que no importa.” La realidad operativa es más simple: si la billetera está pagando gas, necesita el token de gas.

Para usuarios técnicos, la configuración basada en relayer introduce otro término que aparece en los flujos de autenticación: una proxy wallet. El Quickstart señala que los usuarios de billeteras proxy (tipos 1 y 2) pueden usar el relayer sin gas de Polymarket en lugar de pagar gas como un EOA. Eso no es una mejora moral.

Es una elección de flujo de trabajo con diferentes modos de falla, y es por eso que el tipo de billetera debe decidirse antes de la financiación y las aprobaciones.

Encontrando mercados y leyendo resultados

La forma más rápida de entender la estructura del mercado de Polymarket es obtener un mercado activo del punto final público de Gamma e inspeccionar los campos. El Quickstart utiliza un ejemplo concreto de llamada a https://gamma-api.polymarket.com/markets?active=true&closed=false&limit=1 y muestra la pregunta del mercado y los clobTokenIds. El detalle clave para los principiantes no es la solicitud HTTP.

Es la regla de ordenamiento que los documentos especifican: los clobTokenIds están ordenados [ID de token Sí, ID de token No].

Ese orden es la diferencia entre un pedido correcto y un error silencioso al operar programáticamente. Un principiante puede estar "correcto" en la tesis y aún así colocar el lado equivocado si los IDs de token se intercambian en el código o en una hoja de cálculo. Por eso es útil una página separada como cómo leer los precios de polymarket. El precio solo tiene sentido cuando está vinculado al token de resultado correcto.

Para los usuarios que no utilizan la API, el mismo concepto aparece visualmente como resultados de Sí y No. Para los usuarios de la API, se convierte en un ID de token que debe ser pasado a la creación de órdenes. El Quickstart incluso le dice al lector que guarde un ID de token de clobTokenIds porque será necesario para realizar un pedido.

Esta sección también es la ilustración más clara de la división entre lectura y riesgo. Obtener mercados es público y seguro. En el momento en que el flujo de trabajo pasa de "leer IDs de token" a "enviar una orden", el usuario está en territorio autenticado, y el sistema de credenciales derivadas de la billetera se vuelve obligatorio.

Una nota práctica para los usuarios móviles que preguntan "¿se puede usar polymarket en el teléfono?": navegar y leer mercados es inherentemente amigable para teléfonos porque es solo de lectura. La fricción comienza cuando se espera que el teléfono también gestione la firma de la billetera, la selección de red en polygon y la copia de direcciones de depósito sin errores en el portapapeles.

Colocando tu primera operación a través de la API

Un flujo de operación mínimo de la API tiene tres partes en movimiento: descubrimiento de mercados públicos, autenticación derivada de la billetera y envío de órdenes con los parámetros de mercado correctos.

El Quickstart establece la secuencia: obtener un mercado de Gamma, instalar el SDK, derivar credenciales de API, inicializar el cliente de trading en la red principal de Polygon (id de cadena 137), y luego colocar una orden limitada utilizando un token_id de clobTokenIds.

El paso de autenticación es la parte que los principiantes malinterpretan porque no se comporta como una página de clave de API de intercambio centralizado. Los documentos especifican que para colocar órdenes y acceder a puntos finales autenticados, el usuario debe derivar credenciales de API L2 de la billetera usando createOrDeriveApiKey, y luego inicializar el cliente de trading con esas credenciales.

Esas credenciales no son una clave estática de "pegar una vez y olvidar". Se producen a través de la firma de la billetera.

La colocación de órdenes en sí tiene algunos parámetros que importan operativamente. El ejemplo del Quickstart obtiene detalles del mercado para obtener el tamaño del tick y si el mercado es neg_risk, luego llama a createAndPostOrder con tokenID, precio, tamaño y lado. Ese es el modelo mental correcto: los metadatos del mercado restringen qué órdenes son válidas.

Las aprobaciones son el otro requisito oculto que aparece tan pronto como el flujo de trabajo toca el movimiento de tokens en la cadena. La guía para principiantes de los creadores de mercado enumera las aprobaciones requeridas y nombra los contratos de gasto.

Especifica aprobar pUSD para el contrato CTF para dividir pUSD en tokens de resultado, y aprobar los tokens de resultado de CTF para el CTF Exchange (y el Neg Risk CTF Exchange para mercados de riesgo negativo). Los principiantes no necesitan memorizar las direcciones de los contratos para entender el punto. Las aprobaciones son permisos explícitos y son parte de la infraestructura operativa que hace posible el comercio.

Para los lectores que desean un recorrido dedicado sobre financiamiento, cómo financiar Polymarket debe tratarse como una lista de verificación separada de 'cómo realizar un pedido'. El financiamiento es donde ocurren los errores en la cadena. El comercio es donde ocurren los errores de ID de token.

Errores comunes de principiantes a evitar

Los errores más costosos de los principiantes en Polymarket no se trata de la selección del mercado. Se trata de acceso y transferencias.

Primero: compartir el código de inicio de sesión por correo electrónico. El documento de registro de Polymarket es contundente. El código de 6 dígitos nunca debe compartirse, incluso con personas que afirman ser personal. Si alguien obtiene acceso a ese código, puede acceder a la cuenta y a los fondos, y el soporte de Polymarket no puede recuperar los fondos perdidos debido a códigos compartidos.

Los principiantes deben tratar ese código como una contraseña de un solo uso para el bankroll. Si un DM de 'soporte' lo solicita, la interacción ya está comprometida.

Segundo: depósitos en la cadena o dirección incorrecta. El documento de depósito establece que los usuarios deben verificar dos veces la red y la dirección de depósito antes de enviar fondos, y repite la consecuencia: las transacciones enviadas a la cadena o dirección incorrecta no se pueden revertir. La idea errónea que se debe eliminar aquí es 'el soporte puede solucionarlo'. Los documentos dicen lo contrario.

Tercero: asumir que el gas siempre lo maneja otra persona. El Quickstart señala que una configuración EOA (tipo de firma 0) requiere POL para gas en Polygon. El comportamiento sin gas depende del tipo de billetera y el flujo de relayer, no de pensamientos optimistas.

Cuarto: tratar el acceso a la API de Polymarket como una clave de API de intercambio normal. Los datos del mercado son públicos, pero el comercio requiere credenciales de API L2 derivadas de la billetera. Si la base de código está escrita como si una clave estática fuera suficiente, la primera llamada autenticada fallará.

Quinto: confundir los ID de tokens de Sí y No. El Quickstart hace que el orden sea explícito: clobTokenIds son [Sí, No]. Cualquier sistema que los almacene sin etiquetar, o que los ordene, es una fábrica de errores.

Los mercados de predicción recompensan estar en lo correcto sobre el evento. Polymarket castiga ser descuidado con la infraestructura.

La Toma

He visto a principiantes perder dinero en Polymarket sin haber estado "equivocados" en el mercado. Las dos explosiones recurrentes son reenviar el código de inicio de sesión de 6 dígitos a alguien que finge ser soporte, y enviar un depósito en la red equivocada porque la interfaz de la billetera se desvió de Polygon. La documentación es explícita en que el soporte no puede deshacer ninguno de los resultados.

Mi regla es una lista de verificación previa al vuelo antes de cualquier cosa irreversible: mantener la página de depósito abierta mientras se envía, volver a verificar la red más los primeros y últimos cuatro caracteres de la dirección, y tratar el orden de createOrDeriveApiKey y clobTokenIds como parte de la misma disciplina operativa. Los mercados de predicción son lo suficientemente difíciles. No añadas riesgo de plomería autoinfligido.

Fuentes

• Documentación de Polymarket
• Documentación de Polymarket
• Documentación de Polymarket
• Documentación de Polymarket