A veces, cuando creas un bot en TradeSanta, podrías ver el error “Invalid API Key.”
En este caso, el bot no comenzará a operar y la barra debajo de la opción “Stop Bot” se vuelve roja, mostrando el mismo mensaje — Invalid API Key.
Entonces, ¿qué significa esto y cómo puedes solucionarlo?
⚙️ Qué causa el error “Invalid API Key”
Este error suele significar que tu API key fue creada con permisos incorrectos o que la lista blanca de IP no se configuró correctamente al conectar tu exchange a TradeSanta.
En otras palabras, la API key no permite que TradeSanta acceda a los datos de trading o ejecute operaciones debido a configuraciones faltantes o incorrectas.
Repasemos lo que debes verificar dependiendo del exchange que estés utilizando.
🟡 Binance
Si conectaste Binance y viste “Invalid API Key,” por favor verifica los siguientes permisos en tu página de API Management en Binance:
Permisos requeridos:
- ✅ Enable Reading — debe estar on
- ✅ Enable Spot & Margin Trading — debe estar on
- ❌ Enable Withdrawals — debe estar off
- ❌ Enable Symbol Whitelist — debe estar off
- 🔒 Restricciones de dirección IP:
- Debe estar en Restricted con la TradeSanta’s IP whitelist para mayor seguridad
Puedes encontrar tu lista de IP única en tu cuenta de TradeSanta en
Your exchanges → Binance → IP List.
Asegúrate de que todas las IP estén copiadas y pegadas en el campo “Restrict access to trusted IPs only” en Binance.
Si la lista blanca falta o es incorrecta, la API key no funcionará y el bot mostrará Invalid API Key.
Puedes encontrar la configuración completa paso a paso aquí:
Cómo crear una API key en Binance
Cómo habilitar la lista blanca de IP en Binance/Binance Futures
🔵 HTX (Huobi)
Si estás usando HTX (anteriormente Huobi), abre tu página de Gestión de API y comprueba que los permisos de tu clave coinciden con los siguientes:
Permisos requeridos:
- ✅ Solo lectura — activado
- ✅ Trade — activado
- ❌ Withdraw — desactivado
- 🌐 Vincular dirección IP: permanecer vacío
Si tus permisos se configuraron incorrectamente, o ya no tienes la opción de editarlos, crea una nueva clave API y asegúrate de habilitar las opciones correctas mencionadas anteriormente.
Puedes encontrar la configuración completa paso a paso aquí:
Cómo crear una clave API en HTX
⚫ OKX
Si estás conectando OKX, comprueba cuidadosamente los permisos y ajustes de tu clave.
Las razones comunes para el error “Clave API inválida” en OKX incluyen la falta de permiso de trade, una frase de contraseña incorrecta o una lista blanca de IP no configurada.
Permisos requeridos:
- ✅ Lectura — activado
- ✅ Trade — activado
- ❌ Withdraw — desactivado
- 🧩 Passphrase: debe coincidir exactamente con la que ingresaste en TradeSanta
- 🌐 Lista blanca de IP: en blanco
Puedes encontrar la guía de configuración completa aquí:
Cómo crear API en OKX
🧭 Qué hacer si el error persiste
Si tu clave API se creó con los permisos o IPs incorrectos y ya no puedes editarla, por favor:
- Elimina la clave antigua en tu cuenta del exchange.
- Crea una nueva clave con los permisos y la lista blanca de IP correctos.
- Vuelve a conectar tu exchange en TradeSanta.
Puedes aprender cómo reemplazar de forma segura tu antigua clave API por una nueva aquí:
Cómo actualizar el punto de acceso con una nueva clave API
✅ Lista de verificación final
Antes de volver a conectar, asegúrate de que:
- Todos los permisos requeridos están habilitados (Lectura + Trade, sin Withdraw).
- Las IPs de TradeSanta se han añadido correctamente a la lista blanca.
- La Passphrase (para OKX) coincide exactamente.
- La clave API y el secreto se copiaron correctamente, sin espacios adicionales.
Una vez que todos los ajustes sean correctos, vuelve a conectar el exchange en TradeSanta — tu bot debería empezar a operar con éxito.