Claves de exchange de solo lectura, explicadas: lo que puede hacer una clave y lo que rechazamos

Lo que una clave de exchange de solo lectura puede y no puede hacer, cómo Burokku revisa una clave antes de guardarla y por qué siempre rechaza una que puede retirar.

Por el equipo de BurokkuPublicado el 7 dic 20265 min de lectura

Para mostrar lo que tienes en un exchange, Burokku necesita una clave API que creas en la configuración de ese exchange. Los permisos que marcas al crearla deciden todo lo que una app puede hacer con ella. Burokku lee más de 10 exchanges de esta forma, y lo primero que hace con cualquier clave que pegas es averiguar qué tiene permitido hacer.

Lo que una clave de solo lectura puede y no puede hacer

Una clave que solo tiene activada la lectura le permite a Burokku ver:

  • tus saldos en cada billetera dentro de la cuenta: spot, fondos, earn, futuros y las demás;
  • tus posiciones abiertas de futuros;
  • tu historial: depósitos, retiros, operaciones y pagos de financiamiento.

No puede colocar, cambiar ni cancelar una orden, y no puede retirar ni transferir nada. Si alguien la copiara, podría ver tus saldos y nada más.

Los exchanges no nombran estos permisos de la misma forma, así que leemos la respuesta de cada uno en lugar de adivinar:

  • Binance muestra las transferencias internas y universales aparte de los retiros. Contamos ambas como retirar.
  • Kraken tiene permisos separados para agregar o cambiar una dirección de retiro. También los contamos como retirar.
  • Bybit crea cada clave como de solo lectura o de lectura y escritura. Solo una de solo lectura se conecta para leer.
  • Coinbase tiene un único permiso que cubre mover fondos hacia adentro y hacia afuera. Una clave con ese permiso se rechaza.

Cómo crear una clave API de Binance de solo lectura recorre las pantallas de un exchange; Burokku te muestra los pasos propios de cada exchange cuando lo conectas.

Cómo Burokku revisa una clave antes de guardarla

Cuando pegas una clave, Burokku le pregunta al exchange qué puede hacer la clave antes de guardar nada. Una clave conectada para leer tiene que poder leer, y no debe poder operar ni retirar. Si puede hacer cualquiera de las dos cosas, se rechaza y se te dice qué permiso quitar. No se guarda nada.

¿Por qué rechazar una clave que puede retirar, aunque confíes en nosotros? Porque la clave más segura de guardar es una que no puede mover dinero en absoluto: una copia robada no puede vaciar tu cuenta. Por eso nunca aceptamos una "por si acaso".

Una clave que pasa la revisión se lee una vez en ese momento, así que ves tus saldos reales antes de ponerle nombre a la cuenta. Cuando el exchange nos dice de quién es la cuenta a la que pertenece una clave (Bybit lo hace), se rechaza una segunda clave para una cuenta que ya agregaste, para que no se cuente dos veces.

La revisión no termina al conectar. Burokku le vuelve a preguntar al exchange por los permisos de cada clave una vez al día. Si una clave de solo lectura ganó el permiso de operar o retirar, Burokku la elimina, mantiene tus últimos saldos en pantalla y te avisa una vez, en la app y por correo. Cada clave que conectas, y cada clave que eliminamos, queda en el registro de auditoría de tu cuenta.

Dónde vive tu clave

Una clave que conectas se cifra en nuestros servidores con una clave creada solo para tu cuenta, y queda vinculada a esa cuenta y a ese exchange, así que una copia llevada a cualquier otro lugar no se puede abrir. Nada fuera del espacio propio de tu cuenta llega a ver la clave sin cifrar.

Una vez que la pegaste, la clave nunca vuelve a enviarse a un navegador, ni al nuestro ni al tuyo. La app solo muestra sus últimos cuatro caracteres. Cómo funciona la seguridad explica el resto de lo que se guarda y dónde.

Cuando una clave deja de funcionar

Las claves dejan de funcionar por motivos comunes: eliminaste una, cambiaste su lista de IP permitidas o el exchange la dio de baja. Lo que hace Burokku depende de si el exchange rechazó la clave o si solo es difícil comunicarse con él.

  • El exchange rechaza la clave. Una vez puede ser un mal momento del exchange, así que Burokku espera cinco minutos y vuelve a intentarlo. Si la rechaza dos veces seguidas, deja de usar la clave y te avisa una vez, en la app y por correo. No sigue intentándolo en segundo plano; algunos exchanges bloquean una clave que falla una y otra vez. Solo vuelve a intentarlo cuando reemplazas la clave o le pides que la revise de nuevo.
  • No se puede conectar con el exchange. Burokku espera más entre cada intento, hasta una hora, y sigue mostrando tus últimos saldos. La cuenta solo dice que no puede conectar con el exchange cuando eso ya lleva media hora.

Algunas claves vencen solas: Bybit y Gate dan de baja una clave sin lista de IP permitidas después de unos tres meses. Burokku te lo recuerda una semana antes, una sola vez, para que pegues una clave nueva antes de que tus saldos dejen de actualizarse.

En qué se diferencian las claves de trading

Si quieres colocar órdenes desde Burokku, puedes conectar en cambio una clave para trading, en los exchanges que lo permiten, como Binance y Kraken. Las reglas para esa clave son distintas, y más estrictas:

  • Tiene que poder operar.
  • No debe poder retirar ni transferir. Una clave de trading que puede hacerlo se rechaza, igual que una de solo lectura.
  • Tiene que estar restringida a una dirección IP. Burokku coloca órdenes desde una única dirección IP fija, que te muestra cuando conectas. La clave tiene que estar limitada a esa dirección, así que una copia no sirve en ningún otro lugar. Cuando un exchange no informa si una clave está restringida, probamos la clave desde otra dirección: si el exchange la rechaza ahí, está restringida.

Activar el trading también requiere la verificación en dos pasos en tu cuenta de Burokku, y lo confirmas con ese segundo paso. Después, cada orden se revisa contra los límites que fijaste antes de enviarse.

La revisión diaria también se aplica aquí. Una clave de trading que gana el permiso de retirar, o pierde su restricción de IP, se elimina y se te avisa una vez. Una que pierde su permiso de operar vuelve a solo leer tu cuenta. Trading en Burokku explica cómo se le pone precio a cada orden y cómo se revisa.

Si tienes dudas, empieza con una clave de solo lectura. Puedes ver cada saldo, posición y operación junto a tus billeteras, y la clave no puede mover nada. Puedes agregar una clave de trading después, o nunca.

Más del blog

Míralo con tu propia billetera.

Agrega una billetera por su dirección. Es gratis, y puedes sumar las demás cuando quieras.