API pública
Claves de API REST para acceso programático (plan Bot)
La API pública de Predite te permite leer tus propios datos de forma programática — tu portafolio en vivo y las últimas señales de Expected Value — desde tus propios scripts, hojas de cálculo o herramientas de trading. Es una API REST de solo lectura protegida con una clave de API personal, disponible en el plan Bot.
Creas y gestionas las claves desde el panel, en Settings, en la página API.
Cómo crear una clave de API
Ponle una etiqueta a la clave (por ejemplo, "sheet import" o "backtest script") y créala. Algunas cosas que conviene saber:
- •La clave completa se muestra una sola vez, al crearla. Tiene el formato pdt_live_ seguido de una cadena aleatoria. Cópiala de inmediato y guárdala en un lugar seguro — no se vuelve a mostrar nunca, porque en nuestros servidores solo se conserva un hash.
- •Después de crearla, el panel muestra únicamente el prefijo corto de la clave para que puedas distinguir unas de otras.
- •Cada clave es de solo lectura y caduca al cabo de un año desde su creación. Te avisamos antes de que venza.
- •Puedes revocar una clave en cualquier momento. La revocación surte efecto de inmediato — cualquier script que siga usándola empieza a recibir 401 Unauthorized.
Autenticación
Envía la clave como Bearer token en el header Authorization de cada petición:
Authorization: Bearer pdt_live_your_key_here
Una clave ausente o inválida devuelve HTTP 401. Las peticiones tienen un límite de tasa por cliente — si envías demasiadas en muy poco tiempo recibes HTTP 429 con un header Retry-After que te indica cuántos segundos esperar. Mantén el polling en unas pocas peticiones por minuto y cachea lo que obtengas; ninguno de estos datos cambia de un segundo a otro.
Endpoints
Hoy hay dos endpoints GET disponibles, y ambos devuelven JSON.
GET /api/v1/portfolio
Devuelve las posiciones abiertas de la billetera de Polymarket conectada a tu cuenta, junto con un resumen y una marca de tiempo generated_at. Si todavía no has conectado y verificado una billetera, el array positions vuelve vacío con un error no_wallet_connected — conecta una primero (consulta Conectar una billetera).
GET /api/v1/signals
Devuelve las principales señales de Expected Value actuales, ordenadas por edge. Dos parámetros de consulta opcionales:
- •limit — cuántas señales devolver, de 1 a 100 (20 por defecto)
- •min_edge — el edge mínimo en puntos porcentuales (5 por defecto)
La respuesta incluye el array signals, un count, los filtros que usaste y una marca de tiempo generated_at.
Cada señal aquí es la estimación de un modelo de IA. Cuando ningún modelo respondió, el escáner sigue mostrando su estimación por fórmula en el dashboard, etiquetada como fórmula, pero no publica ninguna señal a partir de ella — así que nada llega a este endpoint, a los webhooks, a las alertas ni a Telegram. Cada señal incluye ai_source, que es "llm" en toda señal publicada desde el 24 de octubre de 2026.
Ejemplo
Una petición mínima con curl, pidiendo las diez señales más fuertes con al menos seis puntos de edge:
curl -H "Authorization: Bearer pdt_live_..." "https://predite.io/api/v1/signals?limit=10&min_edge=6"
Conviene saber
- •La API es de solo lectura — no hay endpoints de trading ni de escritura. Las órdenes siempre se colocan desde la app, así que una clave filtrada nunca puede mover tu dinero.
- •Aun así, trata la clave como una contraseña. Si se filtra, revócala y emite una nueva.
- •¿Prefieres que las alertas te lleguen solas en vez de hacer polling? Vincula tu cuenta a Telegram y deja que las señales vengan a ti.