Saltar al contenido principal
cómo crear una API key en Binancecrear API key BinanceAPI key Binance futures
Cómo crear una API key en Binance para un bot de trading, con ajustes seguros

Cómo crear una API key en Binance para un bot de trading, con ajustes seguros

Para crear una API key en Binance, abre Account → API Management en el sitio web de Binance, elige Create API y System generated, ponle un nombre a la clave y confirma con tu 2FA. Para un bot de trading, edita después las restricciones de la clave: restringe el acceso a IP de confianza, marca Enable Reading y el permiso de trading que necesita tu bot, y deja Enable Withdrawals desactivado.

Esta guía recorre cada paso en el sitio web y en la app, explica qué permisos necesita un bot de trading y por qué Binance pide una restricción de IP, y muestra cómo añadir la clave a Freya y resolver los errores que podrías ver.

Puntos clave

  • Binance crea las claves API en Account → API Management. Una clave System generated te da una API Key y una Secret Key, y el secreto se muestra una sola vez.
  • Un bot de trading necesita Enable Reading más Enable Spot & Margin Trading (bots spot) o Enable Futures (bots de futuros). Los retiros y cualquier otro permiso quedan desactivados.
  • Por defecto, Binance solo permite permisos de trading en una clave System generated restringida a IP de confianza, y Freya rechaza las claves sin esa restricción, así que añade las direcciones IP del bot antes de marcar las casillas de trading.
  • Freya rechaza una clave con permiso de retiro y una clave sin restricción de IP. Tu capital de trading nunca sale de tu cuenta del exchange.
  • Solo las cuentas globales de Binance se conectan a Freya. Las cuentas de Binance TR, Binance US y Binance Japan no pueden.

Antes de crear una API key en Binance

Revisa primero estos puntos en tu cuenta de Binance. Binance indica los tres primeros como requisitos para crear una clave:

  • La autenticación de dos factores (2FA) está activada.
  • Tu identidad está verificada (KYC).
  • Tu cuenta Spot está activa. Binance la activa con un primer depósito de cualquier cantidad.
  • Tu cuenta de Futuros está abierta, si piensas usar bots de futuros. Binance no te deja añadir el permiso de Futures a una clave creada antes de que existiera la cuenta de Futuros, así que abre Futuros primero. Si la abres más tarde, crea una clave nueva.
  • Usas una cuenta global de Binance. Freya solo se conecta a las API globales de los exchanges, así que las cuentas de Binance TR, Binance US y Binance Japan no pueden conectarse.

Cómo crear una API key en Binance desde el sitio web

  1. Inicia sesión en Binance, abre el menú de tu perfil y ve a Account → API Management.
  2. Elige Create API y selecciona System generated.
  3. Ponle a la clave un nombre que reconozcas, por ejemplo «Freya», y confirma con tu 2FA.
  4. Binance muestra la API Key y la Secret Key. Copia ambas ahora: el secreto se muestra una sola vez. Si lo pierdes, elimina la clave y crea una nueva.
  5. Elige Edit restrictions en la clave nueva.
  6. Selecciona Restrict access to trusted IPs only e introduce las direcciones IP de la app que usará la clave. Freya muestra sus direcciones en la ventana Agregar clave API.
  7. Marca Enable Reading, más Enable Spot & Margin Trading para bots spot o Enable Futures para bots de futuros. Deja sin marcar Enable Withdrawals.
  8. Guarda las restricciones y confirma con tu 2FA.

Binance también ofrece claves Self generated (Ed25519 o RSA), en las que creas tu propio par de claves con un software aparte. Un bot de trading que pide una clave API y un secreto, como Freya, necesita el tipo System generated.

Cómo crear una API key en Binance desde la app

  1. Abre la app de Binance y toca More. Si no lo ves en la pantalla de inicio, la guía de Binance indica que añadas el widget desde tu perfil.
  2. Desplázate hasta Others y toca API Management.
  3. Toca Create API, elige System generated, escribe un nombre y confirma con tu 2FA o con una llave de acceso (passkey).
  4. Copia la API Key y la Secret Key, y después configura las restricciones de los pasos 5 a 8 de arriba: IP de confianza, lectura y el permiso de trading que necesites, retiros desactivados. Si la app no muestra alguna opción, termina en el sitio web.

Los nombres de los menús de Binance cambian de vez en cuando. Si una etiqueta se ve distinta, la propia guía de Binance How to Create API Keys on Binance (en inglés) muestra las pantallas actuales.

Qué permisos necesita un bot de trading

Permiso en BinancePara un bot de tradingPor qué
Enable ReadingSíEl bot lee saldos, órdenes y posiciones
Enable Spot & Margin TradingSí, para bots spotPermite que la clave coloque órdenes spot
Enable FuturesSí, para bots de futurosPermite que la clave coloque órdenes de futuros; solo es posible si la cuenta de Futuros existía cuando se creó la clave
Enable WithdrawalsNuncaUn bot de trading nunca necesita sacar dinero de tu cuenta
Cualquier otro permiso (transferencias, préstamos, otros productos)NoNo hace falta para operar, así que déjalo desactivado

Dale a una clave solo los permisos que necesita la app. Es el principio de mínimo privilegio, y limita lo que cualquiera podría hacer con la clave si alguna vez se filtrara. Más sobre esto en seguridad de API de exchange y mitigación de riesgos.

Por qué Binance pide una IP de confianza

Binance trata una clave sin restricción de IP como una clave «sin restricciones» (unrestricted), y una clave System generated sin restricciones por defecto solo puede leer. Para marcar un permiso de trading, primero restringes la clave a direcciones IP de confianza. Binance también desaconseja firmemente activar cualquier permiso más allá de la lectura en una clave sin restricción de IP.

La restricción significa que la clave solo funciona cuando la solicitud llega desde una de las direcciones que indicaste. Una copia de la clave usada desde cualquier otro lugar se rechaza.

Para Freya, añade todas las direcciones que Freya muestra en la ventana Agregar clave API. Freya no acepta una clave sin restricción de IP.

Por qué los retiros quedan desactivados

Freya solo necesita leer tu cuenta y colocar operaciones. Tu capital de trading nunca sale de tu cuenta del exchange. Freya nunca retira nada de tu cuenta del exchange; no puede hacerlo, porque solo acepta claves API sin permiso de retiro. Si se añade una clave con permiso de retiro, Freya la rechaza y no la guarda.

La misma regla te protege con cualquier app: con los retiros desactivados, la clave no puede sacar fondos de tu cuenta. Una clave de trading sí puede colocar órdenes, por eso importan la restricción de IP y mantener el secreto en privado. Si una plataforma es confiable en otros aspectos es otra cuestión; ¿es Freya Finance legítima y segura? explica qué revisar.

Cómo añadir tu API key de Binance a Freya

  1. En Freya, ve a Configuración → Claves API y selecciona Agregar clave API.
  2. Elige Binance Spot o Binance Futuros, según el permiso que marcaste.
  3. Pega la API Key y la Secret Key, y ponle un nombre a la clave.
  4. Freya comprueba la clave al instante y te dice si falta algo.

Tu clave y tu secreto se cifran (Google Cloud KMS) antes de guardarse. La guía completa, incluidos los demás exchanges, está en conecta tu exchange con una clave API. Cuando la clave esté verificada, puedes configurar un bot de trading para Binance.

Errores comunes de la API key de Binance

Si Freya no puede verificar la clave, muestra uno de estos mensajes:

Lo que muestra FreyaQué significaCómo solucionarlo
Clave API inválidaLa clave se copió malVuelve a copiar la clave API exactamente, o crea una nueva
Clave secreta inválidaEl secreto no coincide con la claveVuelve a copiar el secreto; si lo perdiste, crea una clave nueva
Tu clave API está configurada en modo "Sin restricciones"La clave no tiene restricción de IPRestringe la clave a IP de confianza y añade las direcciones que muestra Freya
Dirección IP no incluida en lista blancaLa clave no está restringida a las direcciones de Freya, o Binance rechazó la clave (por ejemplo, fue eliminada) o sus permisosAñade las direcciones que muestra Freya a las IP de confianza de la clave y comprueba en Binance que la clave sigue existiendo y tiene los permisos necesarios
El permiso de retiro está activadoLa clave puede retirar fondos, por eso Freya no la guardaDesactiva el retiro, o crea una clave nueva sin él
Permiso de trading spot deshabilitadoLa clave no puede colocar órdenes spotMarca Enable Spot & Margin Trading
Permiso de futuros deshabilitadoLa clave no puede colocar órdenes de futurosAbre primero tu cuenta de Futuros y después marca Enable Futures

Si llamas a la API de Binance desde tu propio código, los mismos problemas suelen volver de Binance como «Invalid API-key, IP, or permissions for action». Revisa la clave, la lista de IP de confianza y los permisos, en ese orden. Encontrarás más soluciones en errores de conexión de la clave API.

Mantén segura tu API key de Binance

  • Nunca pegues el secreto en un chat, un correo electrónico o un formulario al que llegaste desde un enlace. Nadie del soporte de Binance ni de Freya lo necesita.
  • Usa una clave por app, con el nombre de la app, para poder eliminar una sin afectar a las demás.
  • Elimina en API Management las claves que ya no uses.
  • Si crees que un secreto quedó expuesto, elimina la clave en Binance y crea una nueva.

El trading automatizado conlleva riesgo. Un bot sigue las reglas que le das, incluidas las malas, y ninguna estrategia elimina la posibilidad de pérdidas. Nada de esto es asesoramiento financiero.

Preguntas frecuentes

¿Cómo obtengo mi API key de Binance?

En el sitio web de Binance, ve a Account → API Management, elige Create API y System generated, ponle un nombre a la clave y confirma con tu 2FA. En la app, toca More y luego API Management dentro de Others. Binance muestra la API Key y la Secret Key una sola vez, así que copia ambas de inmediato.

¿Qué permisos necesita una API key de Binance para un bot de trading?

Enable Reading, más Enable Spot & Margin Trading para bots spot o Enable Futures para bots de futuros. Deja desactivados Enable Withdrawals y cualquier otro permiso. Un bot de trading nunca necesita sacar dinero de tu cuenta.

¿Por qué no puedo activar el trading en mi API key de Binance?

Porque la clave no tiene restricción de IP. Por defecto, Binance limita a la lectura una clave System generated sin IP de confianza. Selecciona Restrict access to trusted IPs only, añade las direcciones IP del bot y los permisos de trading quedarán disponibles.

¿Por qué no puedo activar Futures en mi API key de Binance?

Binance no permite el permiso de Futures en una clave creada antes de que existiera tu cuenta de Futuros. Abre primero la cuenta de Futuros y después crea una clave nueva. Binance también bloquea el permiso de Futures mientras Portfolio Margin está activo.

¿Es seguro darle mi API key de Binance a un bot de trading?

Puede serlo si la clave está bien configurada: retiros desactivados, restringida a las direcciones IP del bot y solo con el permiso de trading que el bot necesita. Con los retiros desactivados, la clave no puede sacar fondos de tu cuenta. Freya rechaza las claves con permiso de retiro y las claves sin restricción de IP.

¿Puedo usar una cuenta de Binance TR o Binance US con Freya?

No. Freya se conecta solo a la API global de Binance, así que solo se conectan las cuentas globales de Binance. Las cuentas de Binance TR, Binance US y Binance Japan no pueden conectarse.

¿Binance cobra por una API key?

Crear una API key en Binance es gratis. Tus operaciones pagan las comisiones de trading normales de Binance, tanto si las colocas a mano como a través de un bot.

¿Puedo usar la misma API key de Binance en dos apps?

Puedes, pero es más seguro crear una clave por app. Así cada clave tiene solo los permisos y las direcciones IP que necesita esa app, y puedes eliminar una sin romper la otra.


Lecturas relacionadas

Crea una cuenta

Pon en práctica lo que aprendiste y abre una cuenta de Freya hoy.

Regístrate ahora

Artículos Relacionados

Este contenido es solo con fines educativos y no constituye asesoramiento financiero. El trading de criptomonedas conlleva riesgos significativos. Nunca invierta más de lo que puede permitirse perder.