Guía Apta para Principiantes

Configura el Bot de Trading unCoded en tu Propio Servidor

Ejecuta el bot en tu propio servidor y conéctalo a tu exchange, sin escribir una sola línea de código.

Tu Propio Servidor

En Alemania

API de Exchange Segura

Subcuenta + lista blanca de IP

Trading Automatizado

Dashboard + Telegram opcional

Glosario Rápido

Parte 1

Antes de Empezar - Preparación Obligatoria

Sin estos tres puntos la configuración no funcionará. Sáltatelos si ya usas activamente tu exchange.

Preparación A - Completa el KYC del Exchange

Resultado esperado: Una cuenta de exchange totalmente verificada (necesaria para APIs y subcuentas).

Las APIs de trading y las subcuentas solo están disponibles para usuarios de exchange totalmente verificados.

Preparación B - Activa la 2FA

Resultado esperado: Autenticación de dos factores activa en tu cuenta de exchange.

Tu exchange exige 2FA antes de que puedas crear cualquier API key.

Si pierdes tu teléfono sin una clave de respaldo, perderás el acceso a tu cuenta. Una llave hardware YubiKey añade una protección aún más fuerte.

Preparación C - Recarga con USDC o FDUSD

Resultado esperado: Moneda de cotización lista para transferir a tu subcuenta.

El bot opera contra una moneda de cotización que debe estar en la subcuenta antes del lanzamiento.

Parte 2

Configuración Paso a Paso

Catorce pasos desde la compra del servidor hasta un bot completamente operativo.

1

Compra un Servidor en Zeabur

Resultado esperado: Un servidor en funcionamiento en Alemania con su propia dirección IPv4.

  • Abre el dashboard de Zeabur e inicia sesión con Google.
  • Haz clic en 'Buy More Servers'.
  • Selecciona Hetzner en Alemania (unos 16 USD / mes).
  • Especificaciones: 4 vCPUs, ubicación Alemania, IP dedicada.

Red de seguridad: dentro de 7 días puedes reembolsar el servidor. También puedes desactivar la Auto-Renovación si solo quieres probar durante un mes. El tiempo de arranque es de unos 3 a 4 minutos.

Resultado: El servidor está funcionando y la dirección IPv4 está anotada.

2

Abre la Plantilla de unCoded

Resultado esperado: El formulario de Zeabur abierto y listo para rellenar.

  • En Zeabur ve a 'Projects' -> 'Generate Project'.
  • En 'Deploy New Service' busca 'uncoded'.
  • Selecciona el servidor que acabas de comprar.

No rellenes nada todavía, recopilaremos los valores necesarios en los siguientes pasos.

3

Crea una Subcuenta en el Exchange

Resultado esperado: Una segunda cuenta de exchange separada de forma limpia de tu cuenta principal.

  • Haz clic en tu foto de perfil en tu exchange (arriba a la derecha).
  • Haz clic en 'Sub Accounts' (o equivalente) en el menú.
  • 'Create Sub Account' -> 'Create with Mail'.
  • Introduce un segundo correo electrónico y una contraseña.
  • Activa 'Switchable' para poder alternar entre la cuenta principal y la subcuenta con un clic.

4

Crea una API Key en tu Exchange

Resultado esperado: API Key y Secret Key introducidas en la plantilla de Zeabur.

Nunca actives permisos de retiro en la API. Los bots de trading solo necesitan permisos de lectura + trading. La lista blanca de IP y el permiso de trading se configuran intencionalmente más tarde, en el Paso 9.

  • Cambia a la subcuenta (selector arriba a la izquierda).
  • Perfil -> 'API Management'.
  • 'Create API' -> 'System Generated'.
  • Dale un nombre como 'uncoded Bot' -> Next.
  • Confirma con 2FA / YubiKey.
  • Copia la API Key y la Secret Key en los campos de Zeabur 'Exchange API Key' / 'Exchange Secret Key'.

Copia la Secret Key inmediatamente, nunca se vuelve a mostrar después de cerrar la página. No la compartas con nadie.

Resultado: La API Key y la Secret Key están introducidas en la plantilla de Zeabur.

5

Establece las Contraseñas del Dashboard

Resultado esperado: Dos contraseñas de acceso para tu futuro dashboard.

La plantilla de Zeabur tiene dos campos de contraseña:

Usa contraseñas fuertes con caracteres especiales. Nada de 'Test1' o similar.

  • Dashboard Admin Password, acceso completo incluyendo todos los ajustes.
  • Dashboard View Password, solo lectura, por ejemplo para alguien a quien quieras mostrar el bot.

6

(Opcional) Crea un Bot de Telegram

Resultado esperado: Un token de bot para las notificaciones de Telegram.

Si no quieres notificaciones de Telegram, simplemente introduce 00 en ambos campos de Telegram y pasa al Paso 8. Con Telegram recibes un mensaje por operación con la ganancia, la ganancia total y el volumen.

  • En Telegram busca @BotFather.
  • 'Start' -> envía el comando /newbot.
  • Dale un nombre visible (p. ej. 'Uncoded Trading Bot').
  • Dale un nombre de usuario interno (debe terminar en 'bot' y ser único globalmente).
  • BotFather devuelve un token como 123456789:ABCdefGhi... pégalo en el campo de Zeabur 'Telegram Bot Token'.

7

(Opcional) Obtén el ID del Grupo de Telegram

Resultado esperado: El ID del grupo, incluido el signo menos, introducido en la plantilla de Zeabur.

El signo menos '-' debe copiarse junto con el número. Sin él la conexión fallará.

  • En Telegram crea un nuevo grupo (p. ej. 'Uncoded Trading').
  • Añade tu bot de uncoded recién creado al grupo.
  • Añade también el bot auxiliar @myidbot al grupo.
  • Asciende a ambos bots a administrador (clic derecho / pulsación larga sobre el bot -> 'Promote to Admin' -> Save).
  • En el grupo envía /getgroupid a @myidbot.
  • Obtendrás un ID de grupo con signo menos, p. ej. -1001234567890.

8

Configura los Dominios y Lanza el Despliegue

Resultado esperado: Dos URLs propias de dashboard y un despliegue en funcionamiento.

Se requieren dos nombres de dominio en la plantilla:

  • Dominio del dashboard (p. ej. uncoded-tunombre-1), dashboard web para la configuración.
  • Dominio de señales (p. ej. uncoded-tunombre-2), endpoint para las señales de TradingView.
  • Reglas: solo minúsculas, ambos nombres deben ser diferentes.
  • Opcional: establece ahora una contraseña de TradingView si usarás señales de TradingView más adelante (se puede cambiar en cualquier momento).
  • Elige el servidor correcto abajo y haz clic en 'Confirm'.

9

Añade la IP del Servidor a la Lista Blanca en tu Exchange (¡crítico!)

Resultado esperado: Una API key lista para operar que solo puede usarse desde tu servidor.

Hasta que se configure la lista blanca de IP, ni siquiera se puede seleccionar 'Enable Spot & Margin Trading' en tu exchange. Es una función de seguridad, no un error.

  • En Zeabur -> 'Servers' -> haz clic en tu servidor -> copia la dirección IPv4.
  • Vuelve a tu exchange -> 'API Management' -> haz clic en 'Edit restrictions' en tu API key de uncoded.
  • Activa 'Restrict access to trusted IPs only'.
  • Introduce la IP del servidor -> Confirm.
  • Ahora puedes marcar 'Enable Spot & Margin Trading' -> actívalo.
  • Confirma con 2FA y 'Save'. NO actives los retiros de la API, solo trading.

Por qué esto es tan seguro: incluso si alguien tiene tu API Key y Secret, no puede hacer nada, solo esta IP de servidor está autorizada a operar.

10

Inicia Sesión en el Dashboard

Resultado esperado: Acceso al dashboard de unCoded a través de tu propio dominio.

Una vez que el dominio del dashboard esté en verde en Zeabur ('Online' / 'Running'), ábrelo en el navegador e inicia sesión con la contraseña de administrador del Paso 5.

11

Elige el Modo de Trading y la Estrategia

Resultado esperado: Un bot totalmente configurado con modo, moneda de cotización, pares y perfil de riesgo.

En el dashboard selecciona lo siguiente en orden:

  • Tipo de bot: Multi-Token Bot (estándar para la mayoría de usuarios). High-Frequency Bot es market making de un solo token, normalmente NO es lo que quieres.
  • Moneda de cotización: USDC dentro de la UE; FDUSD posible fuera de la UE (comisiones de trading reducidas / nulas).
  • Pares de trading: BTC y ETH son buenos para empezar, alta liquidez, menor deslizamiento.
  • Perfil de riesgo: Low = conservador (recomendado para principiantes). Medium / High = más agresivo (más divisiones, posiciones más grandes, menos reserva).
  • -> Confirm -> Start.

12

Vincula tu Cuenta de Google

Resultado esperado: Tu licencia queda asociada a tu identidad de Google.

  • En el dashboard haz clic en 'Open'.
  • Inicia sesión con tu cuenta de Google.
  • Acepta los Términos de Servicio.
  • Haz clic en 'Start'.

Precio: el bot cuesta entre el 20 y el 30% de la ganancia realizada. Sin ganancia = sin coste. Los nuevos usuarios reciben actualmente un crédito de licencia de 25 USD.

13

Activa tu Licencia

Resultado esperado: Bot vinculado de forma única a tu cuenta.

Solo la API Key pública, nunca la Secret Key.

  • En el dashboard haz clic en 'Top-up License', serás redirigido a tu cuenta de unCoded.
  • Desplázate hasta 'Your IDs'.
  • Introduce aquí la API Key pública del exchange.
14

Verifica que Todo Funciona

Resultado esperado: Confianza en que el bot funciona correctamente.

  • Abre el servicio del bot de trading en tu proyecto de Zeabur -> haz clic en 'Logs'.
  • No deberían aparecer errores en rojo.
  • Las operaciones se ejecutan muy rápido (~40 a 50 ms cada una). Pausa la vista de logs si lo necesitas.

Resultado: El bot funciona de forma independiente en tu propio servidor.

Parte 3

Cómo se Ve el Éxito

Así puedes saber, en las primeras 1 a 24 horas, que todo está funcionando.

Inmediatamente (en 5 minutos)

  • El dashboard muestra 'Bot Status: Running' (verde).
  • Los logs muestran entradas regulares como 'Checking conditions for BTCUSDC...' sin errores en rojo.

Dentro de la primera hora

  • Cuando las condiciones del mercado coincidan: aparecen las primeras órdenes de compra en los logs.
  • Si Telegram está activado: primera notificación (p. ej. 'BUY BTCUSDC at 65,420, Split 1/2').

Dentro de 24 horas

  • Primeras operaciones completadas (compra + venta) con visualización de ganancias.
  • Las estadísticas del dashboard empiezan a llenarse.

Si no ha ocurrido ninguna operación después de 24 horas: no es necesariamente un error. Con baja volatilidad o ajustes conservadores puede tardar de 1 a 3 días en cumplirse las primeras condiciones de entrada.

Parte 4

Solución de Problemas

Parte 5

Lista de Seguridad

Nunca compartas ni publiques tu Secret Key
Lista blanca de IP configurada en la API del exchange
Retiros de la API desactivados
Contraseña fuerte establecida en el dashboard
Usando una subcuenta, no la cuenta principal
2FA activa en tu exchange
Clave de respaldo de 2FA guardada de forma segura
Todas las contraseñas en un gestor de contraseñas
Parte 6

Ajustar Estrategias y Expectativas Realistas

Personalizar Más Adelante

  • Cambia el Modo (p. ej. modo Basic para mercados alcistas).
  • Ajusta las Divisiones (p. ej. 50/50).
  • Cambia estrategias para mercados alcistas / bajistas.
  • Explora estrategias públicas y el ranking en "Backtesting".

Expectativas Realistas

  • Referencia: ~17.000 operaciones / mes, ~1.200 USD de ganancia en el periodo de ejemplo.
  • Los resultados diarios suelen estar entre 12 y 27 USD, con casos excepcionales al alza.
  • Orientación aproximada: 30 a 40% de retorno anual como cifra realista.
  • La ganancia crece por escalones (las posiciones deben cerrarse), no de forma lineal.

Los mercados laterales y bajistas son donde el bot puede superar claramente al hodl. En rallies alcistas extremos el hodl puede ganar ocasionalmente, por eso el stop-loss y los indicadores de emergencia son importantes.

Parte 7

Riesgos y Descargo de Responsabilidad

  • Uso:bajo tu propia responsabilidad.
  • Rendimientos:sin garantía de ganancias futuras. Los resultados pasados no son una previsión.
  • Impuestos:esto no es asesoramiento fiscal. Las ganancias de trading pueden estar sujetas a impuestos según tu país.
  • Pérdidas:el trading de criptomonedas puede provocar pérdidas hasta la pérdida total del capital.
  • Responsabilidad:tú eres responsable de tu configuración, tus API keys y tu servidor.

Referencia Rápida

Para configuraciones repetidas.

  1. 1Compra un servidor Hetzner en Zeabur (4 vCPU, Alemania)
  2. 2Abre la plantilla de unCoded
  3. 3Crea una subcuenta en el exchange + transfiere USDC / FDUSD
  4. 4Crea la API Key + Secret Key (sin permisos de retiro)
  5. 5Establece las contraseñas del dashboard
  6. 6(Opcional) Crea un bot de Telegram con BotFather
  7. 7(Opcional) Obtén el ID del grupo de Telegram con @myidbot (¡incluye el signo menos!)
  8. 8Configura los dominios de dashboard + señales, lanza el despliegue
  9. 9Añade la IP del servidor a la lista blanca en tu exchange + activa el trading
  10. 10Inicia sesión en el dashboard
  11. 11Elige Multi-Token, moneda de cotización, pares y riesgo
  12. 12Vincula la cuenta de Google
  13. 13Activa la licencia (API Key pública)
  14. 14Verifica los logs

¿Necesitas la Documentación Completa?

La documentación completa está disponible en /docs.

    Guía de Configuración - Paso a Paso | unCoded