- Desde outubro de 2022, cada corretora tem o seu próprio WebTrader MT5, vinculado à sua plataforma e ao seu domínio; o antigo terminal compartilhado não atende mais servidores arbitrários.
- Há três formas de colocá-lo no seu site: um link “Negocie agora”, uma incorporação via iframe ou um terminal em tela cheia com a sua marca no seu próprio subdomínio.
- Os iframes são rápidos de configurar, mas ficam apertados no celular, podem ser bloqueados por cabeçalhos de enquadramento e podem perder logins salvos quando os navegadores restringem o armazenamento de terceiros.
- A maioria dos relatos de “não funciona” se resume a poucas causas: nenhum terminal web ativado para o servidor, o terminal demo genérico, cabeçalhos de enquadramento, conteúdo misto ou a configuração de DNS e certificado.
- Um terminal no seu próprio subdomínio, como trade.yourbrand.com, reúne a sua marca, os dados legais e as regras de acesso em um só lugar e funciona em tela cheia em qualquer dispositivo.
- A FXPTrader entrega esse terminal com a sua marca por meio de um Cloudflare Worker na sua própria conta Cloudflare; não é uma licença MT5, então você continua precisando do seu próprio acesso ao MT5.
Como colocar o WebTrader MT5 no seu site?
Você coloca o terminal web do MetaTrader 5 no seu site de uma de três formas: com um link para o terminal web da sua corretora a partir de um botão “Negocie agora”, incorporando-o em um iframe em uma das suas páginas ou servindo-o em tela cheia no seu próprio subdomínio, como trade.yourbrand.com. Em todos os casos, o terminal precisa primeiro estar ativado para o seu servidor de negociação, porque desde outubro de 2022 a MetaQuotes fornece um terminal web individual por corretora, e não uma página compartilhada para todos.
O link é o caminho mais rápido, o iframe mantém os visitantes na sua página, mas traz limitações técnicas, e o terminal no domínio próprio oferece a experiência de marca e mobile mais consistente. O restante deste guia mostra como configurar cada opção, os parâmetros exatos do iframe, um checklist de lançamento e como resolver os erros que as corretoras realmente encontram.
O que mudou no WebTrader MT5 em 2022?
Durante anos, a MetaQuotes ofereceu um terminal web compartilhado que qualquer corretora podia colocar no seu site. O seu artigo de 2017 no MQL5 sobre incorporação descreve um iframe com parâmetros como servers, trade_server, lang, startup_mode, save_password, demo_all_servers e utm_campaign, e afirma: “Não cobramos nenhuma taxa pelo uso do WebTerminal nos seus sites.” Muitos tutoriais antigos e respostas em fóruns ainda descrevem esse modelo.
Em 12 de outubro de 2022, a MetaQuotes anunciou um novo terminal web que “funciona como um terminal web individual, que só opera com a plataforma de uma corretora específica”. Ele roda no servidor de acesso da corretora, está vinculado ao domínio da própria corretora e, nas palavras da MetaQuotes, oferece “segurança máxima e controle total para a corretora”. Segundo o anúncio, as corretoras que já possuem uma licença de terminal web podem implantá-lo sem custo adicional, enquanto as demais o solicitam ao suporte da MetaQuotes.
Em setembro de 2023, a MetaQuotes publicou guias em vídeo para corretoras cobrindo a instalação “da escolha do domínio à integração do terminal web no seu site, tudo concluído em 30 minutos”, incluindo a personalização da página inicial, analytics e interface. A consequência prática para quem pesquisa “como colocar o WebTrader MT5 no meu site” em 2026:
- O ponto de partida é o terminal web da sua própria corretora, ativado para o seu servidor de negociação, e não a antiga página compartilhada.
- Copiar um trecho de iframe antigo que aponta para o terminal compartilhado geralmente resulta em erro ou em um terminal que só mostra servidores demo (veja a seção de solução de problemas).
- As decisões sobre domínio, marca e acesso agora ficam com a corretora, e por isso as configurações em domínio próprio se tornaram comuns.
O que os clientes podem fazer no terminal web do MetaTrader 5?
Antes de decidir com que destaque posicioná-lo, vale saber o que o terminal web oferece em comparação com os aplicativos desktop e mobile. Segundo a página oficial de negociação web do MetaTrader 5, o terminal é construído em HTML5 e não requer instalação. Ele roda no Chrome, Safari, Edge, Opera e Firefox no Windows, macOS e Linux, e é otimizado para navegadores móveis no iOS e Android.
| Área | Terminal web MT5 (segundo a MetaQuotes) | O que significa para o seu site |
|---|---|---|
| Instalação | Nenhuma, roda no navegador | Um único link ou página basta para o cliente começar a negociar |
| Ordens | Todos os tipos de ordem do MT5, negociação com um clique | Adequado como plataforma principal, não apenas como visualizador |
| Contabilização de posições | Netting e hedging | Funciona com qualquer um dos modelos de conta no seu servidor |
| Contas | Demo e real | Utilizável tanto em fluxos de cadastro demo quanto de onboarding real |
| Análise | 30 indicadores, 24 objetos analíticos, 9 timeframes, 3 tipos de gráfico, tema noturno | Suficiente para a maioria dos traders discricionários |
| Idiomas | 8 idiomas de interface listados na página do produto; o artigo do MQL5 sobre incorporação menciona 41 | Defina o idioma de acordo com a página de onde o cliente veio |
| Automação | Expert Advisors e indicadores personalizados não rodam nas versões web (fontes de corretoras) | Direcione os traders algorítmicos para o terminal desktop |
Para uma comparação mais completa das três plataformas do cliente, veja WebTrader MT5 vs desktop vs mobile.
Link, iframe ou domínio próprio: qual opção escolher?
| Link | Incorporação via iframe | Domínio próprio com marca | |
|---|---|---|---|
| Esforço de configuração | Minutos | De minutos a horas | Normalmente no mesmo dia |
| Endereço no navegador | O endereço do terminal web | A sua página, com o terminal enquadrado dentro | O seu subdomínio |
| Negociação em tela cheia | Sim | Limitada pelo frame | Sim |
| Experiência mobile | Boa | Muitas vezes apertada | Boa |
| Logins salvos | Comportamento normal do navegador | Podem falhar quando o armazenamento de terceiros é bloqueado | Comportamento normal do navegador |
| Dados da empresa e links legais | Limitados | Apenas ao redor do frame | Em todo o terminal |
| Controle de acesso por faixa de contas | Não | Não | Sim (com a FXPTrader) |
| Servidores para manter | Nenhum | Nenhum | Nenhum (entrega na borda) |
Use estas perguntas para decidir:
- O terminal web é uma plataforma principal ou uma opção secundária? Se muitos clientes negociam apenas no navegador, um terminal em tela cheia no seu próprio domínio compensa o passo adicional.
- Quanto do seu tráfego é mobile? Frames dentro de uma página deixam pouco espaço no celular; um link ou um terminal em domínio próprio usa a tela inteira.
- Você precisa que a sua entidade jurídica, licença e links de privacidade fiquem visíveis no terminal? Corretoras reguladas muitas vezes precisam; veja quais dados da empresa mostrar em um terminal web.
- Você opera várias marcas ou sites de parceiros? Terminais separados com marca para cada marca evitam misturar nomes e dados de contato.
- Você precisa restringir quem pode fazer login? Prop firms e programas de IB muitas vezes querem apenas determinadas faixas de contas em um endereço específico.
Um caminho sensato para muitas corretoras é começar com um link no primeiro dia, depois migrar para um terminal em domínio próprio e manter o link apontando para o novo endereço.
Como criar um link para o seu WebTrader MT5 a partir do seu site
O link é a opção mais simples e confiável, e é o primeiro passo certo mesmo que você planeje algo mais elaborado depois.
- Obtenha o endereço do terminal web da sua corretora. Se o MT5 é fornecido por um provedor de plataforma, peça a ele a URL do terminal web ativado para o seu servidor de negociação. Se você opera a sua própria plataforma MT5, implante o terminal web conforme descrito nos guias da MetaQuotes para corretoras.
- Teste com uma conta demo e uma conta real no desktop e no celular, e anote o nome exato do servidor de negociação que os clientes devem selecionar.
- Adicione um botão claro, como “Web Trader” ou “Negocie agora”, ao menu principal e à área do cliente. Abra-o em uma nova aba para que os clientes mantenham a área do cliente disponível para depósitos e documentos.
- Adicione rastreamento de campanha ao link, se a sua configuração de analytics permitir, para ver quais páginas geram logins.
- Repita o link nos e-mails de onboarding, ao lado do login e do nome do servidor, para que novos clientes não precisem procurá-lo.
A desvantagem é que o endereço e grande parte da apresentação podem não ser seus. Os clientes passam do seu site com marca para uma página que talvez não reconheçam, um ponto comum em que novos traders hesitam.
Como incorporar o WebTrader MT5 em um iframe
Um iframe coloca o terminal dentro de uma das suas próprias páginas. Uma incorporação mínima tem esta aparência, com o endereço substituído pelo terminal web da sua corretora e o nome do servidor pelo seu:
<iframe src="https://YOUR-WEB-TERMINAL-ADDRESS/?servers=YourBroker-Live&trade_server=YourBroker-Live&lang=en" width="100%" height="700" allow="fullscreen" title="Web trading terminal"></iframe>
Os nomes de parâmetros abaixo vêm do artigo de 2017 da MetaQuotes no MQL5 sobre o terminal compartilhado. Confirme com o seu provedor de plataforma quais deles o seu próprio terminal web ainda aceita.
| Parâmetro | Finalidade | Dica prática |
|---|---|---|
servers | Servidores de negociação oferecidos na janela de login | Liste apenas os seus próprios servidores para que os clientes não escolham o errado |
trade_server | Servidor selecionado por padrão | Use o servidor real nas páginas da área do cliente e o servidor demo nas páginas de cadastro |
lang | Idioma da interface | Use o mesmo idioma da página que hospeda o frame |
startup_mode | Com o que o terminal abre, por exemplo a abertura de uma conta demo | Útil em landing pages do tipo “experimente uma demo” |
save_password | Se o login pode ser lembrado | O comportamento dentro de frames depende das regras de armazenamento do navegador |
demo_all_servers | Abertura de contas demo em vários servidores | Normalmente deixe desativado para que as demos abram no seu servidor |
utm_campaign | Tag de campanha para rastreamento | Use a mesma nomenclatura das suas outras campanhas |
Pontos a acertar com um iframe:
- Altura. Uma altura fixa que parece boa no notebook costuma ser curta ou alta demais no celular. Use uma altura responsiva (por exemplo, baseada em unidades de viewport) e teste em dispositivos reais.
- Permissões de enquadramento. O servidor do terminal precisa permitir ser enquadrado pelo seu domínio. Se ele enviar
X-Frame-Options: DENYou uma regra Content-Security-Policyframe-ancestorsque exclua o seu site, o navegador mostra uma caixa vazia. - A política da sua própria página. Se o seu site usa uma Content-Security-Policy com
frame-srcouchild-src, adicione o endereço do terminal a ela. - HTTPS nos dois lados. Um frame
http://dentro de uma páginahttps://é bloqueado como conteúdo misto. - Armazenamento e cookies. Vários dos principais navegadores bloqueiam ou particionam por padrão o armazenamento de frames de terceiros, então o “lembrar de mim” pode não sobreviver entre visitas.
- Consentimento de cookies. Se o seu banner de consentimento bloqueia conteúdo de terceiros até ser aceito, o frame pode ficar vazio para visitantes que ainda não escolheram.
Um iframe é uma escolha razoável para uma landing page de demo ou um widget “experimente agora”. Para a negociação diária, a maioria das corretoras prefere um terminal em tela cheia.
Como colocar o WebTrader MT5 no seu próprio domínio
Com um terminal em domínio próprio, os clientes abrem trade.yourbrand.com e veem um terminal em tela cheia com o nome da sua empresa, dados de contato e links legais. É um endereço que eles reconhecem do seu site e dos seus e-mails, e podem salvá-lo nos favoritos como qualquer outra página.
A FXPTrader entrega isso por meio de um Cloudflare Worker implantado na sua própria conta Cloudflare. O Worker serve o terminal no seu subdomínio e o conecta ao seu servidor de negociação; não há servidores para alugar ou atualizar. A rede da Cloudflare, segundo a Cloudflare, abrange 348 cidades em mais de 100 países, e o seu runtime Workers suporta WebSockets, dos quais um terminal de negociação ao vivo depende. O servidor de negociação em si continua na sua plataforma MT5, então a execução acontece onde sempre aconteceu.
Etapas típicas:
- Confirme o seu acesso ao MT5. Você precisa da sua própria plataforma MT5 ou de acesso por meio de um provedor, com o terminal web disponível para o seu servidor. A FXPTrader não é uma licença MT5 nem um white label; veja white label vs grey label vs licença própria.
- Adicione o seu domínio à Cloudflare, se ele ainda não estiver lá, e escolha o subdomínio, como
trade,webtraderouterminal. - Implante o Worker na sua conta Cloudflare.
- Preencha as configurações como variáveis de ambiente da Cloudflare (veja a tabela abaixo).
- Vincule o domínio personalizado. Os Custom Domains da Cloudflare criam o registro DNS e o certificado automaticamente; observe que domínios personalizados curinga (wildcard) não são suportados, então adicione cada subdomínio explicitamente.
- Teste logins demo e reais, uma conta fora da faixa permitida, o Safari e o Chrome no celular e os links legais.
- Crie links no seu menu, na área do cliente e nos e-mails de onboarding, e atualize qualquer iframe ou link antigo para o novo endereço.
| Configuração | O que ela controla | Exemplo |
|---|---|---|
| Nome da empresa, endereço, e-mail, telefone, site | Marca e dados de contato exibidos no terminal | A sua entidade jurídica e os contatos de suporte |
| Nome do servidor de negociação | O servidor em que os clientes fazem login | YourBroker-Live |
| Upstream | O back end do terminal web ao qual o Worker se conecta | Endereço fornecido com o seu acesso ao MT5 |
| URL da licença e URL de privacidade | Links legais exibidos aos clientes | As suas páginas regulatórias e de privacidade |
| Texto para o usuário final | Avisos como alertas de risco | O seu aviso de risco padrão |
| Faixas de login permitidas | Quais números de conta podem fazer login neste endereço | Apenas contas reais de uma marca |
Como tudo é configuração, uma implantação típica entra no ar no mesmo dia, e várias marcas podem rodar lado a lado com um Worker e uma configuração por marca; veja WebTrader multimarca. Para o lado do DNS em detalhe, leia configuração de subdomínio e DNS do WebTrader e, para a visão geral do produto, WebTrader White Label.
WebTrader MT5 não funciona? Erros comuns e soluções
Estes são os problemas que corretoras e seus clientes relatam com mais frequência ao adicionar o terminal web a um site, com a causa e a solução habituais.
| Sintoma | Causa provável | Solução |
|---|---|---|
| “WebTerminal is not supported by this MetaTrader 5 Server” | Nenhum terminal web está ativado para esse servidor de negociação; cada corretora agora hospeda o seu próprio | Ative ou solicite o terminal web para o seu servidor por meio da MetaQuotes ou do seu provedor de plataforma e aponte a página para esse terminal |
| Só aparecem o MetaQuotes-Demo ou outros servidores demo | A página usa o terminal genérico, ou o parâmetro servers está ausente | Use o terminal web da sua corretora e liste os nomes dos seus próprios servidores |
| Caixa vazia ou “recusou a conexão” dentro do frame | X-Frame-Options ou frame-ancestors proíbe o enquadramento, ou a sua própria CSP bloqueia a origem | Verifique o console do navegador; permita que o seu domínio enquadre o terminal ou mude para um link ou terminal em domínio próprio |
| Frame bloqueado como conteúdo misto | Terminal carregado via http:// em uma página https:// | Use HTTPS no endereço do terminal |
| Clientes desconectados a cada visita | O navegador bloqueia ou particiona o armazenamento de terceiros dentro do frame | Sirva o terminal em tela cheia no seu próprio domínio |
| O terminal carrega, mas não mostra preços ou fica reconectando | Um proxy, firewall ou upstream mal configurado interrompe a conexão ao vivo, ou o nome do servidor está errado | Verifique na aba de rede se há conexões WebSocket com falha e confira o nome do servidor e o upstream |
Aviso de certificado em trade.yourbrand.com | DNS ou certificado ainda em emissão, ou existe um registro DNS conflitante | Remova registros antigos do subdomínio e deixe a Cloudflare emitir o certificado para o domínio personalizado |
| Conta válida não consegue fazer login no endereço com marca | O número da conta está fora das faixas de login permitidas | Amplie a faixa ou envie o cliente para o endereço da marca correta |
| Idioma da interface errado | Nenhum lang definido, ou foi usado o padrão do navegador | Defina o idioma por página ou por marca |
Ao abrir um chamado com o seu provedor de plataforma, inclua o endereço completo usado, o nome do servidor de negociação, o navegador e o dispositivo e uma captura de tela do console do navegador. Isso reduz bastante as idas e vindas.
Onde o terminal web deve aparecer no seu site?
Um terminal só ajuda se os clientes conseguem encontrá-lo no momento em que querem negociar. Bons lugares para o link ou botão:
- Menu principal: um item “Web Trader” ou “Negocie agora”, visível no desktop e no menu mobile.
- Área do cliente: ao lado dos dados da conta, dos depósitos e dos downloads da plataforma, com o nome do servidor exibido ao lado.
- E-mails de aprovação de conta e de boas-vindas: login, nome do servidor e link do terminal em um único bloco.
- Página da plataforma: junto aos downloads desktop e mobile, explicando que a versão web não precisa de instalação.
- Landing pages de demo: um caminho direto para uma conta demo, onde um iframe ainda pode fazer sentido.
- Painéis de prop firms e páginas de parceiros IB: ao lado das credenciais do desafio ou dos links de cadastro de parceiros, de preferência em um endereço restrito às faixas de contas relevantes; veja como restringir as faixas de login do WebTrader MT5.
Mantenha um único endereço canônico. Se o link mudar, atualize todos os lugares acima de uma vez e redirecione o endereço antigo sempre que possível, para que favoritos e e-mails continuem funcionando.
Checklist pré-lançamento e armadilhas comuns
Percorra esta lista antes de anunciar o terminal aos clientes:
- O terminal web está ativado para os seus servidores real e demo, e os dois nomes de servidor estão escritos exatamente como os clientes os verão.
- Uma conta real e uma conta demo conseguem fazer login, abrir, modificar e fechar uma ordem.
- O terminal funciona no celular em modo retrato, tanto no Safari quanto no Chrome.
- Nome da empresa, endereço, dados de contato, link da licença, link de privacidade e texto de risco estão corretos para a marca.
- O endereço usa HTTPS sem avisos, e links ou iframes antigos apontam para o novo endereço.
- As faixas de contas que não devem usar este endereço são rejeitadas, e o suporte sabe o que os clientes veem nesse caso.
- Analytics e consentimento de cookies se comportam conforme exige a sua política.
- A equipe de suporte tem um roteiro curto para os erros da tabela de solução de problemas.
Armadilhas vistas repetidamente:
- Copiar um tutorial anterior a 2022 e apontar a incorporação para o terminal compartilhado, que não atende mais servidores arbitrários.
- Testar apenas no desktop e depois descobrir que o frame é inutilizável no celular.
- Misturar marcas: um terminal com os dados legais de uma empresa usado para várias marcas ou parceiros.
- Supor que o terminal web roda Expert Advisors; ele não roda, então oriente os traders algorítmicos a usar o terminal desktop.
- Tratar um terminal com marca como uma licença. Um front end com marca precisa de acesso ao MT5 por trás; ele não substitui o seu contrato de plataforma.
Fontes
- MQL5: como incorporar o MetaTrader WebTerminal ao seu site (2017, em inglês)
- MetaTrader 5: o novo terminal web individual para corretoras (outubro de 2022, em inglês)
- MetaTrader 5: guias em vídeo para corretoras sobre o terminal web (setembro de 2023, em inglês)
- Fórum MQL5: “WebTerminal is not supported by this MetaTrader 5 Server” (2024, em inglês)
- Recursos da plataforma de negociação web do MetaTrader 5 (em inglês)
- Cloudflare Workers: Custom Domains (em inglês)
- Cloudflare Workers: WebSockets (em inglês)
- Rede global da Cloudflare (em inglês)
Perguntas frequentes
Posso incorporar o WebTrader MT5 no meu site com um iframe?
Sim, desde que o terminal web esteja ativado para o seu servidor de negociação e o seu endereço permita ser enquadrado pelo seu domínio. O artigo de 2017 da MetaQuotes descreve parâmetros de iframe como servers, trade_server e lang. Espere limitações no celular e com logins salvos, porque os navegadores restringem o armazenamento dentro de frames de terceiros.
Incorporar o WebTrader MT5 é gratuito?
Para o antigo terminal compartilhado, a MetaQuotes afirmava não cobrar pelo uso do WebTerminal nos seus sites. Para o terminal individual por corretora lançado em 2022, a MetaQuotes disse que corretoras com licença de terminal web podem implantá-lo sem custo adicional, enquanto as demais o solicitam ao suporte. Um terminal com marca no seu próprio domínio é um serviço à parte.
Por que aparece “WebTerminal is not supported by this MetaTrader 5 Server”?
O servidor de negociação para o qual você está apontando não tem um terminal web ativado. Desde 2022, cada corretora hospeda o seu próprio terminal web, e o terminal compartilhado não se conecta mais a servidores arbitrários. A corretora ou o seu provedor de plataforma precisa ativar o terminal web para esse servidor.
Por que o meu terminal incorporado só mostra o MetaQuotes-Demo?
A página está carregando o terminal genérico em vez do terminal web da sua corretora, ou o parâmetro servers está ausente. Aponte a incorporação ou o link para o endereço do seu próprio terminal web e liste apenas os nomes dos seus próprios servidores.
Por que o meu iframe do MT5 está em branco?
Normalmente o servidor do terminal proíbe o enquadramento com X-Frame-Options ou uma regra Content-Security-Policy frame-ancestors, ou a política do seu próprio site bloqueia a origem. Conteúdo misto, um frame http em uma página https, tem o mesmo efeito. O console do navegador indica a causa exata.
Posso usar um subdomínio como trade.mybroker.com?
Sim, e essa é a configuração em domínio próprio mais comum. Com a FXPTrader, o subdomínio é vinculado como um Custom Domain da Cloudflare, que cria o registro DNS e o certificado automaticamente. Cada subdomínio é adicionado individualmente, já que domínios personalizados curinga não são suportados.
Um terminal web com marca me dá uma licença MT5?
Não. Um terminal com marca é o front end voltado ao cliente; o servidor de negociação, as contas e a execução continuam na sua plataforma MT5. Você continua precisando do seu próprio acesso ao MT5, seja uma licença própria, seja o acesso por meio de um provedor.
Os clientes podem rodar Expert Advisors no WebTrader MT5?
Não. Fontes de corretoras indicam de forma consistente que Expert Advisors e indicadores personalizados não rodam nas versões web do MT4 ou do MT5. Clientes que negociam com estratégias automatizadas devem usar o terminal desktop.
Qual opção é melhor para conversão?
Um terminal em tela cheia no seu próprio domínio com marca normalmente oferece o caminho mais fluido e confiável, especialmente no celular, porque o endereço, a marca e os dados legais coincidem com o seu site. Um link é um bom passo intermediário, enquanto os iframes servem melhor para landing pages de demo do que para a negociação diária.
Posso limitar quais contas podem fazer login no meu terminal web?
Não com um simples link ou iframe. A FXPTrader permite definir faixas de login permitidas por implantação, de modo que um endereço usado para uma marca, um programa de prop firm ou um parceiro aceite apenas os números de conta correspondentes.
Posso rastrear qual campanha levou um cliente ao terminal?
Os parâmetros de incorporação da MetaQuotes incluem utm_campaign. No seu próprio domínio, você também pode usar o seu analytics habitual, sujeito à sua configuração de consentimento de cookies e à sua política de privacidade.
Quanto tempo leva para colocar o terminal web no meu próprio domínio?
A MetaQuotes afirma que os seus guias para corretoras levam a instalação da escolha do domínio à integração no site em cerca de 30 minutos. Com a FXPTrader, o Worker e as configurações são implantados na sua conta Cloudflare, e uma configuração típica entra no ar no mesmo dia, assim que o seu acesso ao MT5 e o domínio estiverem prontos.