Documentación
¿Qué quieres hacer?
Conectar Lighter
Lighter (Lighter Core) usa una API key vinculada a tu cuenta: una clave pública y una privada que pueden operar, pero no enviar fondos a otra dirección: Lighter solo permite retirar a la wallet dueña de la cuenta. MyLiquidBot también necesita la dirección de wallet L1 dueña de la cuenta. El índice de cuenta y el índice de API key se detectan automáticamente al guardar.
La cuenta de Lighter debe crearse con tu propia wallet (no email ni login social). Cualquier tier sirve para conectarla, operar en manual y usar Delta Neutral. Los demás bots que pagan comisión de MyLiquidBot necesitan Plus o Premium, porque Lighter no permite cobrar comisión de integrador a las cuentas Standard; el creador de bots te avisa antes de crear uno.
En Agregar conexión elige Lighter, deja seleccionado Quick Connect y firma un mensaje con la wallet de tu cuenta de Lighter. MyLiquidBot crea la API key en un hueco libre de tu cuenta principal, así que tus otras claves siguen funcionando. No mueve fondos ni cuesta gas. La aprobación de Integrator Fee sigue siendo un paso aparte. Si prefieres crearla tú, elige Pegar API key y sigue las partes 1 y 2.
Tier de cuenta de Lighter Core y fees
| Tier Lighter Core | Fee nativa maker / taker | Con MyLiquidBot |
|---|---|---|
| Standard | 0 / 0 | Manual, Delta Neutral y bots sin comisión de MyLiquidBot |
| Plus | 0,005 % / 0,005 % | Todos los bots |
| Premium | 0,004 % / 0,028 % base (puede haber descuentos) | Todos los bots |
Las fees nativas las cobra Lighter y son aparte de las de MyLiquidBot. Revisa las tarifas vigentes del exchange antes de operar. Puedes cambiar el tier en Lighter o desde Gestionar → Change tier una vez verificada la conexión; Lighter puede rechazar el cambio con órdenes o posiciones abiertas o durante un periodo de espera, y el cambio también afecta a tu trading fuera de MyLiquidBot.
Parte 1 — Crear la API key en Lighter
Abre la página de API keys
Conecta tu wallet en app.lighter.xyz y abre app.lighter.xyz/apikeys.
Genera una API key estándar
Copia la clave pública y la clave privada. La privada solo se muestra una vez. No marques la key como maker-only: la activación de trading exige una API key estándar (no maker-only).
Anota tu dirección de wallet
La dirección EVM con la que te conectaste a Lighter es la dirección de wallet L1.
Parte 2 — Agregar la conexión en MyLiquidBot
Ve a Cuenta → Exchanges → Agregar conexión, elige Lighter, confirma que la cuenta se creó con wallet y el aviso de tier, y rellena:
| Campo en MyLiquidBot | Qué poner |
|---|---|
| Clave pública | La clave pública de la API key (texto hexadecimal largo). |
| Lighter API Key - Private Key | La clave privada de la API key. Nunca la clave privada ni la frase semilla de tu wallet. |
| Dirección de wallet L1 (Ethereum) | La wallet 0x… que usas en Lighter. |
| Índice de cuenta / Índice de API key | Déjalos vacíos: se rellenan solos al guardar y verificar. |
| Valores opcionales (Auth Token, API URL, WebSocket URL) | Déjalos vacíos salvo que soporte te pida cambiarlos. |
Pulsa Guardar y verificar. MyLiquidBot localiza tu cuenta, empareja la clave pública con una API key de esa cuenta y revisa sus permisos.
Parte 3 — Activar trading (Integrator Fee)
En el paso de activación o en Gestionar → Aprobación de Integrator Fees, pulsa Aprobar integrador y firma con la misma wallet L1 guardada en la conexión. No mueve fondos ni permite retiros. Cuando el panel muestra Integrador aprobado, la conexión puede operar.
Parte 4 — Leverage y modo de margen
En Lighter, el leverage y el modo Cross/Isolated se guardan en el exchange por mercado. Al crear un bot o enviar una orden manual, el leverage y el modo que elijas se sincronizan automáticamente. El panel Lighter · Configuración de leverage en Gestionar permite fijarlos de antemano para un mercado y muestra los ajustes guardados desde esa pantalla.
Solución de problemas
| Mensaje o síntoma | Causa probable | Solución |
|---|---|---|
| “La clave pública API configurada de Lighter no aparece en esta cuenta.” / “The configured public key does NOT match any API key on this account.” | La clave pública es de otra key u otra cuenta, o la key se borró. | Copia de nuevo la clave pública desde app.lighter.xyz/apikeys (o de la lista que muestra Gestionar) y edita la conexión. Si la key se borró, crea otra. |
| “Lighter no aceptó esta API key para la cuenta guardada…” | Clave privada, cuenta e índice de API key no son de la misma cuenta. | Edita la conexión, pega la clave pública y privada de la misma API key, deja ambos índices vacíos y guarda. |
| “This Lighter API key is maker-only…” | La key se creó como maker-only. | Quita esa restricción en Lighter o crea una API key estándar y actualiza la conexión. |
| “Tu cuenta de Lighter es Standard. Por limitaciones de Lighter, este bot necesita una cuenta Plus o Premium.” | La cuenta es Standard y el bot paga comisión de MyLiquidBot. | Cambia a Plus o Premium (en Lighter o con Gestionar → Change tier) y pulsa Volver a comprobar en el creador. |
| “Selected wallet … does not match the Lighter L1 wallet …” | Hay otra cuenta seleccionada en la wallet. | Selecciona la wallet L1 guardada en la conexión y firma de nuevo. |
| “Hay otra operación de Lighter en curso con esta API key.” | Se enviaron dos operaciones a la vez. | Espera un minuto y reinténtalo. No repitas la acción varias veces. |
| Formulario del bot: “No hay leverage ni modo de trading guardados localmente para este mercado…” | El leverage o el modo de ese mercado aún no se han sincronizado. | Cambia el leverage o el modo en el formulario (se sincroniza solo) o fíjalo en Gestionar → Configuración de leverage y crea el bot. |
| Errores de nonce o firma en órdenes | La API key se sustituyó o revocó en Lighter. | Pausa los bots afectados, crea una API key nueva, edita la conexión y reanuda cuando verifique. |