Webhook a cTrader: envía tus propias alertas como señales

Advertencia de riesgo: Operar con CFD y otros productos apalancados es complejo y conlleva un alto riesgo de perder dinero rápidamente debido al apalancamiento. Los datos del sector indican que el 70–80% de las cuentas de negociación minoristas pierden dinero con estos productos. Advertencia de riesgo · Rentabilidad pasada.

Esta ruta es agnóstica al origen: cualquier cosa capaz de emitir un POST HTTPS puede enviar señales, ya sea un script, un bot, un cron job o una automatización no-code. PipSync recibe y valida el payload en la nube, y las señales de Telegram y Discord sí se ejecutan en cTrader.

1. 1

   Crea tu cuenta de PipSync y elige un plan

   Regístrate en app.pipsync.io y suscríbete a un plan que incluya la integración por webhook (el plan Advanced); el plan Free no la incluye. Se requiere método de pago.

2. 2

   Conecta tu cuenta de cTrader

   Las señales de Telegram y Discord sí se ejecutan en cTrader. La cuenta puede conectarse desde Cuentas de trading → Añadir cuenta para otras fuentes, como Telegram. Las cuentas de cTrader están conectadas a través del gateway, así que por ahora los índices, el oro y las cripto no se operan automáticamente en ellas: su riesgo no se puede medir allí.

3. 3

   Genera tu URL de webhook

   En el panel, ve a Ajustes → Avanzado → Alertas de TradingView y pulsa Generar URL de webhook. PipSync genera una URL única con un token secreto, que se muestra una sola vez: cópiala y guárdala como cualquier secreto. Si sospechas una filtración, genera una nueva desde el mismo lugar; las alertas recibidas aparecen en Alertas recientes.

4. 4

   Envía tu primer POST JSON

   Desde tu propio código o desde curl, haz un POST de un cuerpo JSON a la URL. Lo necesario es instrument nombrado exactamente como lo lista tu bróker de cTrader, direction ("buy" o "sell"), entry, sl y tp1, con sl y tp mayores que 0.

5. 5

   Suscríbete a los eventos de ejecución

   Si tu sistema necesita confirmaciones, registra tu propio endpoint en los ajustes de PipSync. PipSync le hace POST de eventos firmados como trade.opened y trade.closed; verifica el encabezado X-PipSync-Signature antes de confiar en cualquier payload.

6. 6

   Envía un payload de prueba

   Envía un payload de prueba y revisa Alertas recientes en Ajustes → Avanzado → Alertas de TradingView para ver cómo se interpretó. Un webhook de tu propio sistema nunca se opera automáticamente: queda como señal para tu aprobación en la página de Señales.

Tiempo de configuración típico: unos 12 minutos.

No. cTrader no tiene un endpoint HTTP de entrada al que un sistema de terceros pueda llamar. La vía de integración oficial es la Open API de Spotware, que espera que construyas y alojes una aplicación autorizada: flujos OAuth, conexiones persistentes, metadatos de símbolos y manejo del ciclo de vida de las órdenes. La alternativa, un cBot escrito en C# dentro de cTrader Automate, solo corre mientras hay una terminal abierta.

Tu código hace un simple HTTP POST a tu URL de webhook de PipSync, que registra la señal para tu aprobación; un webhook de tu propio sistema nunca se opera automáticamente. No escribes ningún cBot ni mantienes infraestructura propia. Las señales de Telegram y Discord sí se ejecutan en cTrader.

Un objeto JSON pequeño y plano con cinco campos obligatorios: instrument, direction, entry, sl y tp1. Como es tu propio sistema el que produce el payload, la interpretación es determinista: no hay interpretación de texto libre, a diferencia de las rutas de Telegram donde un analizador con IA lee mensajes escritos por personas.

El único detalle que confunde a los desarrolladores es el nombrado de símbolos. El instrument del payload debe coincidir con el nombre del instrumento de tu bróker de cTrader exactamente como aparece en la lista de símbolos del bróker: los brókeres pueden usar su propia nomenclatura o sufijos para el mismo mercado. Un POST de prueba contra una cuenta demo te muestra el payload interpretado en el panel, la forma más rápida de verificarlo.

• instrument (obligatorio): el nombre del instrumento exactamente como lo lista tu bróker de cTrader
• direction (obligatorio): "buy" o "sell"
• entry (obligatorio): el precio de entrada de la señal
• sl (obligatorio): nivel de precio de Stop-Loss, mayor que 0
• tp1 (obligatorio): nivel de precio de Take-Profit, mayor que 0

Mediante webhooks salientes. Registra tu endpoint en los ajustes de PipSync y PipSync le hace POST de un payload JSON firmado: signal.received para las señales recibidas, y trade.opened, trade.closed, trade.tp_hit y trade.sl_hit solo para operaciones que PipSync coloca, no para un webhook de tu propio sistema, que nunca se opera automáticamente. La entrega se intenta hasta 5 veces con retroceso exponencial.

Cada entrega lleva un encabezado X-PipSync-Signature con la forma t=<unix-ts>,v1=<hex-hmac-sha256>. Verifica el HMAC con tu secreto de webhook usando una comparación de tiempo constante, y rechaza los payloads cuya marca de tiempo tenga más de 5 minutos para prevenir ataques de repetición.

Para acceso por sondeo también hay una API REST de lectura: GET /v1/signals y GET /v1/trades con paginación, respuestas de error RFC 7807 y una especificación OpenAPI 3.1 en /api/v1/openapi.json para generar clientes tipados. Las claves de API para ella están disponibles en el plan Enterprise; la fuente de webhook entrante y los webhooks de eventos salientes no la requieren.

Las solicitudes pueden estar sujetas a límites; si recibes un HTTP 429, espera y reintenta con retroceso. Si tu sistema emite ráfagas, aplica debounce o agrupa las señales aguas arriba.

La URL del webhook contiene un token secreto, así que poseer la URL es la credencial: trátala como una contraseña, mantenla en secreto y regenérala si sospechas una filtración, porque con el trading automático activado cualquiera que la tenga puede activar operaciones. Una solicitud de cualquier otro sistema siempre se guarda como señal para tu aprobación en la página de Señales.

Puedes integrarte directamente con la Open API de Spotware sin problema; está bien documentada. Lo que asumes es la parte operativa: registrar y mantener una aplicación autorizada, el manejo de tokens OAuth, la gestión de conexiones y las reconexiones, los metadatos de símbolos del bróker, los estados del ciclo de vida de las órdenes y el manejo de errores, además de alojar todo eso en algún lugar que nunca duerma. Eso es trabajo de ingeniería real para lo que a menudo es una sola tubería de POST a orden.

Enrutar a través de PipSync reduce eso a una sola petición HTTP: tu webhook llega como señal para tu aprobación y nunca se opera automáticamente; las señales de Telegram y Discord sí pueden ejecutarse en cTrader, Match-Trader, Binance Futures o Bybit.