Tutorials26 de abril de 202610 min de lectura

    Configuración TradingView a 3Commas, un setup webhook limpio y confiable (con pitfalls)

    Configuración paso a paso para enviar alertas de TradingView a 3Commas vía webhooks. Formatos reales de payload, manejo de duplicados, modos de fallo comunes y cuándo graduarse fuera de este stack.

    Por Timo de blockresearch.ai
    Configuración TradingView a 3Commas, un setup webhook limpio y confiable (con pitfalls)

    Configuración TradingView a 3Commas, un setup webhook limpio y confiable (con pitfalls)

    Si estás enviando alertas de TradingView a 3Commas y la mitad nunca se dispara, no estás solo. Este es el eslabón roto más común en la automatización crypto retail, y casi siempre es un problema de configuración, no de plataforma.

    Déjame hablar de esto directamente: TradingView a 3Commas funciona de forma confiable cuando lo configuras correctamente, y se rompe silenciosamente cuando no. Llevo cableando estos tubos juntos desde 2017, corriéndolo en producción en nuestras propias cuentas y guiando a cientos de estudiantes de Fiverr a través del setup. Este artículo es la versión limpia de ese recorrido, el formato exacto del payload, la configuración del webhook, la lógica de manejo de duplicados y los modos de fallo que eventualmente te morderán si no diseñas alrededor.

    Sin humo. Solo el setup que funciona y los bordes donde se cae.

    Qué hace realmente este stack

    TradingView es tu capa de señal. Corres una estrategia o indicador en un chart, dispara alertas cuando se cumplen condiciones, y esas alertas postean un webhook a 3Commas. 3Commas es tu capa de ejecución. Recibe el webhook, busca el bot DCA o smart trade asociado, y coloca órdenes en tu exchange conectado.

    Tres partes móviles. Cada una puede fallar independientemente. El trabajo es entender dónde ocurren los fallos y diseñar para ellos.

    • TradingView tiene el mejor sistema de charting y alertas en retail.
    • 3Commas tiene amplio soporte de exchange y un motor de ejecución razonable.
    • El puente webhook entre ellos es gratis si ya tienes ambos.
    • Puedes cablear una señal basada en confluencia de algo como block algo flex directo a un bot DCA de 3Commas sin escribir una línea de código.

    Es un stack práctico. No es perfecto, llegaremos a eso.

    Paso a paso: el setup completo

    Aquí la secuencia real. Hazlo en este orden o estarás debugeando fantasmas.

    1. Crea tu bot DCA de 3Commas primero. Configura tamaño de orden base, max safety orders, porcentaje take-profit, y conéctalo a tu API del exchange. No habilites la "deal start condition" como indicador, vas a gatillarlo manualmente vía webhook.
    2. Consigue la URL webhook de tu bot y el token de inicio de deal desde 3Commas. En los ajustes del bot, 3Commas expone una URL única más un token secret que autentica las solicitudes entrantes.
    3. Configura tu alerta de TradingView en el chart. Usa una estrategia que soporte plantillas de mensaje de alerta, o un indicador con condiciones de alerta. Para señales de confluencia, block algo flex ya emite los campos de alerta correctos.
    4. Configura la URL webhook en el diálogo de alerta. Pega la URL de 3Commas en el campo "Webhook URL". Habilita el checkbox "Webhook URL", este es el que los usuarios olvidan.
    5. Configura el cuerpo del mensaje de alerta. Este es el payload JSON que 3Commas espera. Formato exacto abajo.
    6. Prueba con un bot pequeño y un gatillo manual primero. Dispara una alerta, observa el log de 3Commas, confirma que el deal abrió. No te saltes esto.
    7. Configura la expiración de alerta a "open-ended" y la frecuencia a "once per bar close". Disparo en cierre de barra evita flapping intra-barra. Una vez por barra significa que no doble-disparas sobre la misma condición.
    8. Añade una capa de protección contra duplicados (cubierto abajo).

    Ese es el setup mínimo viable. Funciona. También es donde paran la mayoría de tutoriales, razón por la que la mayoría de setups retail eventualmente fallan silenciosamente.

    El formato JSON exacto del payload

    3Commas espera una estructura específica. El payload canónico de start-deal para un bot DCA long se ve así:

    {
      "message_type": "bot",
      "bot_id": 123456,
      "email_token": "your-3commas-email-token",
      "delay_seconds": 0,
      "pair": "USDT_BTC"
    }
    

    Campo por campo:

    • message_type, siempre "bot" para un gatillo de bot DCA.
    • bot_id, el ID numérico de tu bot, visible en la URL de 3Commas cuando abres el bot.
    • email_token, un token secreto por-bot que autentica el webhook. Trátalo como API key.
    • delay_seconds, cuánto espera 3Commas antes de actuar. Normalmente 0.
    • pair, el par de trading en formato 3Commas. Nota el orden QUOTE_BASE, no al revés.

    Si cualquier campo está mal, 3Commas rechaza silenciosamente el webhook y no te lo dice. Ese es el modo de fallo más común para setups nuevos.

    Por qué el formato del par tropieza a todos

    TradingView muestra BTCUSDT. 3Commas quiere USDT_BTC. Esto ha costado más deals que cualquier otro error de configuración individual. Si estás plantillando el par dinámicamente en TradingView vía {{ticker}}, necesitas una capa de transformación. El fix más simple es hard-codear el par en el mensaje de alerta por-bot en lugar de plantillarlo.

    Payload close-deal

    Para cerrar un deal vía webhook (si usas TradingView para salir en vez del take-profit interno del bot):

    {
      "action": "close_at_market_price",
      "message_type": "bot",
      "bot_id": 123456,
      "email_token": "your-3commas-email-token"
    }
    

    De nuevo, message_type y email_token son obligatorios. Si falta cualquiera la solicitud falla silenciosamente.

    Alertas duplicadas y cómo manejarlas

    TradingView puede disparar la misma alerta dos veces. Reintentos de red, re-evaluación de barra en revisiones de datos, rarezas del motor de alertas, pasa. Si ambas disparan, 3Commas abrirá dos deals si tu bot lo permite, o rechazará el segundo, dependiendo de tu ajuste de max-active-deals.

    Tienes dos opciones. Primera, configura max_active_deals a 1 en el lado de 3Commas. Segunda, si necesitas múltiples deals concurrentes, añade un cooldown en tu lógica de alerta para que la misma señal no pueda disparar dos veces dentro de N minutos.

    Ninguna es perfecta. Ambas son mejores que nada.

    El ajuste "frequency" importa más de lo que piensa la gente

    En el diálogo de alerta de TradingView, la opción Once Per Bar Close es el default más seguro para la mayoría de estrategias. Once Per Bar dispara en cada tick dentro de la barra tan pronto como la condición sea verdadera, inestable. Only Once dispara una sola vez total y luego deshabilita la alerta, casi nunca es lo que quieres.

    Configura cada alerta de producción a Once Per Bar Close a menos que tengas una razón muy específica en contra.

    Modos de fallo comunes (la lista honesta)

    Cosas que eventualmente saldrán mal con este setup:

    • Rechazo silencioso de alerta. Checkbox de URL webhook no habilitado, JSON malformado, email_token equivocado. 3Commas no te envía email cuando esto pasa.
    • Alertas perdidas. La entrega de alertas de TradingView no tiene SLA. Drops ocasionales pasan. Durante eventos de alta volatilidad, la cola puede atascarse.
    • Latencia de round-trip de red. La alerta dispara, el webhook postea, 3Commas encola, el exchange ejecuta. Latencia típica es 2 to 8 segundos. En wicks volátiles, tu precio de fill puede diferir significativamente del precio de la alerta.
    • Rechazos del exchange. API key expirada, balance insuficiente, par no disponible en esa cuenta. 3Commas los logea; rara vez miras el log hasta que algo va mal.
    • Revisión de barra. TradingView a veces revisa barras históricas tras correcciones de feed de datos. Si tu condición de alerta se vuelve verdadera en una barra revisada, no se re-disparará, pero tu backtest mostrará que sí.

    Ninguno de estos es deal-breaker para un setup DCA retail. Todos son razones por las que debes estar monitoreando el log de actividad de tu bot diariamente, no set-and-forget durante seis meses.

    Monitoreo, mínimo viable

    • Diario: checa el log del bot 3Commas para aperturas/cierres de deals y mensajes de error.
    • Semanal: reconcilia conteo de deals contra conteo de alertas en TradingView. Las alertas perdidas aparecen aquí.
    • Mensual: audita el scope de la API key del exchange y el balance. Las keys expiradas son el asesino silencioso.

    Aburrido, sí. Esta es la parte que separa los setups que corren durante años de los que mueren en tres meses.

    Cuándo este stack no es suficiente

    TradingView → 3Commas es genial para bots DCA retail sobre pares crypto mayores. Empieza a crujir cuando:

    • Necesitas ejecución sub-segundo. El round-trip simplemente no es lo suficientemente rápido.
    • Quieres operar acciones EE.UU. 3Commas no ejecuta acciones; es crypto-only.
    • Quieres operar CFDs en Capital.com. Mismo issue.
    • Necesitas entrega garantizada con semántica de reintentos. TradingView no garantiza alertas; 3Commas no garantiza ejecución.
    • Quieres que la capa de ejecución aplique sus propios chequeos de riesgo más allá de lo que permita la config del bot.

    Aquí es donde SignalPipe encaja, es el motor nativo de ejecución webhook que construimos exactamente para estos casos. Alpaca para acciones EE.UU., Capital.com para CFDs globales, protección contra race conditions, almacenamiento cifrado de credenciales API, y una capa de sync de posición que captura fills que el broker reporta out-of-band.

    Si estás feliz corriendo bots DCA en Binance o ByBit con latencia de ejecución de 2 a 8 segundos, quédate en 3Commas. Si necesitas más rápido, más amplio o más estricto, gradúate.

    Una plantilla de mensaje de alerta lista para producción

    Para una señal de confluencia disparando un bot DCA long, este es el mensaje que realmente uso en alertas:

    {
      "message_type": "bot",
      "bot_id": 123456,
      "email_token": "abc123-your-token-here",
      "delay_seconds": 0,
      "pair": "USDT_BTC",
      "timestamp": "{{time}}"
    }
    

    El campo timestamp no es requerido por 3Commas pero es útil en tus propios logs. La mayoría de usuarios lo saltan. Yo no.

    Si estás usando vyn premium

    La estrategia vyn premium envía mensajes de alerta pre-configurados para 3Commas, SignalPipe, Alpaca y Capital.com. Los pegas en las alertas de TradingView una vez y la estrategia maneja el resto. Las Smart Safety Orders disparan como webhooks adicionales con los parámetros correctos de deal_id y acción, sin edición manual de JSON.

    Comparación rápida, venues de ejecución para alertas de TradingView

    VenuePara qué esLatenciaMejor para
    3CommasDCA crypto + smart trades2 to 8sCrypto retail
    SignalPipe (Alpaca)Acciones EE.UU., sin comisionesSub-3sAutomatización de acciones
    SignalPipe (Capital.com)CFDs globalesSub-3sFX, índices, acciones
    TradersPostPuente multi-brokerVariableSetups mixtos de broker
    TickerlyPuente webhook tier medioVariableSetups más simples

    Elige el venue que coincida con el activo. No intentes forzar a 3Commas a hacer acciones.

    FAQ

    ¿Por qué mi bot 3Commas no está abriendo deals? Lo más probable es uno de: checkbox de URL webhook no habilitado en TradingView, JSON malformado en el mensaje de alerta, email_token equivocado, nombre de par en formato equivocado (USDT_BTC no BTCUSDT), o max active deals ya alcanzado en el bot. Checa el log del bot 3Commas primero.

    ¿Puedo enviar la misma alerta a múltiples bots? TradingView soporta solo una URL webhook por alerta. Workaround: crea alertas duplicadas con IDs de bot distintos, o usa un servicio de webhook fan-out entre TradingView y 3Commas.

    ¿Qué pasa si mi plan de TradingView se queda sin alertas? Las alertas silenciosamente paran de disparar cuando golpeas tu límite de plan. TradingView no te envía email. Checa el alert manager periódicamente.

    ¿Es 3Commas seguro para API keys? Usa API keys con permisos de trade solo, nunca permisos de withdrawal. Whitelist IPs de 3Commas donde el exchange lo soporte. Rota keys anualmente.

    ¿Necesito una suscripción Pro de TradingView? Para webhooks confiables, sí. El tier gratis no tiene soporte de webhook. Pro, Pro+ o Premium todos soportan alertas con URLs webhook.

    ¿Cómo manejo señales cortas en un bot DCA long? No lo haces. Los bots DCA long solo entienden deals del lado long. Para cortos, crea un bot DCA corto separado y envía señales cortas a su webhook. Mezclar señales long y short en un bot no es soportado.

    ¿Puedo backtestear este setup exacto? Puedes backtestear la estrategia en TradingView. La entrega del webhook y la ejecución de 3Commas no son parte del backtest. El paper-trading en vivo en 3Commas es la aproximación más cercana. Ve backtesting de bots de trading para el panorama más amplio.

    Aviso de riesgo

    La automatización basada en webhooks introduce múltiples puntos de fallo, entrega de alerta de TradingView, round-trip de red, encolamiento de 3Commas, ejecución del exchange. Prueba cada setup nuevo en paper trading antes de ir en vivo. Monitorea logs de actividad del bot regularmente. Nunca despliegues con API keys que tengan permisos de withdrawal habilitados. El rendimiento pasado de cualquier estrategia no es indicativo de resultados futuros.

    El veredicto honesto

    TradingView a 3Commas funciona. No es el más rápido, no es el más robusto, y no es el stack correcto para acciones EE.UU. o CFDs. Pero para DCA crypto retail sigue siendo la forma más accesible de conectar una estrategia de TradingView a ejecución en vivo sin escribir una línea de código.

    Los modos de fallo son predecibles. Formato de par, email token, checkbox de URL webhook, timing de cierre de barra, manejo de duplicados. Acierta esos cinco y el setup es estable durante años. Falla cualquiera y pasarás un fin de semana debugeando algo que debería haber tomado diez minutos.

    Si necesitas ejecución más rápida o soporte de activos más amplio, acciones EE.UU. en Alpaca, CFDs en Capital.com, entrega sub-segundo con semántica de reintentos, eso es para lo que existe SignalPipe. Es la capa de ejecución nativa detrás de vyn premium y está construida alrededor del mismo patrón webhook, solo con confiabilidad de grado producción.

    Elige el stack que coincida con el trabajo. No sobre-ingenierices cuando 3Commas es suficiente. No sub-ingenierices cuando no lo es.

    #tradingview#3commas#webhook#setup
    Sobre el autor

    Timo de blockresearch.ai

    Fundador de Block Research. Opera sistemas de trading automatizado con capital propio y de la empresa desde 2017, tres ciclos cripto completos de ejecución en vivo. Autor de Smart Safety Orders (DCA adaptativo a la volatilidad), las entradas de reversión a la media dentro de vyn premium y la invariante de respuesta webhook de 3 segundos dentro de SignalPipe. Publicamos las mismas estrategias que operamos con nuestro propio dinero.