Cómo conectar tus cuentas: Polymarket y Kalshi, de principio a fin
Predite funciona perfectamente como herramienta de investigación sin conectar nada: puedes escanear mercados, leer las estimaciones de probabilidad de la AI y estudiar el EV todo el día. Pero la plataforma se vuelve muchísimo más útil en el momento en que sabe lo que realmente tienes. Conecta tus cuentas y tus posiciones reales fluirán hacia la página de Portafolio, tu P&L pasa a ser en tiempo real en lugar de hipotético, y el EV Scanner comienza a cruzar cada señal contra los mercados a los que ya estás expuesto. Esta guía te lleva paso a paso por la conexión de Polymarket y Kalshi desde cero, explica los dos niveles de acceso muy distintos que puedes otorgar y detalla exactamente cómo se almacenan tus secretos. Está escrita para alguien que nunca ha pegado un private key en ningún lado, así que iremos despacio y explicaremos el *porqué* detrás de cada paso.
Dos tipos de conexión: solo lectura vs. trading
El concepto más importante de todos es que existen dos niveles de acceso completamente diferentes, y deberías entender ambos antes de hacer cualquier cosa.
Una conexión de solo lectura le permite a Predite *ver* tus posiciones, pero nunca tocarlas. En el caso de Polymarket, esto significa que no nos das nada más que la dirección pública de tu wallet: la misma cadena 0x… de 42 caracteres que cualquiera puede ver en un explorador de bloques. Con solo esa dirección, Predite lee tus posiciones abiertas, tus precios promedio de entrada y tu valor actual a precio de mercado directamente desde la cadena. Sin private key, sin firmas, sin capacidad de mover fondos. Este es el punto de partida correcto para casi todos.
Una conexión de trading es otra cosa. Para permitir que Predite *coloque órdenes* en tu nombre —que es lo que impulsa a los bots automatizados y la interfaz de Live Trading con un solo clic— necesitamos credenciales que puedan firmar transacciones de verdad. En Polymarket eso significa tu private key. Es una concesión de poder seria: quien posee un private key controla los fondos de esa wallet, sin excepción. Cubriremos exactamente cómo hacerlo de forma segura, pero la regla principal es simple: nunca conectes tu wallet principal para trading. Usa una wallet de trading dedicada, financiada únicamente con lo que puedas permitirte perder.
Un modelo mental útil: una conexión de solo lectura es como darle a alguien tu estado de cuenta bancario. Una conexión de trading es como darle tu tarjeta de débito y tu PIN. La mayoría de la gente solo necesita el estado de cuenta.
Restricciones por plan, de entrada
- •El seguimiento de portafolio de solo lectura funciona en todos los planes, incluido Starter ($29/mo).
- •El trading en vivo de Polymarket (la conexión con private key, los bots ejecutando órdenes reales, la interfaz de Live Trading) requiere el plan Bot ($99/mo) con una suscripción activa. Si intentas conectarte para trading en vivo en Starter o Pro, la API devolverá un mensaje claro de "Bot plan required".
- •Pro ($59/mes) queda en medio: scanner completo, alertas y portafolio unificado, pero ningún bot. El Bot Builder es del plan Bot de punta a punta, papel incluido.
Parte 1: Conectar Polymarket (solo lectura)
Esta es la versión de cinco minutos que cubre al 90% de los usuarios. Solo estás entregando una dirección pública.
- Abre Polymarket y encuentra la dirección de tu wallet. Haz clic en tu avatar (arriba a la derecha) → tu dirección aparece en la parte superior del menú, comenzando con
0x. Haz clic para copiarla. Tendrá exactamente 42 caracteres. - En Predite, ve a Settings → Portfolio → Add Wallet (o pégala en el aviso de incorporación del Portafolio Unificado la primera vez que abras la página de Portafolio).
- Pega la dirección. Predite valida el formato (debe ser una dirección EVM válida: 42 caracteres hexadecimales) y rechaza cualquier valor mal formado antes de guardarlo.
- Eso es todo. En unos segundos aparecerán tus posiciones.
Como se trata de datos públicos, no hay riesgo ni nada que cifrar. Puedes agregar varias direcciones —útil si mantienes wallets separadas para mercados de política y de cripto— e incluso seguir wallets que no son tuyas (algunos traders monitorean así wallets sharp conocidas).
Parte 2: Conectar Polymarket para trading
Si tienes el plan Bot y quieres que los bots ejecuten de verdad, deberás proporcionar un private key. Antes de tocar el formulario, prepárate correctamente.
Paso 0: Crea una wallet de trading dedicada
No te saltes esto. La wallet que conectes para trading debe ser una wallet nueva que contenga únicamente tu bankroll de trading. El razonamiento en términos concretos: si tienes $8,000 en tu wallet principal y un bug, un sitio de phishing o una copia de seguridad filtrada llega a exponer ese key, los $8,000 desaparecen; no hay contracargos en una blockchain. Si en cambio financias una wallet dedicada con $100, tu pérdida en el peor de los casos es $100. Esa asimetría es enorme y configurarla no te cuesta nada.
Un enfoque limpio:
- Crea una wallet completamente nueva en MetaMask (o Rabby, o una hardware wallet): una cuenta nueva, una seed phrase nueva, jamás usada para nada más.
- Transfiere mediante puente o envía solo el bankroll de trading que tienes pensado en USDC sobre Polygon. Para tus primeras semanas, $20–$100 es más que suficiente.
- Usa el private key de *esta* wallet al conectar. Trata su seed phrase como prescindible en el sentido de que ya limitaste el riesgo a la baja, pero aun así guárdala de forma segura.
Paso 1: Entiende los tres signature types
Esta es la parte que hace tropezar a los principiantes, así que seamos precisos. Polymarket admite tres arquitecturas de cuenta, y Predite necesita saber cuál tienes. El formulario de conexión las etiqueta y la API valida que hayas elegido una combinación coherente.
- •Type 0 — EOA (Externally Owned Account). Es una wallet de Ethereum estándar: MetaMask, Rabby, Coinbase Wallet o una hardware wallet. Elige esta si importaste tu propia wallet a Polymarket usando una seed phrase o un private key. Para un EOA, el *funder* (la dirección que tiene el dinero) es la misma que tu wallet de firma. Predite lo hace cumplir: si seleccionas Type 0 y proporcionas un funder distinto, el servidor lo sobrescribe con la propia dirección de tu wallet para evitar fallos silenciosos de órdenes más adelante.
- •Type 2 — Gnosis Safe Proxy. Es el tipo más común para quienes se registraron en polymarket.com usando inicio de sesión social o correo electrónico (Google, etc.). Polymarket te aprovisionó una wallet "proxy" de smart contract entre bastidores. Tu clave de firma es una dirección, pero tus fondos viven en una wallet proxy *separada*. Esa dirección proxy es tu funder, y la encontrarás en polymarket.com/settings.
- •Type 1 — Magic Link Proxy. Elige esta si inicias sesión en Polymarket vía Magic Link (correo electrónico) y exportaste el private key subyacente. Al igual que Type 2, usa una dirección proxy separada como funder.
Una forma rápida de autodiagnosticarte: *¿Importé mi propia wallet estilo MetaMask a Polymarket?* → Type 0. *¿Solo me registré con mi cuenta de Google o correo en el sitio web?* → casi con seguridad Type 2.
Paso 2: Obtén tu private key
Dónde exportas la clave depende de tu wallet:
- •MetaMask: haz clic en los tres puntos junto al nombre de tu cuenta → Account details → Show private key, ingresa tu contraseña y copia la cadena hexadecimal de 64 caracteres (puede o no comenzar con
0x; Predite acepta ambos y la normaliza). - •Cuentas proxy de Magic Link / correo electrónico: usa la opción "Export Private Key" de Polymarket en la configuración de tu cuenta.
Mientras la tengas en el portapapeles, trata esa cadena como una granada activada. No la pegues en un chat, en una nota que se sincronice a la nube ni en ningún sitio que no sea el formulario de conexión de Predite sobre HTTPS. Limpia tu portapapeles después.
Paso 3: Encuentra tu funder address (solo Types 1 y 2)
Si eres un EOA Type 0, sáltate esto: deja el campo de funder en blanco y Predite usará tu dirección de wallet automáticamente. Para Types 1 y 2, ve a polymarket.com/settings y copia tu dirección proxy/de depósito. Esta es la dirección que Predite valida como tu funder, y debe ser diferente de tu wallet de firma. De hecho, el endpoint de conexión rechazará el intento con un mensaje explícito si el funder es igual a la wallet en un tipo proxy; ese desajuste es el error de configuración más común, y casi siempre significa que en realidad tienes un EOA y deberías haber elegido Type 0.
Paso 4: Ejecuta el asistente de conexión
En Predite, ve a Settings → Trading API → Polymarket. El asistente te guía paso a paso:
- Pantalla de introducción. Explica el flujo y te recuerda usar una wallet dedicada. Hay una guía visual opcional, paso a paso, que puedes abrir primero.
- Reconocimiento de riesgo. Marcarás una casilla confirmando que entiendes que el trading en vivo está en beta, que los bugs de software podrían provocar operaciones no deseadas, que solo tú eres responsable de los fondos en la wallet conectada y que Predite no puede recuperar fondos perdidos. Esto queda registrado.
- Formulario de credenciales. Elige tu tipo de wallet (signature type 0/1/2), pega tu private key (hay un botón para mostrar/ocultar) e ingresa tu funder address si es necesario.
- Conectar. Predite firma un mensaje con tu clave para derivar tus credenciales de la CLOB API de Polymarket (un paso L2: no ocurre ninguna transacción on-chain al momento de conectar, y no se gasta nada), cifra todo y lo guarda.
Los intentos de conexión están limitados a 5 cada 15 minutos para desalentar los ataques de fuerza bruta y fomentar que ingreses bien los datos. Si algo está mal, recibirás un error específico: un signature type incorrecto y las wallets no registradas son los culpables habituales.
Paso 5: Prueba antes de confiar
Una vez conectado, la pestaña de Polymarket muestra un botón "Place Test Order". Úsalo. Pega el token_id de un mercado (lo encontrarás en los detalles del activo en el scanner o en clob.polymarket.com), define un tamaño minúsculo como 5 shares a $0.50 y dispáralo. Si el trading en vivo a nivel de plataforma sigue desactivado, la orden se registra como un paper trade para que puedas validar todo el pipeline de conectar → firmar → enviar sin ningún riesgo. Cuando pases a vivo, comienza con órdenes de $1–$5 en tus primeras operaciones reales.
Algunas cosas que verás en la tarjeta de cuenta conectada: tus direcciones de wallet y funder, tu tipo de wallet, un indicador de allowances (aprobaciones de gasto de USDC, configuradas automáticamente en la primera operación) y un indicador de gas. Si tu cuenta está en el programa de relayer/builder de Polymarket, verás una insignia de "Gasless": las operaciones se enrutan a través del relayer de Polymarket y solo necesitas USDC. De lo contrario, necesitarás una pequeña cantidad de MATIC en la wallet para pagar el gas.
Parte 3: Conectar Kalshi
Kalshi no se parece en nada a Polymarket en su arquitectura. Es un exchange regulado por la CFTC sin blockchain: la autenticación es una API key más firma RSA de las solicitudes, y requiere haber completado el KYC. Debido a ese diseño regulado y basado en firmas, el trading en vivo de Kalshi dentro de Predite está en el roadmap, todavía no se ha lanzado. La pestaña de Kalshi en Settings muestra un estado claro de "coming soon".
Sin embargo, este es el matiz importante: los datos de mercado de Kalshi, la analítica, la cobertura del scanner y las lecturas de portafolio de solo lectura funcionan ahora mismo en todo el resto de la app. Los mercados de Kalshi aparecen en el EV Scanner, el motor de arbitrage los compara contra Polymarket para detectar spreads entre plataformas, y una vez que el conector de lectura esté enlazado a tu cuenta, tus posiciones de Kalshi se integran en el Portafolio unificado. Para tener lista una API key de Kalshi para cuando se amplíen las lecturas/el trading:
- Inicia sesión en kalshi.com y completa el KYC si aún no lo has hecho.
- Ve a Account → API / Settings y crea una API key. Kalshi emite un ID de clave y te permite descargar un archivo de clave privada RSA una sola vez; guárdalo de forma segura, no se puede volver a descargar.
- Mantén ambos a salvo. Cuando Predite habilite la conexión con Kalshi, pegarás el ID de clave y la clave RSA, y se cifrarán exactamente igual que las credenciales de Polymarket.
Por ahora, lo práctico es: apóyate en Kalshi para *lecturas y señales* a través del scanner, y ejecuta en Kalshi manualmente hasta que llegue el trading en vivo.
Qué se activa una vez que estás conectado
Esta es la recompensa. Conectar transforma a Predite de un scanner genérico en algo ajustado a *ti*:
- •El portafolio cobra vida. La página de Portafolio Unificado agrega las posiciones de cada plataforma conectada en una sola vista: valor total, base de costo total (shares × precio promedio) y desgloses por plataforma. Una sola pantalla en lugar de tres pestañas del navegador.
- •P&L real, no hipotético. En lugar de adivinar, ves las ganancias y pérdidas no realizadas reales por posición, calculadas a partir de tus precios de entrada reales frente a los precios de mercado en vivo. Una posición que abriste a $0.40 y que ahora cotiza a $0.61 muestra un concreto +52.5% en vez de una abstracción.
- •El scanner trabaja contra tus tenencias. Esta es la que es discretamente poderosa. El EV Scanner puede avisarte cuando un mercado que ya tienes se ha movido: por ejemplo, tu modelo sigue marcando 60% pero el precio se ha equiparado a 60%, lo que significa que tu edge desapareció y es momento de redistribuir capital. También puede revelar exposición correlacionada: si tres de tus posiciones se resuelven con la misma decisión de la Fed, eso es en la práctica una sola apuesta, y verlas juntas evita que te sobreconcentres.
- •Exportaciones e informes fiscales. Con el historial de operaciones real conectado, puedes exportar CSVs y generar un informe de P&L/fiscal con totales mensuales y base de costo FIFO, mucho más fácil a fin de año que reconstruir las operaciones a mano.
- •Automatización (plan Bot). Con una conexión de trading activa, los bots dimensionan y colocan órdenes contra tu bankroll real, y la interfaz de Live Trading, el kill switch y los controles por operación quedan todos disponibles.
Seguridad: cómo se almacenan tus secretos
Nos estás confiando un private key, así que mereces saber exactamente qué pasa con él. La versión honesta y específica:
- •El cifrado es AES-256-GCM, un cifrado autenticado que protege tanto la confidencialidad como la integridad (un texto cifrado manipulado falla al descifrar en lugar de devolver basura silenciosamente).
- •La clave se deriva con scrypt, una función de derivación de claves deliberadamente lenta, usando un salt aleatorio de 16 bytes y un IV aleatorio de 12 bytes nuevo para cada cifrado individual. No hay dos valores almacenados que compartan los mismos parámetros, lo que neutraliza los ataques de rainbow table y de reutilización de IV.
- •El texto plano nunca toca el disco. Tu private key llega por HTTPS, se cifra en memoria y solo el texto cifrado se escribe en la base de datos. Cuando un bot necesita firmar una orden, la clave se descifra en memoria solo durante el instante que toma firmar y luego se descarta.
- •Los secretos nunca se registran, ni siquiera parcialmente. El registro de auditoría anota que ocurrió una conexión, la wallet, el funder y el signature type, pero el código excluye explícitamente el private key y el secreto de la API de cada línea de log.
- •Desconectar elimina realmente las credenciales. Pulsa "Disconnect" y una rutina del servidor anula tus claves almacenadas; cualquier bot en modo en vivo deja de enviar órdenes y recibes una notificación: no se convierte en bot de papel en silencio. Para rotar una clave, simplemente desconectas y vuelves a conectar con la nueva.
Nada de esto cambia la regla fundamental, que vale la pena repetir una última vez: el cifrado protege la clave *en reposo dentro de nuestro sistema*, pero no puede deshacer una mala operación ni recuperar fondos si la seed phrase de tu propia wallet se filtra en otro lugar. El hábito de la wallet dedicada es tu verdadera red de seguridad; el software es la segunda capa, no la primera.
Ahora tienes todo lo que necesitas para integrar Predite en tu trading. Si hoy haces una sola cosa, pega la dirección de tu wallet de Polymarket en la página de Portafolio y observa cómo tus posiciones reales y tu P&L en vivo se llenan en segundos: es de solo lectura, sin riesgo, y al instante vuelve más inteligente a todas las demás funciones. Cuando estés listo para dejar que los bots hagan el trabajo, financia una wallet nueva con una cantidad que no te importaría perder, ejecuta el asistente de conexión y dispara una orden de prueba de $1 antes de algo mayor. Empieza en pequeño, verifica todo y escala solo cuando los números coincidan con tus expectativas.