Conecta Bybit a Freya
Bybit es el único exchange donde Freya puede configurar la conexión por ti. Freya es un bróker registrado de Bybit, lo que significa que Bybit creará la clave API en su propio lado, le asignará los permisos correctos y se la entregará directamente a Freya — nunca ves una clave, nunca copias un secreto y nunca incluyes una dirección IP en una lista blanca.
Esa vía se llama Conexión rápida. La vía más antigua, en la que tú mismo creas la clave en Bybit, sigue existiendo y sigue funcionando. Esta guía cubre ambas, además de qué hacer cuando necesitas reemplazar una clave o cuando una conexión falla.
Key Takeaways
- La Conexión rápida es un clic: apruebas a Freya en Bybit, y tus claves de Spot y Futuros se agregan automáticamente.
- La Conexión rápida no necesita lista blanca de IP — Bybit vincula la clave por sí mismo a los servidores de Freya, que es también la razón por la que no expira.
- La Conexión manual sigue funcionando y es la única vía en Binance y OKX.
- Uses la vía que uses, la clave nunca recibe permiso de retiro. Freya no puede mover tus fondos.
- Conectar una segunda vez no crea duplicados — Bybit emite una clave por plataforma por cuenta, así que renueva lo que ya tienes.
Antes de Empezar
Vale la pena comprobar dos cosas primero.
Fondea la cuenta que vas a conectar. Un bot no puede abrir una posición con un saldo vacío, y Freya conectará sin problema una clave que no tenga nada con qué operar. Si planeas ejecutar bots de futuros, asegúrate de que los fondos estén en la cuenta que tus bots van a usar.
Usa un navegador. Ambas vías funcionan en navegadores de escritorio y móviles. Crear una clave API a mano es una tarea exclusiva del navegador en el lado de Bybit — su aplicación móvil no muestra la pantalla de claves API.
Conexión Rápida
Esta es la vía que recomendamos. Toma unos quince segundos si ya tienes la sesión iniciada en Bybit.
- En Freya, abre Configuración → Claves API y selecciona Agregar clave API.
- Elige Bybit como exchange. La pestaña Conexión rápida ya está seleccionada.
- Selecciona Conectar con Bybit. Se abre una pestaña de Bybit.
- Inicia sesión en Bybit. Si aún no tienes cuenta, puedes crear una allí mismo y volver — la conexión te espera.
- Revisa y aprueba. Bybit te muestra exactamente qué está pidiendo Freya. Aprobar es el único paso que concede algo.
- La pestaña se cierra sola y tus claves aparecen en Freya, listas para usar.
Una sola aprobación cubre tanto Spot como Futuros. No repites esto por cada mercado.
Qué Ocurre Tras Bambalinas
Cuando apruebas, Bybit crea una clave API vinculada al registro de bróker de Freya y la envía directamente a los servidores de Freya. Como llega por esa vía, nunca pasa por tu navegador, tu portapapeles ni una captura de pantalla — que es como más a menudo se filtran las claves API.
Bybit también vincula esa clave a los servidores de Freya por sí mismo. Dos consecuencias de las que te beneficias:
- Sin lista blanca de IP. No hay nada que debas copiar o pegar en la configuración de Bybit.
- La clave no expira. Una clave que creas a mano puede expirar; una vinculada al bróker, no.
Si Cambias de Opinión
Rechazar en la pantalla de Bybit es completamente seguro. No se crea nada en Bybit y nada cambia en Freya — simplemente verás que la autorización no se completó, y puedes intentarlo de nuevo cuando quieras.
Cerrar la pestaña de Bybit sin decidir tiene el mismo efecto.
Reemplazar una Clave de Bybit
A veces necesitas una clave nueva — revocaste la anterior en Bybit, te estás mudando a otra cuenta de Bybit, o soporte te pidió que volvieras a conectar.
Con la Conexión rápida, simplemente conéctate de nuevo. Abre Configuración → Claves API → Agregar clave API, elige Bybit y selecciona Conectar con Bybit como antes. Bybit emite una clave por plataforma por cuenta, así que reconectar renueva lo que ya tienes en lugar de apilar una segunda copia. Tus bots existentes siguen funcionando con la credencial renovada.
Si primero eliminaste la clave en el lado de Bybit, reconectar también es la solución — Bybit emitirá una nueva al aprobar.
⚠️ No elimines tu clave de Freya mientras haya bots en ejecución, a menos que tengas la intención de detenerlos. Un bot en ejecución sin una credencial que funcione no puede gestionar la posición que ya abrió. Detén o cierra tus bots primero, y luego reconecta.
Conexión Manual
Usa esta vía si prefieres crear la clave tú mismo, o si estás conectando una subcuenta de Bybit.
Crea la Clave en Bybit
- Inicia sesión en Bybit en un navegador y abre la sección API de tu cuenta.
- Crea una clave API generada por el sistema.
- Elige Transacción API como tipo de uso — no solo lectura.
- Concede los permisos de Trading de Contratos y Trading Spot, además del acceso de lectura.
- Nunca concedas Retiro. Freya no lo necesita y no puede usarlo.
- Restringe la clave por IP e ingresa la dirección de Freya, que el modal te muestra y te deja copiar.
⚠️ Bybit muestra tu clave secreta exactamente una vez. Cópiala antes de cerrar esa pantalla. Si la pierdes, la clave no puede recuperarse — tienes que crear una nueva.
Agrega la Clave a Freya
- En Freya, abre Configuración → Claves API → Agregar clave API y elige Bybit.
- Cambia a la pestaña Conexión manual.
- Pega la clave API y el secreto, y asígnale a la clave un nombre que reconozcas más tarde.
- Selecciona Agregar clave API. Freya valida la conexión y los permisos de inmediato.
Si la validación falla, Freya te dice exactamente qué parte falló en lugar de un error genérico. Consulta ¿No Puedes Conectar Tu Exchange? Soluciona los Errores de Conexión de Clave API para cada mensaje y su solución.
Preguntas Frecuentes
¿Qué vía debería usar?
La Conexión rápida, a menos que tengas una razón concreta para no hacerlo. Son menos pasos, no puede fallar por un error de tipeo y elimina por completo la lista blanca de IP. La Conexión manual existe para quienes quieren crear y controlar la clave por sí mismos, y para las subcuentas.
¿La Conexión rápida le da a Freya más acceso que una clave manual?
No. Ambas vías producen una clave de trading con el mismo alcance: lectura y trading, nunca retiro. La diferencia está en quién hace la configuración, no en lo que la clave puede hacer.
¿Necesito incluir una dirección IP en una lista blanca?
Solo con la Conexión manual. Con la Conexión rápida, Bybit vincula la clave a los servidores de Freya automáticamente, que es también la razón por la que esa clave no expira.
¿Puedo conectar Bybit Spot y Futuros por separado?
Con la Conexión rápida no hace falta — una sola aprobación configura ambos. Con la Conexión manual puedes agregar claves separadas si prefieres mantener los mercados aparte.
¿Qué pasa si me conecto dos veces?
Nada se rompe y nada se duplica. Bybit emite una clave por plataforma por cuenta, así que una segunda conexión renueva la existente.
¿Puedo usar la Conexión rápida con una subcuenta de Bybit?
Usa la Conexión manual para las subcuentas. La Conexión rápida está pensada para tu cuenta principal de Bybit.
¿Está segura mi clave una vez que está en Freya?
Se cifra en el momento en que llega y nunca vuelve a mostrarse — ni a ti, ni a soporte. Eliminarla en Freya borra la credencial almacenada, y revocarla en Bybit corta el acceso desde el otro lado. Para el panorama completo, consulta ¿Está Seguro Mi Dinero en Freya Finance?.
Freya dice que mi clave es inválida justo después de conectar. ¿Por qué?
Lo más frecuente es que la clave se creó sin permiso de trading, o que se restringió a una IP que no es la de Freya. Con la Conexión rápida ninguna de las dos cosas puede ocurrir, así que reconectar por esa vía suele ser la solución más rápida.