Conexión de exchanges y claves API
Qué exchanges soporta LootX, qué permisos dar a la clave API, cómo añadir una conexión, configurar un proxy y entender el estado de la conexión por el color.
Una conexión es el vínculo del terminal con tu cuenta en el exchange mediante una clave API. Sin ella, el libro de órdenes, la cinta de operaciones y los gráficos funcionan, pero el terminal no ve tus órdenes, posiciones ni saldo, y no se puede operar. Aquí verás qué exchanges son compatibles, cómo crear una clave y con qué permisos, cómo añadir una conexión, pasarla por un proxy y entender por el color qué está ocurriendo con ella.
Exchanges y mercados
En la lista de exchanges hay dos grupos.
| Grupo | Plataformas | Qué ofrece |
|---|---|---|
| Trading y datos | Binance, Bybit, OKX, Bitget, Gate.io, MEXC, KuCoin, BingX, Hyperliquid, Aster | Libro de órdenes, cinta de operaciones, gráficos, tus órdenes y posiciones, trading. Spot y futuros. |
| Solo datos | Binance Alpha, Upbit (spot) | Libro de órdenes, cinta de operaciones y gráficos. No hay trading, no se necesitan claves. |
Puedes añadir varias conexiones a un mismo exchange, por ejemplo, para distintas subcuentas. Si el exchange no está incluido en tu plan, al seleccionarlo el terminal te ofrecerá una suscripción; consulta Suscripciones.
Qué clave crear en el exchange
La clave se crea en la sección de gestión de API del sitio web del exchange. El terminal necesita:
- Lectura — para ver saldo, órdenes y posiciones.
- Trading en los mercados donde vayas a operar: spot, futuros o ambos.
Restricción por IP. Si el exchange permite limitar la clave a una lista de direcciones IP, conviene hacerlo. Indica la dirección desde la que el terminal realmente sale al exchange: tu IP externa o, si las órdenes van por un proxy, la IP del proxy. Con una salida directa de respaldo (más abajo), si el proxy se cae, el exchange verá tu propia IP y rechazará las solicitudes.
Passphrase. OKX, Bitget y KuCoin piden crear una passphrase al generar la clave. No es la contraseña de la cuenta: es una tercera parte de la clave que hay que introducir en el terminal junto con la key y el secret.
Cómo añadir una conexión
Abre la lista de conexiones
Engranaje en el panel superior de la ventana → Conexiones. Arriba se ve cuántas conexiones hay y cuántas están activas.
Pulsa «+ Añadir conexión»
Se abrirá el formulario Añadir conexión.
Ponle nombre y elige el exchange
Nombre de la conexión — cualquiera, por ejemplo «Binance_main»; al lado puedes elegir un color para distinguir las conexiones en los paneles. Exchange — lista con búsqueda. Una vez introducidas las claves, el exchange no se puede cambiar: para otro exchange crea una conexión nueva.
Pega las claves
Normalmente son API Key y API Secret; en OKX, Bitget y KuCoin, además Passphrase. Hyperliquid y Aster tienen campos propios, ver más abajo.
Elige los mercados
Los interruptores Spot y Futuros determinan en qué mercados operará esta conexión. Conexión automática — conectarse nada más arrancar el terminal.
Pulsa «Guardar»
Los cambios se aplican de inmediato, a medida que escribes. Guardar cierra el formulario, Cancelar revierte los cambios y, en una conexión recién creada, la elimina.
En la lista, cada fila tiene un interruptor —enciende y apaga la conexión sin eliminarla— y una marca en la columna Auto para la conexión automática. Para modificar una conexión, haz clic en la fila. Eliminar conexión en el formulario la borra junto con las claves, sin posibilidad de recuperarla.
Las claves se guardan cifradas en el archivo de configuración y solo se descifran en este equipo. Al exportar la configuración no se incluyen.
Hyperliquid
Hyperliquid no tiene el par «key + secret»: el único campo Private Key / Seed acepta la clave privada del monedero.
- Clave de API-wallet (también llamada agent) — la opción recomendada. Se crea en el sitio de Hyperliquid y puede operar, pero no retirar fondos. El terminal localiza por sí mismo la cuenta principal a la que está vinculado el API-wallet y muestra su saldo y sus posiciones. Las acciones de nivel de cuenta —por ejemplo, transferencias— no las puede firmar el API-wallet; hazlas en el sitio de Hyperliquid.
- Clave del propio monedero también sirve, pero da acceso total a los fondos.
Hyperliquid identifica la cuenta por la firma de la clave. Si en esa dirección no hay depósito, el terminal avisará de que el exchange rechazó la clave; revisa la clave y el fondeo.
Aster
Aster tiene dos tipos de clave; el formulario acepta ambos:
- clave API normal — en los campos API key / API wallet address y API secret / Private key;
- API-wallet — su dirección y su clave privada en esos mismos dos campos, y en Account Id la dirección del monedero principal (0x…).
Proxy
El proxy es necesario si el exchange no es accesible desde tu país o si la clave está restringida a la IP del proxy.
Añade el proxy
Ajustes → Proxy → + Añadir proxy. Rellena Nombre, Dirección (host y puerto) y, si hace falta, Usuario y Contraseña. El protocolo —SOCKS5, HTTP o HTTPS— lo detecta el terminal.
Compruébalo
El botón Comprobar hace una prueba contra el proxy y muestra el resultado: «OK: el proxy SOCKS5 responde», «No responde: …» o «El puerto está abierto, pero no es un proxy SOCKS5/HTTP». Después, Guardar.
Selecciona el proxy en la conexión
En el formulario de conexión, sección Proxy: elige el proxy y marca qué debe pasar por él: Órdenes y cuenta, Datos de mercado o ambos. La selección para datos de mercado se aplica a todas las conexiones de ese exchange.
En la página Proxy hay un interruptor «Pasar a conexión directa si el proxy no está disponible». Está activado por defecto: si el proxy se cae, el terminal sale al exchange directamente para no perder datos.
Si el proxy responde «El proxy … rechaza el usuario/contraseña (407)», revisa el usuario, la contraseña y la vigencia de la suscripción con tu proveedor de proxy.
Estado de la conexión
En la fila de la conexión, junto a los mercados, hay un punto de estado. Pasa el cursor por encima: la información emergente te dará los detalles.
| Vista | Qué significa |
|---|---|
| Punto verde | Conectada: los datos fluyen y el trading está activo. |
| Anillo amarillo pulsante | Se está conectando o el trading se está reconectando. La información emergente mostrará la última causa del fallo, si la hubo. El terminal reintenta solo. |
| Anillo rojo, sin parpadeo | No hay comunicación con el exchange, el exchange rechazó la clave o el trading está desactivado manualmente. |
| Sin punto | La conexión está apagada. |
Junto al nombre hay un icono de modo: flechas verdes en una conexión de trading, ojo gris en una plataforma de «solo datos».
Activar y desactivar el trading sobre la marcha es cómodo desde la ventana principal: un clic en la franja de exchanges del panel superior abre la lista de conexiones con los botones Conectar y Desconectar y el enlace Ajustes de conexiones ›.
Si el exchange rechazó la clave
El terminal muestra de inmediato el mensaje «…: el exchange rechazó la API key o el secret; revísalos en los ajustes de conexión», y el punto de conexión se ilumina en rojo con la indicación «El exchange rechazó la API key o el secret». Revisa la key, el secret y la passphrase: un espacio de más al pegar, una clave eliminada en el exchange o una clave de otra subcuenta.
En cambio, si la clave es correcta pero le falta un permiso o tu IP no está en la lista permitida, no hay mensaje propio: el terminal muestra el texto del exchange tal cual. Busca ahí el código y abre la página de tu exchange en la sección Mensajes de error.
La diferencia horaria entre el ordenador y el exchange la corrige el terminal solo; no hay que configurar nada.
Modo «solo lectura»
Si desde un panel no se puede operar en ese momento, aparece un icono de ojo. Pasa el cursor por encima: la información emergente dirá el motivo:
| Información emergente | Qué hacer |
|---|---|
| «Solo lectura: esta plataforma no tiene trading; llegan libro de órdenes, cinta de operaciones y gráficos» | Nada: así son Binance Alpha y Upbit. |
| «Solo lectura: no hay conexión a este exchange. Créala en los ajustes» | Añade una conexión con clave. |
| «Solo lectura: la conexión está apagada en los ajustes» | Activa la conexión. |
| «Solo lectura: el mercado de este panel no está conectado ahora; esperando a que se restablezca» | Espera: el terminal se reconecta solo. |
Si en ese estado pulsas un botón o un atajo de teclado de trading, la orden no se enviará y el terminal mostrará «⚠ Exchange no conectado», «⚠ Conexión apagada» o «⚠ Esta plataforma no tiene trading».