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

Aviso de risco: Negociar CFDs e outros produtos alavancados é complexo e apresenta alto risco de perder dinheiro rapidamente devido à alavancagem. Dados do setor indicam que 70–80% das contas de negociação de varejo perdem dinheiro com esses produtos. Aviso de risco · Desempenho passado.

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.

1. 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. 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. 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. 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. 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. 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.

Tempo de configuração típico: cerca de 12 minutos.

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.

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

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.

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.

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.