Webhook para Match-Trader — 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 é agnóstica à origem: qualquer sistema capaz de fazer um POST HTTPS pode enviar sinais para a PipSync. 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. Também nas contas Match-Trader o risco de índices, ouro ou cripto não pode ser medido por enquanto, então esses alertas não são operados automaticamente 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).

2. 2

   Contas de destino

   Sinais do Telegram e do Discord são executados no Match-Trader. 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, também nas contas Match-Trader o risco de índices, ouro ou cripto não pode ser medido por enquanto, então esses alertas não são operados automaticamente ali.

3. 3

   Crie uma origem de webhook personalizada

   Gere a URL do webhook em Configurações → Avançado → Alertas do TradingView. Ela contém um token secreto, é mostrada uma única vez e é a credencial usada pelo seu sistema de envio para se autenticar. Se suspeitar de um vazamento, gere uma nova.

4. 4

   Envie o payload JSON simples

   Configure seu sistema para fazer POST de JSON simples: instrument correspondente ao nome da corretora, direction (buy/sell), entry, sl e tp1, com sl e tp maiores que 0. O payload não define o tamanho.

5. 5

   Revise os sinais na página Sinais

   Os webhooks do seu sistema chegam como sinais na página Sinais. Cada sinal aguarda a sua confirmação na página Sinais, e um webhook do seu próprio sistema nunca é operado automaticamente.

6. 6

   Verifique em Alertas recentes

   Dispare um payload e confira em Alertas recentes (Configurações → Avançado → Alertas do TradingView) se o PipSync o interpretou corretamente.

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

Um webhook para Match-Trader usa um payload JSON simples que qualquer sistema consegue montar sem biblioteca. Os campos obrigatórios são instrument (o nome na sua corretora), direction ("buy" ou "sell"), entry, sl e tp1.

sl e tp1 são preços absolutos e precisam ser maiores que 0. O payload não define o tamanho do lote. Mensagens em texto simples são sempre salvas como sinal para a sua aprovação.

• instrument: precisa corresponder ao nome do instrumento na corretora
• direction: "buy" ou "sell"
• entry: preço de entrada absoluto
• sl: preço absoluto de stop-loss, maior que 0
• tp1: preço absoluto de take-profit, maior que 0
• texto simples: sempre salvo como sinal para a sua aprovação; envie JSON

Cada origem personalizada recebe uma URL de webhook exclusiva que contém um token secreto, e esse token é a única credencial. Qualquer sistema que tenha a URL pode enviar sinais e, com o trading automático do TradingView ativado, acionar operações por meio de um alerta do TradingView; por isso, trate-a como uma senha: mantenha-a fora de repositórios públicos, código do lado do cliente e logs compartilhados.

Se você suspeitar de um vazamento, rotacione a URL no painel. A rotação emite um novo token e invalida o antigo imediatamente, então um endpoint vazado para de funcionar assim que você o substitui. O login da sua corretora Match-Trader nunca é enviado no payload e nunca sai do PipSync.

O PipSync se conecta ao Match-Trader / Match-Trade pela interface REST e WebSocket direta da Match-Trade, então não há plugin, EA, cBot ou ponte baixada para manter. O Match-Trader é um backend white-label comum entre prop firms, e essa integração direta significa que a conexão roda inteiramente na nuvem do PipSync.

Como a conexão é no lado do servidor, seu sistema de envio nunca precisa ficar online depois do POST. O webhook pode disparar de um cron job de backend, de um script de desktop ou de uma função serverless; assim que o PipSync o recebe, o sinal fica na página Sinais, independente da sua máquina.

O dimensionamento por percentual de risco calcula o tamanho do lote a partir do saldo da conta e da distância do stop-loss, então cada trade arrisca um percentual definido em vez de um lote fixo. Em contas prop com limites de drawdown diário e máximo, isso mantém a exposição por trade proporcional conforme o saldo se move, o que importa quando uma única ordem grande demais pode estourar um limite.

O payload do webhook não carrega o tamanho do lote. Você também pode limitar o máximo de trades abertos. O payload do webhook não carrega o tamanho, então a regra de percentual de risco é sempre a que vale.

Os webhooks de saída assinados existem para trades que o PipSync coloca (sinais do Telegram e do Discord), não para webhooks do seu próprio sistema, que só criam sinais para a sua aprovação. Eles cobrem eventos como trade.opened, trade.closed, tp_hit e sl_hit, cada um carregando uma assinatura HMAC-SHA256 no cabeçalho X-PipSync-Signature e com até cinco tentativas com backoff. Isso permite que seu próprio sistema reconcilie o estado sem polling.

Para acesso por consulta, há uma API REST de leitura (GET /v1/signals, GET /v1/trades, documentada via OpenAPI 3.1 em /api/v1/openapi.json) disponível no plano Enterprise, enquanto o painel mostra todos os sinais e ordens processados em todos os planos. Os pedidos são limitados; se receber HTTP 429, aguarde e tente de novo com backoff e jitter.