# Webhook para MT4 — em breve; hoje os sinais JSON chegam para revisão

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

O suporte da PipSync ao MetaTrader 4 chega em breve. Hoje você pode fazer um POST com um payload JSON simples para a sua URL de webhook exclusiva do PipSync: ele valida o payload e o transforma em um sinal na página Sinais, que você revisa. Levar esse sinal a uma conta MetaTrader 4 ainda não está disponível. O webhook exige um plano que inclua a integração por webhook (o plano Advanced); não há EA em MQL4 nem VPS.

O payload é propositalmente simples: instrument, direction (buy ou sell), entry, sl e tp1, com sl e tp maiores que 0. A própria URL do webhook carrega um token secreto e funciona como credencial, então qualquer sistema capaz de fazer um POST via HTTPS — um screener, um runner de backtest, um bot personalizado — pode enviar sinais sem manter um terminal aberto. Um webhook do seu próprio sistema nunca é operado automaticamente: cada payload vira um sinal e você decide. Isso substitui a antiga combinação de EA em MQL4 num VPS por uma API hospedada.

> Note: this destination is not connectable in PipSync yet (coming soon).

## Webhook para MT4 em resumo

| | |
|---|---|
| Origem | Qualquer sistema capaz de fazer POST de JSON simples via HTTPS (screeners, bots, backtests, TradingView) |
| Destino | MetaTrader 4 — em breve (apenas hedging, brokers MQL4) |
| Payload | JSON: 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 | URL de webhook exclusiva por origem com token secreto; gire pelo painel se suspeitar de um vazamento |
| Trading automático | Não para webhooks do seu próprio sistema: eles sempre viram sinal para a sua aprovação; o suporte ao MT4 chega em breve |
| Infraestrutura | Totalmente na nuvem — sem EA, sem VPS, sem terminal aberto |
| Retorno | Webhooks de saída assinados (HMAC-SHA256) + API REST de leitura + visão de cada ordem no painel |
| Preço | O webhook exige um plano que inclua a integração por webhook (o plano Advanced); confira os planos atuais no checkout |

## Como conecto um webhook personalizado ao MT4?

O suporte ao MT4 ainda não está ativo; esta página descreve como o webhook vai funcionar. Você nunca escreverá MQL4 nem alugará um VPS.

1. **Crie sua conta no 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; cancele quando quiser.
2. **Adicione a sua conta MT4** — O MetaTrader 4 chega em breve e ainda aparece desativado em Contas de trading → Adicionar conta. Quando estiver ativo, lembre-se de que o MT4 é apenas hedging, então cada sinal abrirá a sua própria posição.
3. **Crie uma origem de webhook personalizada** — Gere uma URL de webhook exclusiva para essa origem. A URL contém um token secreto e é a credencial — mantenha-a privada e gire-a pelo painel se suspeitar de um vazamento.
4. **Configure as regras de risco no servidor** — 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.
5. **Envie um payload de teste** — Faça POST de um corpo JSON simples de exemplo (instrument, direction, entry, sl, tp1) e confira em Alertas recentes (Configurações → Avançado → Alertas do TradingView) como o PipSync o interpretou.
6. **Teste em demo e depois vá ao vivo** — Quando o MT4 estiver ativo, aponte primeiro para uma conta demo e só então troque para a sua conta ao vivo quando o comportamento corresponder às suas expectativas.

## Que payload JSON um webhook para MT4 espera?

Um webhook para MT4 espera um único objeto JSON simples, não uma estrutura aninhada ou com templates. Os campos obrigatórios são instrument, direction (buy ou sell), entry, sl e tp1. O instrument precisa corresponder ao nome do instrumento no seu broker.

entry é o preço absoluto de entrada; 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 no broker
- direction: "buy" ou "sell"
- entry: preço absoluto de entrada
- 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 mantém a minha conta MT4 segura?

A URL do webhook é a credencial: cada origem recebe o seu próprio endpoint HTTPS exclusivo contendo um token secreto, então é a posse da URL que autoriza um sinal. Trate-a como uma senha — nunca a publique e envie sempre por HTTPS.

Se você suspeitar de um vazamento, gire a URL pelo painel para invalidar a antiga imediatamente. Os pedidos são limitados; se receber HTTP 429, aguarde e tente de novo com backoff e jitter.

## Por que o PipSync substitui a montagem de EA em MQL4 num VPS para o MT4?

A automação no MT4 era historicamente construída em torno de um expert advisor em MQL4 rodando dentro de um terminal num VPS alugado, que precisava ficar online para receber e agir sobre os sinais. O PipSync remove toda essa estrutura: ele aceita o seu JSON via HTTPS na nuvem e o transforma em um sinal para revisão, então não há EA para compilar, nem terminal para manter aberto, nem VPS para manter. O suporte ao MT4 chega em breve.

Como a execução fica na nuvem, os sinais são processados mesmo quando o seu próprio computador está desligado. O ponto a ter em mente é que o MT4 é apenas hedging, sem o conceito de netting, então cada buy ou sell abre uma posição distinta em vez de compensar uma posição oposta — uma diferença importante em relação ao MT5.

## Que retorno eu recebo após uma operação por webhook no MT4?

Você recebe três camadas de retorno. O painel mostra cada sinal interpretado e a ordem resultante em todos os planos, então você pode auditar exatamente o que chegou e o que o PipSync fez com isso.

Para retorno programático, o PipSync envia webhooks de saída assinados para 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 novas tentativas com backoff. Uma API REST de leitura (GET /v1/signals e GET /v1/trades, documentada em OpenAPI 3.1) permite consultar o estado diretamente; a API de leitura faz parte do plano Enterprise.

## Em que o webhook para MT4 difere do webhook para MT5?

O payload JSON e o modelo de credencial da URL do webhook são idênticos, então o seu código de envio não muda entre os dois. A diferença está em como a plataforma de destino lida com posições: o MT4 é apenas hedging, sem netting, o que significa que cada sinal abre a sua própria posição e operações opostas coexistem.

O MT5 suporta contas tanto de netting quanto de hedging e pode aplicar preenchimentos parciais, então uma ordem oposta pode reduzir ou fechar uma posição líquida existente dependendo do tipo de conta. Se a sua estratégia pressupõe que sinais opostos se compensam, esse comportamento existe em contas de netting do MT5, mas não no MT4, onde cada sinal abre a sua própria posição e o fechamento é uma decisão sua ou do SL/TP.

## FAQ

### Qual é o JSON mínimo necessário para enviar um sinal para o MT4?

Cinco campos, por exemplo {"instrument":"EURUSD","direction":"buy","entry":1.0850,"sl":1.0800,"tp1":1.0950}. sl e tp precisam ser maiores que 0, e o payload não define o tamanho do lote.

### Preciso de um EA ou de um VPS para enviar um webhook para MT4?

Não. O PipSync é totalmente na nuvem e recebe os seus sinais JSON através de uma ponte hospedada. Não há expert advisor em MQL4 para compilar, nem terminal para manter aberto, nem VPS para alugar. O suporte ao MT4 chega em breve.

### Como fecho uma posição aberta no MT4 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.

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

Não. Um webhook do seu próprio sistema nunca é operado automaticamente: ele sempre é salvo como sinal para a sua aprovação na página Sinais. Só os alertas que o próprio TradingView envia podem operar automaticamente, e só depois que você ativar o recurso; como o suporte ao MT4 chega em breve, nenhum alerta é operado no MT4 hoje.

### Por que o símbolo precisa corresponder exatamente ao nome do meu broker?

Brokers de MT4 usam nomes de símbolo variados — alguns adicionam sufixos como um ponto ou uma letra aos instrumentos. O instrumento que você envia precisa corresponder ao nome do broker; se a sua corretora usa um sufixo, o suporte do PipSync pode ajudar pelo chat de suporte.

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

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

Não. O PipSync é infraestrutura de execução de sinais: ele recebe o seu webhook e o transforma em um sinal para revisão. Ele não gera sinais, não vende estratégias nem fornece conselhos de investimento, e operar produtos alavancados envolve um risco substancial de perda.

### Posso definir o lote de uma operação dentro do webhook?

Não. O payload não carrega o tamanho do lote.

## Related

- [Webhook para MT5 — envie sinais JSON de qualquer sistema](https://pipsync.io/pt/webhook-to-mt5)
- [TradingView para MT4 — em breve; hoje os alertas viram sinais para revisão](https://pipsync.io/pt/tradingview-to-mt4)
- [Telegram para MT4 — em breve, sem EA nem VPS](https://pipsync.io/pt/telegram-to-mt4)
- [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.