Bloqueo de Permisos de API Key en Binance | Referencia Rápida de Biabafox
Biabafox desglosa las cinco categorías de permisos de las API keys de Binance (lectura, spot, futuros, margen, retiros), acompañadas de una tabla rápida de IP whitelist, los siete escenarios de mayor riesgo y un flujo de emergencia de seis pasos ante filtraciones.
Las API keys son las credenciales más fáciles de filtrar y las más difíciles de recuperar en una cuenta. Respuesta directa: la seguridad de las API keys de Binance se resume en una sola frase — "si la lectura basta, nunca des permiso de trading; si con una IP alcanza, jamás abras al mundo entero; nunca marques el permiso de retiro salvo que lo necesites de forma clara y entiendas el riesgo". Biabafox concentra en esta referencia rápida los cinco tipos de permisos, el mecanismo de IP whitelist, los siete escenarios de mayor riesgo y el flujo de emergencia de seis pasos ante filtraciones; treinta minutos para asentar una operativa reproducible en el uso de tus API keys.
Si aún no tienes ninguna API key, primero completa el KYC y el 2FA desde el Sitio Oficial de Binance, o repasa la configuración de seguridad desde la App Oficial de Binance disponible en la Página de Descarga; esta guía asume que ya has cumplido esos prerrequisitos.
Escenario y perfil del lector
- Escenarios aplicables: trading algorítmico, análisis de datos, dashboards de precios, arbitraje entre exchanges, market making
- Dificultad: media-alta (modelo de permisos, rangos IP, firma criptográfica)
- Tiempo estimado: 15 minutos para crear una key y planificar sus permisos; 30 minutos para simular una emergencia
- Público objetivo: traders algorítmicos, desarrolladores, integraciones institucionales, autores de herramientas de mercado
- Equipamiento: un servidor con IP estable y un PC de gestión
- Red: IP pública fija en el lado API; el lado de gestión con acceso normal al Sitio Oficial de Binance
- Nivel de riesgo: alto (una filtración puede vaciar la cuenta)
- Costo: cero
- Alternativa: operar exclusivamente por web o app (más seguro pero sin automatización)
- Errores frecuentes: dar todos los permisos de una vez, no configurar IP whitelist, escribir el secret dentro del repositorio
- Verificación: una key de solo lectura debe fallar si intenta enviar órdenes; una key con IP restringida debe fallar desde otra IP
Tabla rápida de las 5 categorías de permisos
Biabafox agrupa los permisos de Binance en cinco categorías, del más débil al más fuerte:
| Permiso | Qué permite | Pérdida máxima si filtra | Cuándo activarlo | Con qué combinarlo |
|---|---|---|---|---|
| Lectura | Consultar precios, saldos, velas | Fuga de privacidad | Análisis de datos, dashboards | Puede usarse sin IP whitelist |
| Trading spot | Órdenes, cancelaciones, ejecución | Fondos cambiados por activos ilíquidos | Algoritmos de spot | IP whitelist obligatoria |
| Trading en margen | Prestar, devolver, operar con apalancamiento | Liquidación forzada | Estrategias apalancadas | IP whitelist obligatoria |
| Futuros | Órdenes en futuros USDT-M/COIN-M | Liquidación total sin controles | Algoritmos en futuros | IP whitelist obligatoria + risk management |
| Retiro | Retirar directamente a direcciones whitelisted | Robo total de activos | Casos muy puntuales de custodia | IP obligatoria + whitelist bloqueada |
R: Biabafox insiste: el 99% de los usuarios algorítmicos no necesita el permiso de retiro; dejarlo en blanco elimina más del 90% del riesgo de los activos. Aunque se filtre el secret, el atacante como mucho podría hacer trading raro; jamás sacar los fondos del exchange. Es el primer principio de la seguridad de API.
Tres niveles de combinación de permisos
Repartimos los tres tipos comunes de keys según su uso:
- Key de solo lectura: marca solo "Lectura", funciona incluso sin IP whitelist. Ideal para dashboards de precios y visualización de saldos
- Key de trading: marca "Lectura + Spot/Futuros" y exige IP fija. Adecuada para bots
- Key con retiro: solo si necesitas mover activos automáticamente a un cold wallet; obligatorio IP fija y whitelist de retiros bloqueada
Referencia rápida de IP whitelist
La IP whitelist es la segunda cerradura, tan importante como el bloqueo de permisos.
| Configuración de IP | Permisos soportados | Vigencia |
|---|---|---|
| Sin IP configurada | Solo "Lectura" | 90 días con expiración automática |
| Una IP fija | Todos los permisos | Sin caducidad |
| Varias IPs (separadas por comas) | Todos los permisos | Sin caducidad |
| Rango de IP (CIDR) | No soportado | Ninguno |
| IPv6 | Soportado | Sin caducidad |
Casos habituales de despliegue
| Ubicación | Configuración de IP recomendada | Nota |
|---|---|---|
| Alibaba Cloud / Tencent Cloud con IP pública dedicada | Una IP fija | La más recomendada |
| AWS EIP | Una IP fija | La más recomendada |
| Cloudflare Workers | Salida a través de proxy con IP fija | Requiere relé |
| IP doméstica dinámica | DDNS + refresco diario | No apta para producción |
| Red móvil | Totalmente desaconsejada | La IP cambia cada minutos |
R: Regla de Biabafox: nunca despliegues una key con permisos de trading en un entorno sin IP fija. Para pruebas puntuales con solo lectura, úsala y bórrala luego. Vale más migrar a un servidor con IP fija que salir a producción sobre un router doméstico con PPPoE.
El vencimiento de 90 días
Desde 2023, Binance obliga a caducidad de 90 días a toda key sin restricción de IP:
- A los 90 días de creada se deshabilita automáticamente (incluso la lectura)
- Siete días antes empiezan los correos de aviso
- La renovación exige repetir el 2FA
- Con IP whitelist configurada la key no tiene caducidad (la práctica recomendada)
Siete escenarios de alto riesgo
Al revisar las filtraciones reportadas por la comunidad, Biabafox identifica siete perfiles habituales:
| Escenario | Nivel de peligro | Cómo remediarlo |
|---|---|---|
| Escribir el secret directamente en el repositorio Git | Muy alto | Borrar la key y usar variables de entorno |
| Compartir capturas de código con la key visible | Alto | Borrar la key y revisar el historial de mensajes |
| Publicar logs en Discord o Telegram públicos | Alto | Sanitizar logs y borrar la key |
| Compartir una misma key entre varias estrategias | Medio | Una key por estrategia para poder auditar |
| Dejar el acceso "desde cualquier IP" abierto | Muy alto | Añadir IP inmediatamente o borrar la key |
| Marcar el permiso de retiro para uso rutinario | Muy alto | Quitar el permiso de retiro de inmediato |
| Guardar la key en el campo "notas" del gestor | Medio | Moverla a un campo cifrado y rotarla con regularidad |
Tres reglas para almacenar el secret
- Jamás dentro del repositorio (usa
git-secretscomo complemento a.gitignore) - En producción, variables de entorno o un servicio de secretos (KMS, Vault)
- En desarrollo local,
.envno versionado en Git
Flujo de emergencia en seis pasos
Ante la sospecha de filtración, Biabafox recomienda esta secuencia dentro de los primeros 5 minutos:
| Paso | Acción | Tiempo |
|---|---|---|
| 1 | Entra al Sitio Oficial de Binance, Gestión de API, deshabilita la key sospechosa | 30 segundos |
| 2 | Cambia la contraseña y cierra todas las sesiones | 1 minuto |
| 3 | Revisa las últimas 24 horas de órdenes, transferencias y retiros | 2 minutos |
| 4 | Revisa subcuentas y cuenta de futuros por movimientos anómalos | 1 minuto |
| 5 | Si hay órdenes irregulares, pide a soporte que congele la cuenta | Manual |
| 6 | Analiza el origen de la filtración y refuerza (IP whitelist, reducción de permisos) | Posterior |
R: Biabafox insiste: primero deshabilita la key y luego investiga; no lo hagas al revés. El atacante puede estar operando ahora mismo: cada 30 segundos vale una orden maliciosa más.
Cuatro puntos a revisar en el post mortem
- Historial de commits en Git (
git log --all -p | grep -i api) - Adjuntos en nube y correo buscando "key" y "secret"
- Historiales de herramientas de trabajo (Slack, Notion)
- Historial del shell local y caché de portapapeles del IDE
Preguntas Frecuentes
P1: ¿Una key de solo lectura también filtra privacidad?
R: Sí. Con lectura puedes ver saldos, órdenes históricas y transferencias, datos valiosos para un atacante. Biabafox recomienda aplicar IP whitelist incluso a keys de solo lectura.
P2: ¿Binance soporta algoritmos de firma distintos de HMAC-SHA256?
R: Sí. Desde 2024 admite firmas Ed25519, con claves más cortas, verificación más rápida y resistencia cuántica. Biabafox aconseja elegir Ed25519 para nuevas keys, sobre todo en high-frequency.
P3: ¿Pueden las subcuentas emitir su propia API key?
R: Sí. Las subcuentas tienen APIs independientes de la principal, con permisos ajustables a nivel de subcuenta. Biabafox recomienda encarecidamente aislar el capital de cada estrategia en subcuentas propias; si una key filtra, el daño queda contenido en el saldo de esa subcuenta.
P4: ¿Cómo detecto si mi API key está siendo usada por terceros?
R: Binance ofrece logs de llamadas API donde puedes ver los últimos 30 días de origen IP, frecuencia y errores. Revisa cada semana. Si aparece una IP que no es la tuya, deshabilita la key en el acto.
P5: ¿Qué relación tiene el permiso de retiro de la API con la whitelist de retiro a nivel cuenta?
R: Se combinan. El permiso de retiro por API solo permite mandar a las direcciones ya presentes en la whitelist de retiro de tu cuenta. Aunque la key tenga el permiso, un atacante solo podría retirar a las direcciones autorizadas por ti. Es el clásico doble cerrojo.
P6: Si no tengo IP fija en casa, ¿queda fuera el trading algorítmico?
R: No, hay tres alternativas: (1) alquilar un VPS por 5 a 10 dólares al mes con IP fija; (2) usar Cloudflare Tunnel para que todas las peticiones salgan por una IP fija; (3) DDNS + una segunda key con permisos administrativos para actualizar la whitelist (Binance permite modificar la whitelist por API, con otra key de gestión). Biabafox recomienda la opción 1: es la más tranquila.
P7: ¿Cuántas API keys puedo generar por cuenta?
R: Las cuentas personales pueden crear 30; las institucionales más. Biabafox aconseja: una key por estrategia, miembro del equipo y propósito, para auditar y jubilar sin dolor. Usa y elimina; no dejes keys "por si acaso".
P8: ¿Se recuperan las pérdidas si hay órdenes maliciosas tras la filtración?
R: Rara vez se recupera el precio. Si hubo IOC por debajo del mercado o dumping intencional, en 30 días soporte puede ayudarte a apelar, pero la devolución depende de si la orden encaja en la definición de "manipulación maliciosa". Biabafox ha visto casos con éxito y fracaso a partes iguales; siempre lo más rentable es la prevención.
Aviso de Riesgo
Una API key comprometida suele materializar la pérdida en minutos, más rápido y sigiloso que un ataque manual. Biabafox recomienda con firmeza: toda key con permisos de trading debe tener IP fija, evitar el permiso de retiro salvo justificación clara, ser inspeccionada cada 30 días y rotar el secret cada 90 días. La inversión en criptoactivos implica volatilidad de mercado y las estrategias algorítmicas pueden fallar por bugs; este artículo trata solo la seguridad de las credenciales, no los resultados operativos. Gestiona tus API keys únicamente desde los accesos oficiales del Sitio Oficial de Binance o de la App Oficial de Binance.
Navegación interna: encontrarás más accesos en la Página de Descarga; si dudas entre gestionar tus API keys desde la app o desde la web, revisa la Guía rápida para elegir entre PC y web antes de decidir.
Documento publicado el 2026-07-10; próxima revisión prevista para el 2026-10-10.