# Webhook para cTrader — o JSON chega como sinal para a sua aprovação

Source: https://pipsync.io/pt/webhook-to-ctrader
Last updated: 2026-07-13

Você pode fazer POST do seu alerta JSON para a sua URL de webhook da PipSync: ela o transforma em um sinal na página Sinais, onde você o revisa. Um webhook do seu próprio sistema nunca é operado automaticamente: ele sempre é salvo como sinal para a sua aprovação. Sinais do Telegram e do Discord são executados no cTrader pela Open API. O webhook exige um plano que inclua a integração por webhook (o plano Advanced).

Esta rota foi feita para desenvolvedores que já têm um sistema que produz decisões de trade — um scanner, um bot em Python, um serviço interno de alertas. Qualquer coisa capaz de fazer um HTTP POST vira a fonte do sinal. Só os alertas que o próprio TradingView envia, a partir dos endereços de envio publicados por ele, podem operar automaticamente, e só depois que você ativar o recurso no plano Advanced. As contas do cTrader são conectadas pelo gateway, então por enquanto índices, ouro e cripto não são operados automaticamente nelas: o risco não pode ser medido ali.

## Webhook personalizado → cTrader em resumo

| | |
|---|---|
| Fonte do sinal | Qualquer sistema capaz de enviar um HTTP POST com corpo JSON — scripts, scanners, bots de trading, serviços internos |
| Plataforma de destino | cTrader — webhooks e alertas viram sinais para a sua aprovação; sinais do Telegram e do Discord são executados pela Open API |
| Contrato do payload | instrument, direction (buy/sell), entry, sl e tp1 obrigatórios, com sl e tp maiores que 0; texto simples é sempre salvo como sinal para a sua aprovação |
| Trading automático | Não para webhooks do seu próprio sistema; nos alertas do TradingView, índices, ouro e cripto não são operados automaticamente nas contas do cTrader por enquanto, porque o risco não pode ser medido ali |
| Software instalado | Nenhum — sem cBot, sem projeto cTrader Automate, sem VPS; a recepção do webhook roda na nuvem |
| Retorno de execução | Webhooks de saída assinados (X-PipSync-Signature, HMAC-SHA256) para eventos de trade; API REST de leitura no plano Enterprise |
| Preço | O webhook exige um plano que inclua a integração por webhook (o plano Advanced); confira os planos atuais no checkout |

## Como envio um webhook à PipSync?

O lado da PipSync é configuração no dashboard; o seu lado é um único HTTP POST na linguagem em que seu sistema for escrito.

1. **Crie sua conta PipSync e escolha um plano** — Cadastre-se em app.pipsync.io e assine um plano que cubra esta rota (é necessário um meio de pagamento). O webhook exige um plano que inclua a integração por webhook (o plano Advanced).
2. **Contas de destino** — Sinais do Telegram e do Discord são executados no cTrader pela Open API. Um webhook do seu próprio sistema nunca é operado automaticamente: este fluxo termina em webhook → sinal para a sua aprovação na página Sinais. Quanto aos alertas do TradingView, as contas do cTrader são conectadas pelo gateway, então por enquanto índices, ouro e cripto não são operados automaticamente nelas: o risco não pode ser medido ali.
3. **Crie uma fonte de webhook e copie sua URL** — Gere a URL do webhook em Configurações → Avançado → Alertas do TradingView. Ela contém um token secreto e é mostrada uma única vez — essa URL é a credencial que seu sistema vai usar, então guarde-a como qualquer outro segredo e gere uma nova em Configurações → Avançado → Alertas do TradingView se suspeitar de um vazamento.
4. **Envie seu primeiro POST JSON** — Do seu próprio código ou via curl, faça um POST com corpo JSON para a URL. O mínimo são cinco campos: instrument, direction ("buy" ou "sell"), entry, sl e tp1, com sl e tp maiores que 0.
5. **Eventos de saída** — Os webhooks de saída assinados (trade.opened, trade.closed) existem apenas para trades que a PipSync coloca, ou seja, sinais do Telegram e do Discord; um webhook do seu próprio sistema só cria um sinal para a sua aprovação.
6. **Confira os alertas recebidos** — Dispare um payload de exemplo via curl e confira os Alertas recentes em Configurações → Avançado → Alertas do TradingView; cada sinal aguarda a sua confirmação na página Sinais.

## O cTrader pode receber webhooks diretamente?

Não. O cTrader não tem nenhum endpoint HTTP de entrada que um sistema de terceiros possa chamar. O caminho oficial de integração é a Open API da Spotware, que espera que você construa e hospede uma aplicação autorizada: fluxos OAuth, conexões persistentes, metadados de símbolos, tratamento do ciclo de vida das ordens. A alternativa — um cBot escrito em C# dentro do cTrader Automate — só roda enquanto um terminal está aberto.

A PipSync recebe o seu webhook como um endpoint hospedado e o transforma em um sinal para a sua aprovação; um webhook do seu próprio sistema nunca é operado automaticamente. Você não escreve nenhum cBot, não registra nenhuma aplicação Open API e não roda infraestrutura própria.

## Que JSON eu envio?

Um objeto JSON pequeno e plano com cinco campos obrigatórios: instrument, direction, entry, sl e tp1. Como é o seu próprio sistema que produz o payload, a interpretação é determinística: não há leitura de texto livre envolvida, ao contrário das rotas do Telegram, onde um parser de IA lê mensagens escritas por pessoas. Mensagens em texto simples são sempre salvas como sinal para a sua aprovação.

O detalhe que mais costuma confundir desenvolvedores é o nome do instrumento. O instrument do payload precisa corresponder ao nome na sua corretora cTrader — corretoras podem usar nomenclatura ou sufixos próprios para o mesmo mercado, e o suporte da PipSync pode ajudar pelo chat. Um POST de teste em uma conta demo mostra no dashboard o payload interpretado — a forma mais rápida de verificar.

- instrument (obrigatório): o nome do instrumento como sua corretora cTrader o lista
- direction (obrigatório): "buy" ou "sell"
- entry (obrigatório): preço de entrada do sinal
- sl (obrigatório): nível de preço de stop-loss, maior que 0
- tp1 (obrigatório): nível de preço de take-profit, maior que 0

## Como recebo confirmações de execução de volta no meu próprio sistema?

Por meio de webhooks de saída. Registre seu endpoint nas configurações da PipSync e ela faz POST de um payload JSON assinado para eventos como signal.received, trade.opened, trade.closed, trade.tp_hit e trade.sl_hit. A entrega é tentada até 5 vezes com backoff exponencial, então uma breve indisponibilidade do seu lado não perde eventos.

Cada entrega traz um cabeçalho X-PipSync-Signature no formato t=<unix-ts>,v1=<hex-hmac-sha256>. Verifique o HMAC com seu segredo de webhook usando uma comparação de tempo constante e rejeite payloads cujo timestamp tenha mais de 5 minutos, para evitar ataques de repetição.

Para acesso por pull também há uma API REST de leitura — GET /v1/signals e GET /v1/trades com paginação, respostas de erro no padrão RFC 7807 e uma spec OpenAPI 3.1 em /api/v1/openapi.json para gerar clientes tipados. As chaves de API para ela estão disponíveis no plano Enterprise; a fonte de webhook de entrada e os webhooks de eventos de saída não a exigem.

## Que proteções se aplicam aos webhooks de entrada?

Os pedidos são limitados; se receber HTTP 429, aguarde e tente de novo com backoff e jitter.

A URL do webhook contém um token secreto, então a posse da URL é a credencial — trate-a como uma senha e gere uma nova se suspeitar de um vazamento: com o trading automático do TradingView ativado, qualquer pessoa que a tenha pode acionar operações por meio de um alerta do TradingView. Um webhook de qualquer outro sistema sempre espera pela sua confirmação na página Sinais.

## Por que usar a PipSync em vez de integrar eu mesmo com a Open API?

Você pode perfeitamente integrar diretamente com a Open API da Spotware — ela é bem documentada. O que você assume é o lado operacional: registrar e manter uma aplicação autorizada, tratar tokens OAuth, gerenciar conexões e reconexões, metadados de símbolos da corretora, estados do ciclo de vida das ordens e tratamento de erros, além de hospedar tudo isso em algum lugar que nunca dorme. Isso é trabalho de engenharia real para o que muitas vezes é um simples pipeline de POST para ordem.

Rotear pela PipSync reduz isso a uma única requisição HTTP, e mantém sua camada de risco em um só lugar: o dimensionamento e os filtros se aplicam a sinais do Telegram e do Discord; um webhook do seu próprio sistema só cria um sinal para a sua aprovação.

## FAQ

### Preciso escrever um cBot para automatizar o cTrader com webhooks?

Não. Seu sistema faz POST de JSON para uma URL da PipSync e o sinal é criado na nuvem; sem cBot nem terminal. Um webhook do seu próprio sistema vira um sinal para a sua aprovação; sinais do Telegram e do Discord são executados no cTrader pela Open API.

### Posso enviar webhooks à PipSync a partir de Python, Node.js ou qualquer outra linguagem?

Sim. A fonte é só um HTTP POST com corpo JSON, então qualquer coisa com um cliente HTTP funciona — scripts Python, serviços Node, binários Go, até curl a partir de um cron job. O payload mínimo são instrument, direction ("buy" ou "sell"), entry, sl e tp1. Um webhook do seu próprio sistema sempre vira um sinal para a sua aprovação.

### Como protejo minha URL de webhook da PipSync?

A URL contém um token secreto e é a credencial da sua rota — qualquer pessoa que a tenha pode enviar sinais. Guarde-a em um gerenciador de segredos em vez de no código e gere uma nova em Configurações → Avançado → Alertas do TradingView se suspeitar de um vazamento. Com o trading automático do TradingView ativado, qualquer pessoa que tenha a URL pode acionar operações por meio de um alerta do TradingView; um webhook de qualquer outro sistema sempre espera pela sua confirmação.

### Meu sistema pode fechar posições do cTrader via webhook?

Não. O webhook cria sinais de entrada e a PipSync não fecha posições a partir de webhooks nem de alertas do TradingView; o fechamento continua sendo uma decisão sua ou do SL/TP da posição.

### O que acontece se eu enviar muitos pedidos de uma vez?

Os pedidos são limitados; se receber HTTP 429, aguarde e tente de novo com backoff e jitter.

### Como meu sistema sabe se um trade realmente foi executado?

Para trades que a PipSync coloca (sinais do Telegram e do Discord), inscreva-se nos webhooks de saída: eventos como trade.opened, trade.closed, trade.tp_hit e trade.sl_hit são enviados por POST ao seu endpoint, assinados com um cabeçalho HMAC X-PipSync-Signature e tentados até 5 vezes com backoff exponencial. Cada sinal interpretado e a ordem resultante também ficam visíveis no dashboard, e planos Enterprise podem consultar a API REST (GET /v1/trades).

### Um webhook do meu próprio sistema pode operar automaticamente no cTrader?

Não. Um webhook do seu próprio sistema nunca é operado automaticamente: ele sempre é salvo como sinal para a sua aprovação. Só os alertas que o próprio TradingView envia, a partir dos endereços de envio publicados por ele, podem operar automaticamente, e só depois que você ativar o recurso no plano Advanced. As contas do cTrader são conectadas pelo gateway, então por enquanto índices, ouro e cripto não são operados automaticamente nelas: o risco não pode ser medido ali.

### A PipSync gera os sinais de trading?

Não. O seu próprio sistema decide quando operar; a PipSync apenas recebe o webhook e o transforma em um sinal na página Sinais, para a sua aprovação. A PipSync é uma ferramenta de execução — não um provedor de sinais e não constitui consultoria de investimento. Operar produtos alavancados envolve risco substancial de perda.

## Related

- [Copiador de sinais cTrader — execução automática pela Open API](https://pipsync.io/pt/ctrader-signal-copier)
- [Webhook para MT4 — em breve; hoje os sinais JSON chegam para revisão](https://pipsync.io/pt/webhook-to-mt4)
- [Webhook para MT5 — envie sinais JSON de qualquer sistema](https://pipsync.io/pt/webhook-to-mt5)
- [TradingView para cTrader — sinais para revisar ou trading automático opcional](https://pipsync.io/pt/tradingview-to-ctrader)
- [Telegram para cTrader — execute sinais automaticamente](https://pipsync.io/pt/telegram-to-ctrader)
- [Por que o MetaTrader não tem webhook de entrada (e como levar alertas do TradingView até ele mesmo assim)](https://pipsync.io/pt/metatrader-webhook)
- [Gestão de risco no servidor — regras de trading aplicadas antes do seu broker](https://pipsync.io/pt/server-side-risk-management)
- [Copiador de sinais sem VPS — a execução roda na nuvem](https://pipsync.io/pt/signal-copier-no-vps)

---

O PipSync é uma ferramenta de execução de sinais. Não fornece sinais de trading, não garante nenhum resultado e não constitui aconselhamento de investimento. Operar produtos alavancados envolve risco substancial de perda.