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.
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.