Tus claves API son lo que permite a Freya colocar operaciones en tu exchange por ti. Una vez que has conectado un exchange, todas tus claves viven en un solo lugar donde puedes revisarlas, ver exactamente qué tiene permitido hacer cada una, agregar más o eliminar las que ya no uses. Esta guía cubre cómo gestionarlas.
Si estás conectando un exchange por primera vez, empieza con Cómo Conectar tu Exchange — este artículo trata sobre la gestión de las claves que ya has agregado.
Puntos clave
- Todas tus claves API de exchange conectadas viven en Configuración → Claves API, mostrando el exchange, una etiqueta, cuándo se agregó y su estado.
- Cada clave muestra sus permisos — acceso de Lectura, Operación y (para futuros) Futuros — para que puedas ver exactamente qué permite.
- Puedes agregar otra clave en cualquier momento, o eliminar una que ya no uses.
- Freya no elimina una clave mientras un bot la esté usando — detén o pausa esos bots primero; la eliminación no se puede deshacer y recibes una notificación cada vez que se elimina una clave.
- Tus credenciales API se almacenan cifradas, y Freya nunca necesita permiso de retiro sobre tus claves.
Un Repaso Rápido de los Pasos
- Abre tu lista de claves — ve a Configuración → Claves API para ver cada exchange conectado, cada uno con su etiqueta, la fecha en que se agregó y su estado.
- Revisa los permisos de cada clave — confirma que muestra Lectura y Operación (y Futuros si operas futuros), y nunca acceso de retiro.
- Agrega una clave cuando la necesites — usa Agregar clave API para conectar otro exchange o una clave adicional, siguiendo el mismo flujo que tu primera conexión.
- Elimina las claves que ya no uses — elige Eliminar y confirma. Si un bot todavía usa esa clave, Freya rechaza la eliminación y te dice cuántos hay; detenlos o páusalos primero.
Dónde Encontrar tus Claves API
Ve a Configuración → Claves API. Verás Tus claves API — una lista de cada conexión de exchange en tu cuenta. Para cada una, Freya muestra:
- El exchange (Binance, OKX o Bybit).
- Una etiqueta para la clave, para que puedas distinguir varias entre sí.
- La fecha en que se agregó.
- Su estado (Activa).
Si aún no has conectado nada, verás en su lugar un aviso de Agrega tu primera clave API.
Comprendiendo los Permisos de las Claves
Cada clave muestra los permisos con los que fue creada, para que nunca haya dudas sobre lo que puede hacer:
- Lectura — permite a Freya ver tus saldos y posiciones (necesario para todo).
- Operación — permite a Freya colocar y gestionar órdenes (esto es lo que tus bots usan para operar).
- Futuros — presente cuando la clave también tiene habilitado el acceso de trading de futuros.
Esta transparencia importa: una clave de Freya es solo para lectura y operación. No tiene — ni debería tener — permiso de retiro, así que tus fondos nunca pueden salir de tu exchange a través de Freya. Para el panorama completo, consulta ¿Está Seguro mi Dinero en Freya Finance?.
Agregar Otra Clave
Puedes conectar más de un exchange (o más de una clave) desde la misma pantalla usando Agregar clave API. La configuración es el mismo flujo que tu primera conexión — consulta Cómo Conectar tu Exchange para el paso a paso, incluyendo la passphrase de OKX.
Eliminar una Clave
Para quitar una conexión, elige Eliminar en la clave y confirma. Algunas cosas que debes saber:
- No se puede deshacer. Tendrías que agregar la clave de nuevo desde cero para reconectarla.
- Freya comprueba antes de eliminar. Si algún bot está operando con esa clave, o está armado esperando para operar, la eliminación se rechaza y se te indica cuántos bots están implicados. Detenlos o páusalos desde tu panel y vuelve a intentarlo — un bot que pierde su clave a mitad de una operación ya no puede gestionar la posición que abrió.
- Recibes una notificación cuando se elimina una clave — un detalle de seguridad para que siempre sepas cuándo cambia el acceso.
Tus Claves se Almacenan de Forma Segura
Freya almacena tus credenciales API cifradas — la pantalla de Claves API incluso las etiqueta como almacenadas de forma segura. Combinado con claves que no tienen permiso de retiro, esto significa que incluso en el peor de los casos, nadie puede mover fondos fuera de tu cuenta de exchange a través de Freya.
Preguntas Frecuentes
¿Dónde gestiono las claves API de mi exchange?
En Configuración → Claves API. Esa pantalla lista cada clave conectada con su exchange, etiqueta, la fecha en que se agregó y su estado — y es donde agregas nuevas claves o eliminas las existentes.
¿Qué significan las etiquetas de Lectura, Operación y Futuros?
Muestran lo que cada clave tiene permitido hacer. Lectura permite a Freya ver tus saldos y posiciones; Operación le permite colocar y gestionar órdenes (lo que usan tus bots); y Futuros aparece cuando la clave también tiene acceso de trading de futuros. Una clave de Freya nunca necesita permiso de retiro.
¿Cómo agrego otro exchange o clave?
Usa Agregar clave API en la misma pantalla. Ejecuta el mismo flujo de conexión que tu primera clave — consulta la guía Cómo Conectar tu Exchange para el recorrido completo, incluyendo la passphrase adicional de OKX.
¿Qué pasa cuando elimino una clave API?
Freya comprueba si algo todavía depende de ella. Si un bot está operando con esa clave, o está armado esperando una señal, la eliminación se rechaza y verás cuántos bots están implicados — detenlos o páusalos y después elimina. Cuando nada dependa de la clave, la conexión se elimina y no se puede deshacer. También recibirás una notificación confirmando que la clave fue eliminada.
¿Mis claves API se almacenan de forma segura?
Sí. Tus credenciales se almacenan cifradas, y las claves que conectas tienen acceso de operación solamente — nunca permiso de retiro. Esa combinación significa que tus fondos no pueden ser retirados de tu exchange a través de Freya.
¿Puede Freya retirar mis fondos usando mi clave API?
No. Las claves se crean con acceso de lectura y operación solamente — no de retiro. Incluso si algo saliera mal, nadie podría mover tus fondos fuera del exchange usando una clave de Freya.
¿Cómo edito los permisos de una clave API, la roto o la deshabilito?
No existe una edición directa de una clave conectada. Para cambiar permisos, rotar o sustituir una clave, la eliminas de Freya y añades la nueva — crea la clave actualizada en tu exchange y vuelve a conectarla. Detén o pausa primero los bots que usen la clave antigua, ya que Freya no elimina una clave en uso; una vez conectada la nueva, apunta esos bots a ella y vuelve a iniciarlos. Para dejar de usar una clave sin eliminarla, pausa los bots que dependen de ella en lugar de borrar la clave.