Zhenku
Defensa · Cerrar la puerta · API

API key de Binance: permisos, restricción de IP y qué hacer si se filtra

Redacción de Zhenku · Cheng Mo Actualizado 2026-11-13 Unos 14 min
Un brazo robótico con una llave dorada solo puede pasar por una puerta estrecha, sujeto con correa por la bestia guardiana (ilustración de portada generada con IA)

En Binance, los permisos que marcas al crear una API key y la restricción de IP parecen dos ajustes distintos, pero las reglas los atan: una key generada por el sistema sin restricción de IP solo puede leer, y el permiso de retiro no se activa hasta que agregues una restricción de IP en formato IPv4. La primera rige desde el 30/1/2023 a las 0:00 (UTC); las dos siguen en el centro de ayuda de Binance (verificado en noviembre de 2026). Si quieres que una herramienta opere por ti sin fijar una IP, Binance da solo tres salidas: agregar la restricción de IP, pasarte a una key autogenerada Ed25519 o RSA, o desactivar los controles de seguridad predeterminados. Abajo separamos los dos ajustes, qué frena cada uno y qué no, y después vienen el error -2015 y qué hacer si la key se filtra.

Dos ajustes dentro de una misma key

Una API key es la llave con la que un programa habla con Binance en tu nombre. Hay dos tipos. La generada por el sistema usa cifrado simétrico HMAC y te entrega dos cadenas: la API Key y la Secret Key. La autogenerada usa Ed25519 o RSA: tú creas el par de claves pública y privada con un software de terceros y a Binance le das solo la pública. Sea cual sea, la herramienta que la tenga puede hacer lo que los ajustes de esa key le permitan.

Lo que define cuánto te cuesta una fuga son dos ajustes que se suelen mezclar:

Cada uno falla a su manera. Los permisos no miran quién usa la key; solo limitan lo que puede hacer. La restricción de IP no frena un pedido que sale de una dirección de tu lista, así que si hackean el servidor donde corre tu herramienta, el atacante ya está adentro de la lista blanca. Cuando una key termina mal, casi siempre es porque los permisos quedaron más abiertos de lo necesario y además el secreto se escapó. Para revisar las keys que ya tienes, pásalas por el autochequeo de riesgo de permisos de API.

Permisos: qué puede hacer la key

Los permisos que lista la documentación para desarrolladores de Binance (el endpoint para consultar los permisos de una API key) corresponden a estos interruptores: lectura, trading spot y de margen, retiro, transferencia interna entre la cuenta principal y las subcuentas, transferencia universal, futuros y opciones. Hay unos cuantos más para Portfolio Margin y la API FIX que una herramienta común no toca. La regla es una: marca solo lo que la herramienta use de verdad.

Los dos permisos de transferencia son los que más se marcan sin pensar. La transferencia interna mueve fondos al instante entre tu cuenta principal y tus subcuentas; la universal autoriza a la key a usar un endpoint de transferencia dedicado para varias monedas compatibles. Los dos mueven plata. La interna queda entre tu cuenta principal y tus subcuentas, así que los fondos no salen de tu nombre, pero el reparto que armaste entre subcuentas se puede desarmar; adónde puede mandar fondos la universal lo define la documentación del endpoint. Si la herramienta no los necesita, apagados también.

La ventaja del permiso mínimo recién se nota después de una fuga: quien tenga una key de solo lectura ve tu saldo y tus órdenes, y no puede mover ni un centavo.

Punto de alto riesgoEl retiro es el único permiso que puede sacar fondos de tu cuenta. Cuando una herramienta te lo pida, devuélvele la pregunta: ¿de verdad necesita sacar plata de Binance? Llevar registro, ver precios o hacer copy trading no lo necesitan. Si no hace falta, no lo des.

Restricción de IP: desde dónde se puede usar

Con la restricción de IP puesta, la key solo acepta pedidos que salen de las direcciones IPv4 que cargaste y rechaza todo lo demás. Un secreto filtrado no le sirve a alguien que lo intenta desde su propia red.

Cómo se ata a los permisos lo dice el centro de ayuda de Binance:

Tipo de keyLecturaOperar y otros permisosRetiro
Generada por el sistema (HMAC), sin restricción de IPSíNoNo
Generada por el sistema (HMAC), con restricción IPv4SíSíSe puede activar
Autogenerada (Ed25519 / RSA)SíSí; Binance la cita como una forma de tener otros permisos sin restricción de IPIgual exige restricción IPv4

Fuente: centro de ayuda de Binance, artículo sobre cómo crear claves API (n.º 360002502072, marcado «Última actualización: 20 de marzo de 2025»). Verificado en noviembre de 2026; vale lo que muestre la página en ese momento. El estado de la cuenta igual puede trabar un permiso puntual, como el caso de futuros de arriba.

La tercera salida que lista Binance es desactivar los controles de seguridad predeterminados. Hace justo eso: saca esta protección para que una key sin restricción de IP pueda tener otros permisos. No la recomendamos: si esa key se filtra, funciona desde cualquier lado.

La IP de tu casa cambia: qué conviene

La mayoría de las conexiones hogareñas reciben una IP pública que cambia. Si la fijas, el día que rota la dirección la herramienta deja de conectar; si no la fijas, una key generada por el sistema queda en solo lectura. Para operar en automático hay dos caminos más estables:

El segundo pide pensarlo un poco más. Esto es una inferencia nuestra, no algo que diga Binance: una key autogenerada sin restricción de IP tiene una sola cosa entre ella y un atacante, la clave privada que guardas en tu equipo. Dónde está ese archivo y quién puede llegar a él pasa a ser tu única defensa. Nosotros, si hay un servidor con IP fija a mano, vamos por ahí, y dejamos las keys autogeneradas para cuando de verdad no hay una dirección estable.

También vas a encontrar que «las keys sin IP se desactivan a los 90 días». El artículo vigente del centro de ayuda de Binance no dice eso y el endpoint que informa los permisos de una key no tiene ningún campo de vencimiento, así que no lo repetimos acá.

Hazlo de unaA cada key que opera, ponle la IP fija del servidor donde corre. Con ese solo paso, el camino de «se filtró el secreto y ya están poniendo órdenes» se angosta muchísimo.

Cómo guardar el secreto

Los permisos y la IP son el colchón para después de una fuga; la primera línea es que no se filtre.

Rotación y limpieza periódica

Una API key no es de crearla una vez y olvidarse.

Entra a la gestión de API de Binance y repasa la lista de arriba abajo: ¿cada key sigue en uso? ¿tiene más permisos de los que necesita? ¿tiene restricción de IP? Si dudas, contrástala con el autochequeo de riesgo de permisos de API.

El riesgo de las herramientas de terceros

Cargar una key en una herramienta de terceros es entregarle parte del control de tu cuenta a esa herramienta y a quienes la manejan. La restricción de IP ayuda menos de lo que parece: la herramienta corre en sus propios servidores, la IP que fijaste es la de ese servidor, y si lo hackean el atacante ya está en la lista blanca.

Quédate con esto«¿Esta herramienta merece mi confianza?» y «¿esta key está bien ajustada?» son dos exámenes distintos. Hay que aprobar los dos.

Error -2015: cuál de las tres causas falló

Cuando el log de una herramienta muestra -2015, el mensaje completo es Invalid API-key, IP, or permissions for action. (códigos de error oficiales de la API spot de Binance, nombre REJECTED_MBX_KEY). En una sola línea entran tres causas posibles. Revísalas en este orden:

  1. La key: ¿copiaste mal la API Key, con un espacio de más, o ya la borraste en Binance?
  2. La IP: ¿la dirección desde la que sale de verdad el pedido está en tu lista? Que la herramienta cambie de servidor o que tu conexión de casa se reconecte la cambia.
  3. El permiso: ¿está activado el que necesita esa acción? El caso típico es futuros: una key creada antes de abrir tu cuenta de futuros no puede tener ese permiso, así que crea otra.

En foros y en algunas páginas de ayuda de herramientas aconsejan poner la IP en «sin restricción» para probar. No lo arregles así. Con las reglas actuales, una key generada por el sistema sin restricción queda en solo lectura y la orden igual falla; y apagar los controles de seguridad predeterminados para esquivar eso es quitar la protección entera. Encuentra cuál de las tres es y arregla solo esa.

Si sospechas una fuga: revocar y rehacer

Órdenes que tú no pusiste, un equipo donde usaste la key que pudo agarrar virus, una herramienta que anuncia un incidente: con cualquiera de esas alcanza. Sigue este orden:

  1. Elimina (revoca) esa key ya mismo en la gestión de API de Binance para dejarla inservible. Es eliminar, no solo cambiarle los permisos o la IP; mientras el secreto viejo exista, todavía la pueden usar.
  2. Revisa la actividad reciente de la cuenta: historial de órdenes, movimientos de fondos y equipos con acceso. Si ves operaciones que no hiciste, el problema va más allá de la API: encáralo entero con el flujo de rescate de cuenta hackeada, cambiando la contraseña de acceso, revisando el 2FA y congelando la cuenta si hace falta.
  3. Rastrea el origen de la fuga: ¿qué equipo, qué herramienta? Si no cierras eso, la key nueva se puede filtrar igual.
  4. Rehaz una key más ajustada para la herramienta que sigas usando: solo los permisos que usa y la restricción de IP en un servidor que controles tú.

Un robo por API suele ir de la mano con la seguridad general de la cuenta, así que no te quedes solo en la key. Si sospechas problemas a nivel cuenta, el operativo completo está en la guía completa de rescate de cuenta hackeada; y el autochequeo de riesgo de permisos de API te ayuda a listar los puntos flojos de las keys que te quedan.

Evita el segundo engañoCuando hay un problema con la API, no le creas a nadie que te escriba por privado ofreciendo "recuperarte la cuenta" o "encontrarte los fondos". Binance oficial no te escribe por privado, no te pide la Secret Key, no te pide la contraseña ni el código de verificación. Para chequear si un mensaje es realmente oficial, mira cómo confirmar si un mensaje de "Binance" es de verdad.
En una fraseLa seguridad de la API te protege de que "un programa u otra persona opere tu cuenta"; no te protege de que el mercado suba o baje. Por más sólida que dejes la config de la key, eso no significa que tu estrategia vaya a dar ganancia. Esta nota trata solo de seguridad de cuenta y fondos, y no constituye asesoría de inversión.

Preguntas frecuentes

¿Pueden usar mi API key de Binance para retirar fondos?

Solo si se juntan tres cosas: la key tiene el permiso de retiro, el pedido sale de una IP de su lista blanca y el secreto se filtró, por ejemplo porque hackearon el mismo servidor donde corre tu herramienta. El retiro no se puede activar sin restricción de IPv4, así que con las reglas actuales no existe una key con retiro activado y sin IP. Si no necesitas retirar por API, déjalo apagado; si lo necesitas, fija solo la IP de un servidor que controles tú.

¿Sigue haciendo falta mantener en secreto la API key si ya tiene lista blanca de IP?

Sí. Si el atacante manda pedidos desde una dirección permitida, por ejemplo porque entró a ese mismo servidor, la restricción de IP no lo frena; y si más adelante cambias la config de IP, puede quedar un hueco. Van las tres juntas: permiso mínimo, restricción de IP y secreto bien guardado.

Si sospecho que se filtró la API key, ¿qué hago primero?

Lo primero es eliminar (revocar) esa key en Binance para dejarla inservible, no solo cambiarle los permisos. Después revisa órdenes, fondos y accesos recientes por si hay algo raro, confirma que la cuenta esté sana en general, y recién ahí rehaz una key nueva con permisos más ajustados e IP bien puesta para la herramienta que sigas usando.

¿Puedo usar una misma key en varias herramientas?

No conviene. Crea una key aparte para cada herramienta: si una falla, revocas solo esa sin arrastrar a las demás, y el rastreo queda claro. Una misma key en varias herramientas: una sola fuga las expone a todas.

¿Las opciones de permisos y las reglas de IP pueden cambiar?

Sí, y ya hubo un cambio grande: desde el 30/1/2023 a las 0:00 (UTC), una key generada por el sistema sin restricción de IP solo puede quedar en lectura. Aparte, el retiro exige restricción de IPv4; esa regla no lleva fecha de inicio en el centro de ayuda. Las dos reglas seguían en el centro de ayuda de Binance cuando lo verificamos en noviembre de 2026. Si vuelven a cambiar, vale lo que muestren en ese momento las páginas de creación y gestión de API y el centro de ayuda.

¿Una key sin IP se borra sola a los 90 días?

Muchas guías lo dicen. El artículo vigente del centro de ayuda de Binance sobre cómo crear claves API no lo menciona, así que no lo damos como regla. Si la key sigue existiendo y en qué estado está, lo dice la página de gestión de API.

CM
Cheng Mo · Redacción de Zhenku

"Cheng Mo" es un seudónimo, no representa a ningún experto con licencia. Lo que hacemos es explicar la configuración de API de Binance y sus reglas públicas en un orden que un usuario común pueda seguir, y lo cotejamos punto por punto con las páginas oficiales de Binance. No damos asesoría de inversión; si encuentras algo mal escrito, avísanos por la vía de correcciones.

Fuentes

  • Centro de ayuda de Binance · cómo crear claves API (artículo 360002502072, marcado «Última actualización: 20 de marzo de 2025»; verificado el 2026-11-13)
  • Documentación de la API spot de Binance · códigos de error, -2015 REJECTED_MBX_KEY (errors.md en GitHub)
  • Documentación para desarrolladores de Binance · Get API Key Permission (GET /sapi/v1/account/apiRestrictions), descripción de cada permiso