# Webhook para Match-Trader — o JSON chega como sinal para a sua aprovação

Source: https://pipsync.io/pt/webhook-to-match-trader
Last updated: 2026-06-08

Você pode fazer POST de um payload JSON simples 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 Match-Trader. O webhook exige um plano que inclua a integração por webhook (o plano Advanced).

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.

## Webhook para Match-Trader em resumo

| | |
|---|---|
| Origem de entrada | Qualquer sistema capaz de fazer POST HTTPS com JSON simples (agnóstico à origem, não apenas TradingView) |
| Destino | Match-Trader — webhooks e alertas viram sinais para a sua aprovação; sinais do Telegram e do Discord são executados |
| Payload | JSON simples: instrument, direction (buy/sell), entry, sl e tp1 (sl e tp maiores que 0); texto simples é sempre salvo como sinal para a sua aprovação |
| Credencial | Token secreto dentro da sua URL de webhook exclusiva por origem; rotacione no painel se vazar |
| Dimensionamento de risco | Risco por trade em %, lotes mínimo e máximo e máximo de trades abertos; cada sinal aguarda a sua confirmação |
| Trading automático | Não para webhooks do seu próprio sistema; nos alertas do TradingView, o risco de índices, ouro ou cripto não pode ser medido nas contas Match-Trader por enquanto, então esses alertas não são operados automaticamente ali |
| Retorno | Webhooks de saída assinados (HMAC-SHA256) + API REST de leitura (Enterprise); painel em todos os planos |
| 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?

Envie JSON de qualquer sistema para a PipSync: o webhook cria um sinal para a sua aprovação e um webhook do seu próprio sistema nunca é operado automaticamente.

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

## Que payload um webhook para Match-Trader usa?

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

## Como a URL do webhook é protegida?

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.

## Como o PipSync se conecta ao Match-Trader sem plugin?

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.

## Como o dimensionamento por percentual de risco ajuda em contas prop com limite de drawdown?

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.

## Posso receber retorno quando um webhook é recebido?

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.

## FAQ

### Preciso do TradingView para enviar um webhook para Match-Trader?

Não. Esta rota é agnóstica à origem: qualquer sistema capaz de fazer um POST HTTPS com JSON simples pode enviar sinais para a PipSync, e um webhook do seu próprio sistema sempre vem para a sua aprovação. O TradingView é uma opção, mas bots personalizados, backtesters, serviços de backend e scripts funcionam do mesmo jeito pelo mesmo endpoint.

### O PipSync é um provedor de sinais ou dá conselhos de trading?

Não. O PipSync é uma infraestrutura de execução na nuvem que transforma em sinais, para sua corretora, o que você ou seu sistema envia. Ele não fornece sinais, não vende estratégias e não oferece conselhos de investimento, e nunca decide o que negociar por você.

### Posso rodar webhook-para-Match-Trader em uma conta de prop firm?

Um webhook do seu próprio sistema nunca é operado automaticamente: ele sempre vira um sinal para a sua aprovação. Sinais do Telegram e do Discord são executados no Match-Trader; nesse caso, verifique antes se sua prop firm permite execução automatizada ou por cópia. As regras variam por firma e muitas vezes diferem entre as fases de avaliação e financiada, então confira os termos da sua firma antes de ativar a execução.

### O webhook consegue fechar uma posição?

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.

### Um webhook do meu próprio sistema pode operar automaticamente no Match-Trader?

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

### Preciso de um VPS ou plugin para manter isso rodando?

Não. O PipSync se conecta ao Match-Trader via REST e WebSocket direto inteiramente na nuvem, sem plugin, EA, cBot ou terminal aberto. Depois que um webhook é recebido, o sinal fica disponível mesmo com o seu computador desligado.

### Como controlo o tamanho do lote pelo webhook?

Você não define o tamanho no payload: ele vem do dimensionamento do PipSync, aplicado quando você confirma o sinal.

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

## Related

- [TradingView para Match-Trader — sinais para revisar ou trading automático opcional](https://pipsync.io/pt/tradingview-to-match-trader)
- [Telegram para Match-Trader — copie sinais automaticamente](https://pipsync.io/pt/telegram-to-match-trader)
- [Webhook para MT5 — envie sinais JSON de qualquer sistema](https://pipsync.io/pt/webhook-to-mt5)
- [Webhook para cTrader — o JSON chega como sinal para a sua aprovação](https://pipsync.io/pt/webhook-to-ctrader)
- [O que é Match-Trader?](https://pipsync.io/pt/what-is-match-trader)
- [Copiador de sinais para prop firm — uma fonte, todas as contas](https://pipsync.io/pt/prop-firm-signal-copier)

---

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.