Cómo conectar tu bot a Radar

El bot puede recibir señales LOGRI, enviarlas a Telegram o utilizarlas para operar en tu exchange. Aquí se describe la conexión a las señales. El envío de mensajes y la ejecución de operaciones se configuran en el propio bot.

Cuánto cuesta la conexión

Actualmente, la conexión del bot y las solicitudes a la API están incluidas en el acceso activo a Radar. No requieren pagos adicionales.

Es válido el acceso Radar o Max, incluido el obtenido mediante código promocional o concedido por un administrador. La prueba de 7 días no permite conectar el bot.

No se cobra por las solicitudes. No se necesita una cartera ni un saldo independiente para conectar. Si aparece un plan de pago para la API, su precio y procedimiento de pago se publicarán con antelación.

Conexión de IA

Para recibir datos de Radar mediante un cliente de IA, utiliza la conexión MCP. Lee las señales y el historial dentro de los límites del acceso activo.

1. Crea una clave

Inicia sesión en tu cuenta de Radar y abre la sección «Acceso».
Busca «Conectar tu bot», indica el nombre de la conexión y pulsa «Crear clave».
Copia y guarda la clave. Solo se muestra completa una vez.

La clave se introduce en la configuración del bot, en la variable LOGRI_API_KEY. No la publiques ni la pegues en conversaciones con IA. Para escribir el código basta con el nombre de la variable. Si pierdes la clave o llega a terceros, revócala en tu cuenta y crea otra.

Cliente listo para leer señales

Descargar el cliente LOGRI para Python. Guarda las señales y el cursor en una base de datos local, continúa la lectura después de reiniciar y no añade dos veces una misma versión de la señal. No envía operaciones ni mensajes.

Se requiere Python 3.10 o posterior. Configura LOGRI_API_KEY en el entorno y ejecuta python3 logri_client.py --once. Para la lectura continua, elimina --once. Las instrucciones detalladas están en el archivo descargable.

2. Prepara el bot

Si creas el bot con ChatGPT, Gemini, Claude o Grok, proporciona el enlace a esta página y el texto siguiente. Indica si necesitas un bot para Telegram, para operar en un exchange concreto o para ambas tareas.

Ayúdame a conectar mi bot a LOGRI Radar siguiendo estas instrucciones.
Primero aclara qué quiero: mensajes en Telegram u operaciones automáticas en el exchange, qué pares y qué lenguaje de programación.
Utiliza la API de LOGRI para las señales. Lee la clave de la variable LOGRI_API_KEY; no pegues la clave real en el código ni en la conversación.
Comprueba las señales nuevas una vez por minuto. El servidor de Radar actualiza la lista general. Para una lista de pares independiente, utiliza el escáner correspondiente con un intervalo de cinco minutos. En el primer inicio, acepta solo cambios desde la hora actual.
Guarda cursor y los id + times.updatedAt procesados entre reinicios. No vuelvas a enviar señales antiguas.
Antes de una entrada nueva, exige actionable=true. Comprueba el exchange, el contrato exacto, la dirección, el plazo de la señal, la entrada, el stop y los objetivos.
Si el bot va a operar, utiliza una conexión independiente a mi exchange. Crea primero un modo de prueba sin órdenes reales. Acuerda conmigo los parámetros de riesgo, el tamaño de la operación y el permiso para operaciones reales.
Gestiona los errores y los límites de la API. Proporciona código listo para usar e instrucciones de inicio paso a paso para mi sistema.

Para Telegram necesitas el token de tu bot de Telegram y el ID del chat. Para operar, claves independientes de tu exchange con permiso de trading y sin permiso de retirada de fondos. Estos datos se guardan en tu configuración del bot. No es necesario facilitárselos a LOGRI.

3. Comprueba la conexión

Comprobar la clave en esta página

Introduce una clave existente de la API de LOGRI. La comprobación leerá hasta tres respuestas pequeñas. La clave solo se envía a la API de este sitio y no se guarda en el navegador.

La clave completa contiene 72 caracteres y se muestra una sola vez al crearla en cuenta → Acceso → Conectar tu bot. En la lista de claves guardadas solo se muestra una identificación abreviada. Si no conservas la clave completa, crea una independiente con el nombre «Comprobación de Intelligence». Introduce solo la clave, sin la palabra Bearer ni comillas. No envíes la clave real al chat.

La comprobación utiliza el límite normal de la API. No inicia escaneos, operaciones, mensajes ni gestión de claves. El estado de las fuentes y la vigencia de las señales se evalúan por separado.

Inicia el bot y comprueba que recibe una respuesta de Radar. Verifica el envío de un mensaje al chat correcto. Si planeas operar automáticamente, comprueba primero la selección del par, la dirección, el tamaño de la operación, el stop y los objetivos en un modo sin órdenes reales.

La API de LOGRI transmite datos e inicia escaneos. Tu bot coloca la orden en el exchange mediante la conexión al exchange. Las condiciones de entrada y el tamaño de la posición se establecen en tu bot.

Límites de la conexión

Hasta tres claves activas por cuenta.
Hasta 60 solicitudes por minuto y clave.
Cada escáner puede ejecutarse como máximo una vez cada dos minutos por cuenta. Para uso continuo, utiliza un intervalo de cinco minutos.
Cuando el acceso a Radar termina o se desactiva, la API deja de responder con esa clave. Una clave revocada tampoco funciona.

Leer señales no inicia un escaneo. El servidor de Radar actualiza la lista general sin que la página esté abierta. Para una lista de pares independiente, puedes configurar la ejecución periódica del escáner correspondiente.

Datos para configurar el bot

Esta sección sirve para el código de conexión. Puedes facilitarla a la persona que escribe el bot o a la IA junto con la tarea anterior.

Solicitudes

Todas las solicitudes se envían a https://radar.logri.group. La clave se transmite en la cabecera Authorization: Bearer.

POST /api/v1/scan: Escaneo ABCD. El cuerpo contiene la lista de pares.
POST /api/v1/scan-movers: Escaneo de movimientos y reversiones. La misma lista de pares.
GET /api/v1/signals: Recepción de señales y actualizaciones de su estado.

curl -X POST 'https://radar.logri.group/api/v1/scan' \
  -H "Authorization: Bearer $LOGRI_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{"symbols":["BTCUSDT","ETHUSDT"]}'

curl 'https://radar.logri.group/api/v1/signals?limit=100&model=all' \
  -H "Authorization: Bearer $LOGRI_API_KEY"

Señales nuevas y solicitudes repetidas

La respuesta contiene signals, nextCursor, hasMore y generatedAt. En el primer inicio, establece since — la hora UTC actual en milisegundos, por ejemplo Date.now(). Esto permite empezar con señales nuevas.

Guarda nextCursor y envíalo como cursor en las solicitudes siguientes, con codificación URL. Consérvalo entre reinicios del bot. Si hasMore=true, termina de leer las páginas siguientes; en caso contrario, repite la solicitud al cabo de un minuto. Cuando nextCursor=null, sigue utilizando el valor original de sincehasta obtener un cursor.

Elimina duplicados por id + times.updatedAt. Una señal con el mismo ID puede cambiar de estado. La API muestra el estado actual del registro: si cambió varias veces entre solicitudes, algunos cambios intermedios pueden no aparecer en la respuesta.

Parámetro	Valores
`model`	`all`, `abcd`, `movers`, `reversal`
`status`	`all`, `waiting_entry`, `active`, `closed`, `expired`
`limit`	De 1 a 200; por defecto, 100.
`since`	Marca de tiempo UTC inicial en milisegundos.
`cursor`	Valor nextCursor de la respuesta anterior.

Para seguir los cierres, mantén status=all. No cambies los filtros al continuar una misma selección mediante cursor. La lectura devuelve el historial general de Radar, no una lista de pares exclusiva de tu bot; filtra los pares necesarios en tu código.

Qué comprobar antes de entrar

market.source y market.contract — exchange y nombre exacto del contrato. Los precios corresponden a este contrato. Los contratos con multiplicador 1000 no deben sustituirse por un par normal de otro exchange.
direction — long o short; levels.entry, levels.stopLoss, levels.targets — entrada, stop y objetivos.
status: waiting_entry — entrada aún no confirmada; active — señal en curso; closed — cerrada; expired — plazo finalizado.
actionable=true — la señal ha superado las comprobaciones de niveles, fuente y vigencia de la confirmación. No utilices una señal con actionable=false para una entrada nueva.
times.expiresAt — plazo de validez; times.entryFreshUntil — plazo de vigencia de la confirmación. Una confirmación se considera reciente durante un máximo de dos minutos. Vuelve a comprobar la hora antes de ejecutar la operación.

score — evaluación del modelo, no probabilidad de beneficio. Los campos result describen el resultado calculado de la señal según las velas, no el beneficio real de tu bot. Los costes indicados corresponden al cálculo de la operación y no son una tarifa de la API. Este cálculo no incluye la financiación.

Si la solicitud falla

Código	Qué hacer
400	Comprobar los parámetros de la solicitud y el JSON.
401	Comprobar la clave: puede ser incorrecta o haber sido revocada.
403	Comprobar el acceso activo a Radar.
429	Reintentar tras la espera indicada en la cabecera Retry-After.
503	Esperar y repetir la solicitud aumentando el tiempo de espera.

La clave está destinada a tu bot o a una integración acordada. La difusión pública o reventa de señales requiere un acuerdo independiente con LOGRI.