API keys de Binance con permisos mínimos y lista blanca de IP | Tres bloques imprescindibles para usuarios cuantitativos
Biabaflow configura los permisos mínimos de una API key en una cuenta cuantitativa real, cubriendo separación de lectura y escritura, lista blanca de IP, ciclo de rotación de la clave y respuesta ante fugas, con una guía práctica lista para copiar.
Vamos con la conclusión primero: por defecto, la API key de Binance tiene permisos de "solo lectura + trading" y la retirada está desactivada. Para operar de forma cuantitativa basta con "lectura + trading"; en la gran mayoría de los casos no hace falta activar la retirada. Añadiendo una lista blanca de IP, incluso si la clave se filtra, no podrán extraer los activos. Este bloque se configura en 10 minutos y es una tarea obligatoria para cualquier usuario cuantitativo. En Biabaflow hemos recorrido todo el flujo en una cuenta real y lo hemos convertido en el manual siguiente.
1. Niveles de permisos de la API key
1.1 Los tres permisos base
- Enable Reading: solo lectura, puedes ver el saldo y el historial de órdenes;
- Enable Spot & Margin Trading: trading en spot y en cuenta con margen;
- Enable Withdrawals: retirada (desactivada por defecto).
1.2 Permisos adicionales
- Enable Futures: trading en futuros;
- Universal Transfer: transferencias internas entre cuentas;
- Options: trading en opciones.
1.3 Principio de mínimo privilegio
P: ¿Por qué aplicar el mínimo privilegio?
R: Si la clave se filtra, el atacante solo puede hacer lo que hayas autorizado. Cuantos menos permisos concedas, menor será la pérdida potencial. Para cuantitativa basta con enviar órdenes y leer la cuenta; el resto de permisos deben quedar apagados.
2. Flujo completo para crear una API key
2.1 Pasos
En orden:
- Inicia sesión en la web: www.binance.com/es;
- Avatar → Gestión de API;
- Introduce el nombre de la clave (por ejemplo, quant-2026-07);
- Verificación por correo + 2FA;
- El sistema genera la API Key y la Secret Key;
- Copia inmediatamente la Secret Key (solo se muestra una vez);
- Configura permisos y lista blanca de IP.
2.2 Almacenamiento de la Secret Key
La Secret Key solo aparece una vez y después no se puede consultar. Guárdala inmediatamente en tu gestor de contraseñas o en un archivo cifrado.
P: ¿Y si olvido la Secret Key?
R: No se puede recuperar. La única opción es eliminar la clave antigua y crear una nueva.
2.3 Selección de permisos
Marca solo los permisos que necesitas de verdad. Para un programa de solo lectura (por ejemplo, un monitor de precios) marca únicamente Reading y deja lo demás apagado.
3. Lista blanca de IP
3.1 Por qué es imprescindible
Sin lista blanca de IP, cualquiera que conozca la clave puede enviar órdenes con ella. Con la lista blanca activada, aunque la clave se filtre, el atacante no podrá invocarla desde otra IP.
3.2 Configuraciones habituales de IP
- Banda ancha doméstica: IP estática de casa o prefijo IPv6;
- Despliegue en VPS: IP fija del VPS;
- Cloud Functions: rango de IP del entorno de ejecución de la función.
3.3 Varias IPs en la lista blanca
P: ¿Puedo poner varias IPs?
R: Sí, separadas por coma. Se recomienda añadir solo las estrictamente necesarias, evitando dejar rangos amplios "por comodidad".
| Configuración | Seguridad | Escenario ideal |
|---|---|---|
| Una única IP | Muy alta | VPS cuantitativa |
| Casa + oficina | Alta | Trading manual |
| Un /24 completo | Media | Cloud Functions |
| Sin restricción de IP | Muy baja | No recomendable |
4. Ciclo de rotación de la clave
4.1 Ciclo recomendado
- Claves de alta frecuencia: rotación cada 30-60 días;
- Claves de frecuencia media/baja: rotación cada 90 días;
- Claves de solo lectura para monitoreo: rotación cada 180 días.
4.2 Flujo de rotación
En orden:
- Crea una nueva clave;
- Despliégala en el sistema cuantitativo;
- Verifica que la nueva clave funciona correctamente;
- Elimina la clave antigua;
- Actualiza la entrada del gestor de contraseñas.
4.3 Eliminación de emergencia
Si sospechas que la clave se ha filtrado, elimínala de inmediato. Cinco segundos después de la eliminación deja de ser válida y el atacante no podrá seguir operando.
5. Flujo de emergencia ante una fuga de la clave
En orden:
- Inicia sesión en la web → Gestión de API;
- Localiza la clave sospechosa de fuga;
- Pulsa "Delete" para eliminarla al instante;
- Revisa las órdenes y las retiradas de las últimas 24 horas;
- Si detectas órdenes anómalas, abre un ticket con soporte oficial;
- Cambia la contraseña de la cuenta y restablece el 2FA;
- 24 horas después, crea una nueva clave con lista blanca de IP más estricta.
5.1 Diagnóstico del origen
P: ¿La clave se filtró desde mi GitHub?
R: Es posible. Las fugas de API key en GitHub son el incidente más común en usuarios cuantitativos. Usar git-secrets o un pre-commit hook para bloquear los commits es una herramienta imprescindible.
5.2 No generes claves en ordenadores públicos
P: ¿Puedo generar una clave desde un cibercafé?
R: No. Los ordenadores públicos pueden tener keyloggers o vigilancia del portapapeles. La clave debe generarse solo en un dispositivo de tu confianza.
Cuando termines la configuración de la API, puedes revisar la cuenta desde el Sitio Oficial de Binance e inspeccionar el historial de dispositivos; para la App, entra en la página de descarga de la App Oficial de Binance; y para cuentas nuevas empieza en Registrarme en Binance ahora. Para revisiones periódicas vuelve a la Página de descarga de la App o al Especial de accesos oficiales.
5.3 Aviso de riesgo
Aviso de riesgo: cualquier tercero que afirme "optimizar el rendimiento de tu API" o "acelerar tus órdenes por proxy" quiere en realidad que le entregues tu API key. En cuanto lo hagas, el control de los activos deja de estar en tus manos. Biabaflow desaconseja tajantemente cualquier servicio de ese tipo.
6. Configuraciones habituales de referencia
| Escenario | Permisos | Lista blanca de IP |
|---|---|---|
| Monitor de precios | Solo lectura | IP del servidor |
| Grid trading | Lectura + spot | IP del VPS |
| Estrategias de futuros | Lectura + futuros | IP del VPS |
| Ayuda al trading manual | Lectura + spot | IP de casa |
| Retiradas automatizadas | No recomendado | Muy estricta |
7. Compromiso de re-verificación de Biabaflow
- Cada trimestre repetimos el flujo de permisos de la API;
- Recopilamos las trampas típicas que nos cuentan los lectores y las añadimos a las FAQ;
- Si Binance introduce nuevos permisos, actualizamos la guía de inmediato.
8. Preguntas frecuentes
P: ¿Cuándo hay que activar Enable Withdrawals?
R: Solo en los pocos casos en los que se necesita retirar de forma programada. Si la activas, combínala obligatoriamente con lista blanca de IP y con lista blanca de direcciones de retiro; los dos son imprescindibles.
P: ¿Las API keys caducan solas?
R: Por defecto caducan a los 90 días. Después hay que crear una nueva o extender la vigencia manualmente.
P: ¿Las claves de una subcuenta comparten los permisos de la cuenta principal?
R: No. Las claves de subcuenta solo afectan a los activos de esa subcuenta.
P: ¿Hay límite en la frecuencia de llamadas a la API?
R: Sí. Cada clave tiene su cuota de "weight"; superarla implica bloqueo temporal. Sigue las tasas oficiales de la documentación de la API.
P: ¿Biabaflow publicará plantillas cuantitativas en open source?
R: Biabaflow se centra en documentación operativa y no distribuye plantillas cuantitativas en producción. Puedes basarte en la documentación oficial de la API y en la comunidad de código abierto.
Documento publicado el 2026-07-11. Próxima re-verificación prevista el 2026-10-01.