# Webhook para MT5 — envie sinais JSON de qualquer sistema Source: https://pipsync.io/pt/webhook-to-mt5 Last updated: 2026-06-08 Para enviar sinais ao MT5 a partir de um webhook, mande um pequeno payload JSON — instrumento, direção, entrada, SL e TP — para a sua URL de webhook exclusiva da PipSync: a PipSync valida o payload e o transforma em um sinal na página Sinais, onde você atribui a sua conta MT5 ao sinal e o confirma. 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. O endpoint é independente da origem: qualquer coisa capaz de fazer um POST por HTTPS pode enviar sinais — um screener em Python, um bot em Node, um cron job, uma automação no-code. Não há EA para instalar, nenhum MQL5 para escrever e nenhum VPS para manter no ar. Webhooks de saída assinados reportam eventos de volta ao seu próprio sistema. ## Webhook personalizado → MT5 em resumo | | | |---|---| | Origem do sinal | Qualquer sistema capaz de enviar um POST por HTTPS com corpo JSON — bots, screeners, agendadores, scripts em qualquer linguagem | | Plataforma de destino | MetaTrader 5 pela ponte de API em nuvem da PipSync — já disponível; contas com hedging e netting suportadas | | Formato do payload | JSON plano: 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 | | Autenticação | URL de webhook exclusiva por origem contendo um token secreto; regenere-a pelo painel se suspeitar de um vazamento | | Controles de risco | Cada sinal aguarda a sua confirmação na página Sinais; dimensionamento, lotes mínimo e máximo e máximo de posições abertas valem quando você coloca o sinal na sua conta MT5 | | Trading automático | Não vale para webhooks do seu próprio sistema: só os alertas enviados pelo próprio TradingView, a partir dos endereços publicados por ele, podem operar automaticamente, e só se você ativar o recurso no plano Advanced | | Feedback | Webhooks de saída assinados (trade.opened, trade.closed, atingimento de TP/SL) mais uma API REST de leitura com especificação OpenAPI 3.1 | | 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 MT5? A rota é configurada uma vez no painel da PipSync; depois disso, o seu próprio código só conversa com um único endpoint HTTPS. 1. **Crie sua conta na 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). O webhook exige um plano que inclua a integração por webhook (o plano Advanced). 2. **Conecte a sua conta MT5** — Adicione uma conta de corretora no painel e selecione MetaTrader 5. Comece com uma conta demo para iterar no seu emissor sem dinheiro real em jogo. 3. **Crie uma origem de webhook e copie a sua URL** — Gere a URL em Configurações → Avançado → Alertas do TradingView. A PipSync a mostra uma única vez e ela contém um token secreto — essa URL é a sua credencial. Guarde-a em uma variável de ambiente ou gerenciador de segredos, nunca em código versionado, e gere uma nova se suspeitar de um vazamento. 4. **Aponte o seu sistema para o endpoint** — A partir do seu bot, screener ou script, envie um POST por HTTPS com o payload JSON: instrument, direction, entry, sl e tp1 são obrigatórios, com sl e tp maiores que 0. Qualquer cliente HTTP funciona — não há SDK para instalar. 5. **Defina as suas regras de risco no servidor** — Os webhooks do seu sistema chegam como sinais na página Sinais. O payload não define o tamanho. Cada sinal aguarda a sua confirmação na página Sinais, e um webhook do seu próprio sistema nunca é operado automaticamente. 6. **Dispare um alerta de teste** — Dispare o alerta uma vez e confira os Alertas recentes em Configurações → Avançado → Alertas do TradingView. Mantenha a rota em demo até que vários payloads reais sejam interpretados exatamente como você espera. ## Qual payload JSON o webhook da PipSync espera? Uma mensagem mínima é um objeto JSON plano com cinco campos: { "instrument": "EURUSD", "direction": "buy", "entry": 1.0850, "sl": 1.0800, "tp1": 1.0950 }. O campo direction aceita "buy" ou "sell"; sl e tp precisam ser maiores que 0, e mensagens em texto simples são sempre salvas como sinal para a sua aprovação. O payload não carrega o tamanho do lote. Cada payload aparece como sinal na página Sinais; o webhook não fecha nem gerencia posições, então as saídas continuam sendo decisão sua ou do SL/TP do sinal. ## Como o endpoint do webhook é autenticado? Cada origem de webhook recebe uma URL HTTPS exclusiva contendo um token secreto — a própria URL é a credencial. Isso mantém o lado do emissor deliberadamente simples: sem fluxo OAuth, sem assinatura de requisição, sem biblioteca cliente. curl, um script Python de cinco linhas ou uma função serverless podem se autenticar do mesmo jeito. Trate a URL como uma senha. Mantenha-a fora de código no lado do cliente e de repositórios públicos, e regenere-a pelo painel se suspeitar de um vazamento — qualquer um que tenha a URL pode enviar sinais para o seu workspace e, se você ativou o trading automático do TradingView, acionar operações enviando a ela um alerta do TradingView. Uma requisição de qualquer outro sistema sempre espera pela sua revisão na página Sinais, mas rotacionar uma URL vazada deve ser a primeira reação. ## Por que enviar webhooks em vez de rodar um Expert Advisor no MT5? Uma ponte baseada em EA acopla a sua automação a um terminal MT5 em execução — geralmente um VPS Windows que você aluga, atualiza e monitora, além de código MQL5 que você mantém. Se o terminal fechar ou o VPS reiniciar, a sua estratégia fica offline. A PipSync move a conexão com a corretora para o servidor por uma ponte de API em nuvem com o MT5, então não há nada instalado no terminal e nada que morre junto com uma sessão de desktop. Isso também desacopla a sua escolha de linguagem do ecossistema da MetaQuotes. O seu screener pode continuar em Python, a sua lógica de execução em Rust ou Node — se consegue fazer um POST HTTP, consegue enviar sinais. O dimensionamento de posição e o máximo de trades abertos se aplicam de forma consistente independentemente do que enviou o sinal. ## Como recebo o feedback de execução de volta no meu próprio sistema? Inscreva o seu próprio endpoint nos webhooks de saída da PipSync e você recebe um POST JSON assinado em eventos como signal.received, trade.opened, trade.closed, trade.tp_hit e trade.sl_hit. Cada entrega traz um cabeçalho X-PipSync-Signature (um timestamp mais um digest HMAC-SHA256) para que você verifique a autenticidade antes de confiar no payload; rejeite qualquer coisa cujo timestamp tenha mais do que alguns minutos para bloquear replays. Entregas que falham são tentadas novamente até 5 vezes com backoff exponencial. Para polling e reconciliação também existe uma API REST de leitura — GET /v1/signals e GET /v1/trades — descrita por uma especificação OpenAPI 3.1 em /api/v1/openapi.json, para que você gere um cliente tipado para o seu runtime. As chaves de API da API de leitura fazem parte do plano Enterprise; o próprio painel mostra cada sinal interpretado e a ordem resultante em todos os planos. ## Quais particularidades do MT5 a minha integração deve tratar? A nomenclatura de símbolos é o bug de integração mais comum. O campo instrument precisa corresponder ao nome do instrumento da sua corretora, e as corretoras costumam usar as próprias variantes de nomes padrão — confira em Alertas recentes, e peça ajuda ao suporte da PipSync pelo chat se a sua corretora usa um sufixo. A integração da PipSync com o MT5 funciona tanto no modo de conta hedging quanto netting, lida com execuções parciais e coloca stop-loss e take-profit junto com a ordem para que a proteção seja mantida na corretora, e não no seu script. Os pedidos são limitados; se receber HTTP 429, aguarde e tente de novo com backoff e jitter. ## FAQ ### Como envio um sinal de trade do meu próprio código para o MT5? Faça um POST de um objeto JSON como { "instrument": "EURUSD", "direction": "buy", "entry": 1.0850, "sl": 1.0800, "tp1": 1.0950 } para a sua URL de webhook exclusiva da PipSync. A PipSync valida o payload e o transforma em um sinal na página Sinais, onde você o confirma antes de ele seguir para a sua conta MT5 conectada. Qualquer linguagem ou ferramenta capaz de fazer um POST por HTTPS funciona — não há exigência de SDK. ### Como o webhook da PipSync é protegido? A URL do webhook contém um token secreto e é exclusiva da sua origem — a URL é a credencial, transportada por HTTPS. Mantenha-a fora de código no lado do cliente e de repositórios públicos, e regenere-a pelo painel 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; webhooks de qualquer outro sistema sempre esperam pela sua revisão na página Sinais. ### Um webhook do meu próprio sistema pode operar automaticamente? Não. Só os alertas que o próprio TradingView envia, a partir dos endereços de envio publicados por ele, podem ser operados automaticamente, e só depois que você ativar o trading automático no plano Advanced. Um webhook do seu próprio bot, script ou ferramenta sempre vira um sinal para a sua aprovaçã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. ### Posso fechar uma posição no MT5 pelo 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. ### Preciso de um VPS ou de um Expert Advisor para isso? Não. A conexão da PipSync com o MT5 roda na nuvem por uma ponte de API, então não há EA para instalar, nenhum MQL5 para escrever e nenhum terminal que precisa ficar aberto. A sua única infraestrutura é aquilo que já produz o sinal. ### Como o meu sistema sabe se o trade foi realmente executado? De três formas: webhooks de saída assinados enviam eventos como trade.opened, trade.closed, trade.tp_hit e trade.sl_hit para o seu endpoint (assinados com HMAC-SHA256, tentados novamente até 5 vezes); uma API REST de leitura (GET /v1/trades, plano Enterprise) suporta polling e reconciliação; e o painel mostra cada sinal interpretado e ordem. ### A PipSync é um bot de trading ou um provedor de sinais? Nenhum dos dois — nesta rota a estratégia é inteiramente sua. A PipSync só fornece o endpoint de webhook, a validação do payload e a conexão com o MT5; ela não gera sinais próprios, não faz afirmações sobre como qualquer estratégia vai se comportar, e nada aqui é recomendação de investimento. O que quer que o seu código decida enviar, produtos alavancados envolvem risco substancial de perda. ## Related - [Webhook para Match-Trader — o JSON chega como sinal para a sua aprovação](https://pipsync.io/pt/webhook-to-match-trader) - [Webhook para MT4 — em breve; hoje os sinais JSON chegam para revisão](https://pipsync.io/pt/webhook-to-mt4) - [TradingView webhook para MT5 — sinais para revisar ou trading automático opcional](https://pipsync.io/pt/tradingview-to-mt5) - [Webhook para cTrader — o JSON chega como sinal para a sua aprovação](https://pipsync.io/pt/webhook-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) - [Telegram para MT5 — copie sinais para o MetaTrader 5 automaticamente](https://pipsync.io/pt/telegram-to-mt5) - [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.