Skip to main content
InicioIntegracionesWebhook → cTrader
Webhook personalizado → cTrader · guía para desarrolladores

Webhook a cTrader: ejecuta tus propias alertas con la Open API

Para enviar un webhook a cTrader, haz un POST de tu alerta JSON a una URL de webhook única de PipSync: PipSync valida el payload contra tus reglas de riesgo del lado del servidor y coloca la orden en tu cuenta de cTrader a través de la Open API oficial de Spotware, sin escribir ningún cBot ni mantener un VPS.

Empieza gratis — sin tarjetaVer precios

Advertencia de riesgo: Los CFD son instrumentos complejos y conllevan un alto riesgo de perder dinero rápidamente debido al apalancamiento. El 70–80% de las cuentas de inversores minoristas pierden dinero al operar con CFD. Advertencia de riesgo · Rentabilidad pasada.

Esta ruta está pensada para desarrolladores que ya tienen un sistema que produce decisiones de trading (un escáner, un bot en Python, un servicio interno de alertas) y quieren ejecutar en cTrader sin registrar su propia aplicación de Open API ni mantener un cBot en C#. Cualquier cosa que pueda hacer un HTTP POST se convierte en la fuente de señales; PipSync se encarga de la autenticación, el mapeo de símbolos, las comprobaciones de riesgo y el envío de la orden, y puede reenviar eventos de ejecución firmados de vuelta a tu propio endpoint.

Webhook personalizado → cTrader de un vistazo

Fuente de la señalCualquier sistema que pueda enviar un HTTP POST con un cuerpo JSON: scripts, escáneres, bots de trading, servicios internos
Plataforma de destinocTrader (Spotware) vía la Open API oficial, en vivo en la beta pública de PipSync
Contrato del payloadaction (buy/sell/close) y symbol obligatorios; price, sl, tp y lots opcionales; price 0 ejecuta a mercado
Software instaladoNinguno: sin cBot, sin proyecto de cTrader Automate, sin VPS; la ingesta y la ejecución corren en la nube
Límites de tasa de entradaPor plan: 10 webhooks/min (Basic), 60/min (Pro), 200/min (Business), personalizado (Enterprise)
Retroalimentación de ejecuciónWebhooks salientes firmados (X-PipSync-Signature, HMAC-SHA256) para eventos de trades; API REST de lectura en el plan Enterprise
PrecioPlan gratuito disponible (0 €); planes de pago desde 49 €/mes

¿Cómo conecto un webhook personalizado a cTrader?

El lado de PipSync es configuración en el panel; tu lado es un único HTTP POST desde el lenguaje en el que esté escrito tu sistema.

  1. Crea una cuenta gratuita de PipSync

    Regístrate en app.pipsync.io. No se requiere tarjeta de crédito, y el plan gratuito es suficiente para montar esta ruta y probarla de extremo a extremo desde curl antes de comprometerte con nada.

  2. Conecta tu cuenta de cTrader

    Agrega una cuenta de bróker en el panel y elige cTrader. La autorización ocurre a través de tu cTrader ID contra la Open API oficial de Spotware: concedes acceso una vez y luego seleccionas en qué cuenta de trading ejecuta esta ruta. Apúntala a una cuenta demo mientras integras.

  3. Crea una fuente de webhook y copia tu URL

    Agrega una fuente de webhook en el panel. PipSync genera una URL única que contiene un token secreto; esa URL es la credencial que usará tu sistema, así que guárdala como cualquier otro secreto y regenérala desde la página de Fuentes si alguna vez queda expuesta.

  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 mínimo es un action ("buy", "sell" o "close") y un symbol nombrado exactamente como lo lista tu bróker de cTrader; price, sl, tp y lots son opcionales y recurren a tus reglas de riesgo configuradas.

  5. Suscríbete a los eventos de ejecución

    Si tu sistema necesita confirmaciones, registra tu propio endpoint en Ajustes → Webhooks. 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. Prueba en demo y luego pasa a real

    Dispara un payload de ejemplo desde curl a la ruta demo y revisa el panel: muestra el payload interpretado y si el bróker aceptó la orden. Ejecuta alertas reales en la cuenta demo (con la Aprobación Manual activada si quieres confirmar cada trade) antes de apuntar la ruta a tu cuenta real.

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

¿cTrader puede recibir webhooks directamente?

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.

PipSync se sitúa entre tu sistema y la Open API como un endpoint alojado. Tu código hace un simple HTTP POST; PipSync se autentica contra Spotware en tu nombre, aplica tus reglas de riesgo del lado del servidor y envía la orden. No escribes ningún cBot, no registras ninguna aplicación de Open API y no mantienes infraestructura propia.

¿Qué JSON envío para operar en cTrader?

Un objeto JSON pequeño y plano. Dos campos son obligatorios, un action y un symbol, y todo lo demás es opcional, recurriendo a las reglas de riesgo que configuraste para la ruta. 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 symbol 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 y si el bróker aceptó la orden, la forma más rápida de verificar un mapeo.

  • action (obligatorio): "buy", "sell" o "close"
  • symbol (obligatorio): el nombre del instrumento exactamente como lo lista tu bróker de cTrader
  • price (opcional): un precio de entrada; 0 significa ejecutar a mercado
  • sl / tp (opcional): niveles de precio de Stop-Loss y Take-Profit; 0 para omitir
  • lots (opcional): anula tu dimensionamiento de riesgo configurado solo para ese trade

¿Cómo recibo las confirmaciones de ejecución en mi propio sistema?

Mediante webhooks salientes. Registra tu endpoint en Ajustes → Webhooks y PipSync le hace POST de un payload JSON firmado para eventos como signal.received, trade.opened, trade.closed, trade.tp_hit y trade.sl_hit. La entrega se intenta hasta 5 veces con retroceso exponencial, de modo que una breve caída de tu lado no pierde eventos.

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.

¿Qué límites de tasa y protecciones aplican a los webhooks entrantes?

La entrega de webhooks entrantes está limitada por tasa según el plan: 10 por minuto en Basic, 60 en Pro con una breve ventana de ráfaga, 200 en Business y límites personalizados en Enterprise. Para la mayoría de los sistemas de alertas eso es margen de sobra; si tu sistema puede emitir más rápido de lo que permite su plan, agrupa o aplica debounce de tu lado en vez de reintentar a ciegas.

La seguridad está en capas. La URL del webhook contiene un token secreto, así que poseer la URL es la credencial: trátala como una contraseña y regenérala si queda expuesta. Detrás de eso, tus reglas de riesgo del lado del servidor son el límite duro: límites de dimensionamiento, manejo de SL/TP, máximo de trades abiertos y filtros de símbolos corren antes de que cualquier orden llegue a tu bróker, de modo que ni siquiera un sistema upstream con errores puede exceder las barreras que estableciste. El modo de Aprobación Manual agrega un paso de confirmación humana por trade si lo deseas.

¿Por qué usar PipSync en lugar de construir contra la Open API yo mismo?

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, y mantiene tu capa de riesgo en un solo lugar: las mismas reglas del lado del servidor aplican tanto si una señal llega desde tu webhook, una alerta de TradingView o un canal de Telegram. También hace que el destino sea intercambiable: el mismo contrato de payload puede ejecutarse en MT4, MT5, Match-Trader, Binance Futures o Bybit, de modo que agregar una segunda plataforma más adelante es configuración, no código.

Pruébalo con el plan gratuito

Conecta una fuente de señales y una cuenta de bróker, observa cómo PipSync analiza y enruta en tiempo real, y mejora tu plan solo si necesitas más. Sin tarjeta de crédito para empezar.

Empieza gratis — sin tarjetaVer precios

Advertencia de riesgo: Los CFD son instrumentos complejos y conllevan un alto riesgo de perder dinero rápidamente debido al apalancamiento. El 70–80% de las cuentas de inversores minoristas pierden dinero al operar con CFD. Advertencia de riesgo · Rentabilidad pasada.

FAQ

Preguntas frecuentes

¿Necesito escribir un cBot para automatizar cTrader con webhooks?

No. PipSync se conecta a cTrader a través de la Open API oficial de Spotware: autorizas el acceso con tu cTrader ID y seleccionas la cuenta de trading. No hay cBot, ni proyecto de cTrader Automate, ni una terminal que deba permanecer abierta; tu sistema hace POST de JSON a una URL de PipSync y la orden se coloca desde la nube.

Escrito por el equipo de PipSync · Revisado por Tobias Russmann, Director, PipSync · Publicado · Última actualización

PipSync es una plataforma de automatización de señales basada en la nube que enruta señales de trading desde Telegram, Discord, alertas de TradingView y webhooks personalizados a cuentas de bróker en MetaTrader 4, MetaTrader 5, cTrader, Match-Trader, Binance Futures y Bybit, con gestión de riesgo del lado del servidor y sin necesidad de VPS. PipSync es una herramienta de ejecución, no un proveedor de señales ni asesoramiento de inversión.

PipSync es una herramienta de ejecución de señales. No proporciona señales de trading, no garantiza ningún resultado y no constituye asesoramiento de inversión. Operar productos apalancados conlleva un riesgo sustancial de pérdida. Consulta la advertencia de riesgo y el descargo de rendimiento.