1. Início
  2. APIs do MT5 e execução
  3. MT5 Web API
MT5 Web API · Atualizado em outubro de 2026

MetaTrader 5 Web API: o que é, o que faz e o que não faz

A MT5 Web API é a interface que a maioria das integrações de corretoras usa de fato: CRMs, áreas do cliente e front ends de negociação personalizados. Rodamos um WebTrader em produção sobre ela, então este guia foi escrito por quem a usa por dentro, incluindo o que não aparece nos folhetos.

Atualizado em 25 de outubro de 202610 min de leituraEquipe editorial da FXUP
TradersWebTrader e apps para iOS e Android
Servidor do MetaTrader 5Grupos, símbolos e ajustes de risco
Gateway ou bridgeRoteamento A-book, B-book ou híbrido
Provedores de liquidezPreços e execução
Faz login como
Uma conta de manager do MT5
Transporte
Requisições HTTPS com respostas em JSON, além de um protocolo binário
Push para clientes
Não vem pronto — quem integra precisa implementar
Uso na FXUP
Back end em Go por trás do nosso WebTrader e dos apps
Em resumo

A MetaTrader 5 Web API é a interface do lado do servidor criada pela MetaQuotes para conectar um servidor de negociação MT5 a sites, CRMs e outros sistemas da empresa. Uma aplicação faz login com uma conta de manager e pode gerenciar usuários, saldos, grupos, símbolos, ordens, posições, negócios, ticks e gráficos. Ela não conecta provedores de liquidez nem transmite o livro de ofertas de um LP; essas tarefas cabem a outras APIs do MT5.

O que é a MetaTrader 5 Web API?

A MetaTrader 5 Web API é a interface que a MetaQuotes oferece para conectar um servidor de negociação MT5 aos serviços web da própria corretora: área do cliente, CRM, processamento de pagamentos, relatórios e front ends de negociação personalizados. Ela atua sobre o servidor, não sobre o terminal de um trader, e se autentica como manager — o mesmo tipo de conta que a sua equipe de back office usa no terminal MT5 Manager.

A definição de uma linha da própria MetaQuotes é curta e precisa: a Web API serve para integração com recursos web e outros serviços da empresa. Todo o restante desta página trata do que isso significa na prática. A referência técnica completa fica no site de suporte da MetaQuotes, disponível para titulares de licença após o login; se você tem uma licença de servidor MT5, ou trabalha para quem tem, essa referência prevalece sobre qualquer coisa escrita aqui.

“A Web API é usada para integrar a plataforma a recursos web e a outros serviços da empresa.”
— MetaQuotes — MetaTrader 5 trading platform for brokers and banks

Qual a diferença entre a Web API e as outras APIs do MetaTrader 5?

A MetaQuotes publica cinco APIs para o MT5, e cada uma tem uma função diferente. A Web API é a que conversa com o servidor de fora, pela rede; as demais rodam dentro do servidor, o conectam aos mercados ou ampliam os seus relatórios. As definições da segunda coluna foram citadas da página da MetaQuotes para corretoras.

As cinco APIs do MetaTrader 5
APIDefinição da MetaQuotesOnde o seu código rodaUso típico na corretora
Web API“usada para integrar a plataforma a recursos web e a outros serviços da empresa”No seu próprio servidor, conectando-se pela redeCRM, área do cliente, pagamentos, WebTrader personalizado
Manager API“permite desenvolver utilitários personalizados de administração e gestão, ou até o seu próprio terminal de manager”Uma aplicação de manager conectada ao servidorFerramentas de back office, utilitários de dealing e de risco
Server API“pode ajudar você a adicionar mais funções ao MetaTrader 5 Trade Server e ao MetaTrader 5 History Server”Dentro do servidor MT5, como pluginRegras personalizadas em cada operação, bônus, lógica de cópia
Gateway API“usada para integrar o MetaTrader 5 a outros sistemas de negociação e criar fluxos de dados personalizados”Um gateway acoplado à plataformaProvedores de liquidez, bolsas, fluxos de dados
Report API“amplia os relatórios produzidos pelos servidores de negociação do MetaTrader 5”Dentro do componente de relatóriosRelatórios regulatórios e gerenciais personalizados
Definições citadas de https://www.metatrader5.com/en/brokers, consultado em 12 de outubro de 2026.

A MT5 Web API é REST ou WebSocket?

A MT5 Web API funciona por requisição e resposta: a sua aplicação envia um comando e aguarda a resposta. Nas versões atuais, isso significa requisições HTTPS para caminhos como /api/user/get ou /api/tick/last, com respostas em JSON, ao lado de um protocolo binário mais antigo sobre um socket persistente, usado no próprio código de exemplo da MetaQuotes. Nós usamos os dois, para tarefas diferentes.

O que ela não é: uma API WebSocket. Nada na Web API envia por iniciativa própria uma mudança de preço ou de posição; se você quer atualizações ao vivo, precisa pedi-las na frequência que escolher. Quando um provedor diz que a sua “MT5 Web API é baseada em WebSocket”, normalmente quer dizer que construiu uma camada WebSocket por cima — exatamente o que fizemos no nosso WebTrader com marca própria.

Vale esclarecer logo uma segunda confusão. Vários serviços vendem uma “MT5 API” que se conecta à conta de um trader por meio de um terminal rodando na nuvem deles, ou pelo pacote Python da MetaQuotes para o terminal desktop. Essas são ferramentas no nível da conta, para traders e serviços de sinais. A Web API atua no nível da corretora: enxerga todas as contas do servidor que o manager tem permissão para ver.

Como funciona a autenticação na MT5 Web API?

A sua aplicação se autentica como manager do MT5 por meio de uma troca de desafio e resposta, de modo que a senha do manager nunca trafega em texto puro. No formato HTTPS que usamos, são necessárias duas chamadas:

  1. InícioA aplicação chama o comando de início de autenticação com o login de manager, identificando-se como agente da Web API. O servidor responde com um desafio aleatório.
  2. RespostaA aplicação combina o hash da senha com esse desafio, envia o resultado e acrescenta um desafio aleatório próprio.
  3. Verificação do servidorO servidor responde ao desafio do cliente; a aplicação confere essa resposta, e assim os dois lados provam que conhecem a senha.
  4. Manutenção da sessãoA sessão autenticada fica atrelada à conexão subjacente. Se a conexão cair, é preciso autenticar de novo.

O que dá para construir com a MetaTrader 5 Web API?

Quase todo sistema voltado ao cliente de que uma corretora precisa pode ser construído sobre a Web API, porque ela alcança os objetos que importam para esses sistemas: usuários, contas, grupos, símbolos, ordens, posições, negócios e histórico de preços. A tabela relaciona as áreas de comandos que usamos às tarefas que elas atendem.

Áreas de comandos da Web API e para que as corretoras as usam
ÁreaO que abrangeUso típico
Usuários e contasCriar, atualizar, excluir e ler contas; verificar ou alterar senhas; ler saldo, equity e margemAbertura de conta após o KYC no CRM, redefinição de senha, painéis da área do cliente
Operações de saldoDepósitos, saques, crédito e correções em uma contaCreditar automaticamente um depósito por cartão ou transferência bancária
Grupos e símbolosLer e manter grupos e configurações de símbolosMostrar especificações de contrato, margem e sessões corretas em um front end
Ordens, posições, negócios, históricoDados de negociação em aberto e históricos, incluindo consultas em lote para várias contasHistórico de operações, extratos, cálculo de comissões de IB
Preços e gráficosÚltimos ticks, estatísticas de ticks, histórico de ticks e barras de gráficoCotações e gráficos em um WebTrader ou app para celular
Requisições de negociaçãoRequisições executadas no servidor em nome de uma conta, com um código de resultadoEnviar, modificar e fechar ordens a partir de um front end personalizado
Correio e notíciasCorreio interno e notícias para os terminaisMensagens de serviço para os clientes
Com base no conjunto de comandos da Web API usado na integração em produção da FXUP. Confira a referência da MetaQuotes para a build do seu servidor.

O que a MT5 Web API não faz?

A Web API não conecta o seu servidor à liquidez, não executa código dentro do servidor e não envia dados por push. Esses limites são intencionais: existem outras APIs do MetaTrader 5 para cada uma dessas tarefas.

  • Sem conexão com liquidez. Os preços de bancos ou provedores prime-of-prime chegam por um gateway, uma ponte de liquidez (bridge) ou pelo Ultency — veja as páginas sobre a MT5 Gateway API e a integração de liquidez.
  • Sem livro de ofertas do LP nem profundidade de mercado. A Web API fornece os últimos ticks e estatísticas por símbolo. Ela não transmite o livro agregado dos seus provedores, então um front end baseado na Web API mostra bid e ask, não uma escada de profundidade de mercado.
  • Sem lógica dentro do servidor. Regras que precisam rodar em cada operação, antes da execução, exigem um plugin da Server API. Uma aplicação da Web API só enxerga o que já aconteceu.
  • Sem push. Cada atualização é uma requisição; cotações e posições ao vivo exigem polling numa frequência que você escolhe e que o servidor aguente.
  • Sem relatórios personalizados do servidor. Ampliar os relatórios gerados pelo próprio servidor de negociação é tarefa da Report API.
Se um fornecedor promete profundidade de mercado dos seus LPs dentro de um WebTrader baseado na Web API, pergunte exatamente de qual interface vem essa profundidade.

Como a FXUP usa a MT5 Web API no seu WebTrader?

O nosso WebTrader e os nossos apps para celular nunca falam diretamente com o MT5. Eles se conectam por WebSocket seguro a um back end escrito em Go, e esse back end conversa com o servidor MT5 pela Web API, usando tanto o protocolo binário quanto requisições HTTPS. O cliente recebe atualizações no estilo push; o servidor MT5 vê um número pequeno e previsível de sessões de manager.

Você pode conferir o resultado na demo do WebTrader e na demo do app para celular, ambas conectadas a um ambiente demo real do MT5. A FXUP é uma desenvolvedora independente e não tem vínculo com a MetaQuotes; construímos sobre as interfaces publicadas, como qualquer outro integrador. O nosso próprio CRM usa o mesmo back end, e também trabalhamos com CRMs de parceiros, propondo o que melhor se encaixa na estrutura da corretora.

Polling em lote

Um único loop pede ao MT5 ticks, posições, ordens e números das contas a cada 100 milissegundos usando consultas em lote, então a carga no servidor não cresce com o número de usuários conectados.

Push por cliente

Cada cliente conectado recebe apenas os símbolos e as contas que assinou, e as partes que não mudaram não são reenviadas. Pacotes grandes são compactados.

Cache de histórico

O histórico dos gráficos fica em cache no disco e é carregado sob demanda, então um trader que volta anos em candles de H1 não aciona o servidor MT5 a cada vez.

Segurança nas operações

Uma ordem idêntica que ainda está em execução é descartada como duplicada, e nem o servidor nem os apps reenviam automaticamente uma operação após um timeout — uma execução em dobro é pior do que uma nova tentativa feita pelo próprio trader.

Como as operações são enviadas pela Web API?

Uma operação pela Web API é uma requisição executada no servidor em nome da conta do cliente, seguida de um resultado. A sua aplicação envia a requisição, recebe um identificador e depois lê o desfecho: um código de retorno como 10009 (concluída) ou 10008 (ordem colocada), ou uma rejeição, como stops inválidos, mercado fechado ou saldo insuficiente.

Isso tem duas consequências práticas. Primeiro, as permissões do próprio cliente continuam valendo: configurações de grupo, modos de negociação dos símbolos, níveis de stop e margem são aplicados pelo servidor, não pelo seu front end, então a palavra final é do servidor. Segundo, um timeout não significa que a ordem falhou. Se a resposta não chegar, o correto é verificar as posições e o histórico antes de qualquer outra coisa. Os nossos front ends informam ao trader que o resultado é incerto, em vez de enviar a mesma ordem de novo.

Os timestamps são outro detalhe que pega muitas equipes de surpresa. O MT5 registra os horários no fuso configurado no servidor de negociação; tudo o que você mostra aos clientes ou guarda no CRM deve ser convertido para UTC real uma única vez, em um único ponto.

Uma integração com a MT5 Web API é segura?

A Web API em si usa autenticação por desafio e resposta e permite sessões criptografadas; a maior parte do risco restante está na forma como o integrador lida com a conta de manager. Um manager da Web API muitas vezes pode movimentar dinheiro e alterar contas, então trate as credenciais dele como as chaves de uma conta bancária. A MetaQuotes afirma na sua página para corretoras que a troca de dados entre os componentes do sistema ocorre por conexão criptografada; os seus próprios sistemas precisam da mesma disciplina.

  • Dê à integração uma conta de manager própria, apenas com as permissões e os grupos de que ela precisa; nunca reutilize o login de um dealer.
  • Restrinja de onde esse manager pode se conectar e guarde as credenciais em um cofre de segredos, não no código-fonte.
  • Nunca exponha a Web API a navegadores ou apps. Os clientes se conectam ao seu back end, que confere cada requisição em relação à conta do próprio cliente.
  • Do seu lado, limite a frequência de tentativas e bloqueie logins com falhas repetidas por endereço IP.
  • Registre cada operação de saldo com quem a acionou e por quê, e concilie esses registros com o CRM diariamente.

A MT5 Web API tem limites de requisições?

A MetaQuotes não publica limites de requisições nas suas páginas públicas, e não vamos citar números que não podemos comprovar. Na prática, o limite é a capacidade do seu servidor e o comportamento da sua integração, e uma integração descuidada pode deixar um servidor de negociação lento para todo mundo.

O que funciona para nós é manter um pool de sessões autenticadas, separar as requisições de negociação das consultas gerais, usar comandos em lote sempre que existirem e guardar em cache tudo o que não muda a cada segundo, como configurações de símbolos e histórico encerrado. Do lado do cliente, aplicamos um controle geral de mensagens por conexão, mas nenhum limite de operações: o cliente pode enviar ordens uma atrás da outra, porque negociar é isso.

Se você está desenhando a sua própria integração, anote o perfil de carga dela antes de entrar no ar: com que frequência você faz polling de cada tipo de dado, para quantas contas e por quantas sessões. Essa única página responde à maioria das perguntas que um administrador de servidor vai fazer.

Quem pode ter acesso à MT5 Web API?

O acesso à Web API vem de quem controla o servidor MT5, porque ele exige uma conta de manager nesse servidor. O que isso significa depende da sua estrutura. Para ver qual estrutura da FXUP dá a você o acesso de que precisa, com preços e condições atuais na mesma tela, compare as opções no buscador de soluções.

Acesso à Web API por estrutura de corretora
EstruturaQuem controla o servidorO que normalmente é possível obter
Licença própria de MT5A sua empresaAcesso total; você mesmo cria os managers e define as permissões
White label de MT5O titular da licençaUm manager restrito aos seus grupos, se o contrato permitir
Grey label de MT5O provedorVaria conforme o provedor; com a FXUP, uma conta Manager dedicada que vê apenas os seus usuários, mais acesso à Manager API e ao SDK após o pagamento
Padrão geral observado nos projetos da FXUP; as condições exatas são definidas em cada contrato.

O que deve constar em um checklist de integração com a MT5 Web API?

Antes de escrever código, resolva o que sai caro mudar depois. Esta é a lista que repassamos com clientes que conectam um CRM para corretoras, uma área do cliente ou um front end; o mesmo checklist vale para as outras integrações personalizadas que desenvolvemos:

  • Qual build do servidor e qual formato da Web API (HTTPS, binário ou ambos) você vai usar.
  • Uma conta de manager dedicada, as suas permissões e os grupos que ela pode ver.
  • Quais eventos disparam a criação de contas, as alterações de saldo e as mudanças de grupo — e quem as aprova.
  • A frequência de polling por tipo de dado e os comandos em lote que a atendem.
  • O tratamento de fusos horários e um único ponto de conversão.
  • O que acontece em caso de timeout em cada operação, sobretudo em negociações e alterações de saldo.
  • Monitoramento: um alerta quando a conexão com o MT5 cai, não a reclamação de um cliente.

Perguntas frequentes

O que é a MetaTrader 5 Web API?
É a interface do lado do servidor criada pela MetaQuotes para conectar um servidor de negociação MT5 a sites, CRMs e outros sistemas da empresa. Uma aplicação faz login como manager e pode gerenciar usuários, saldos, símbolos, operações e histórico. Ela é voltada a corretoras e aos seus desenvolvedores, não a traders individuais.
A MT5 Web API é REST?
Em grande parte, sim. As versões atuais aceitam requisições HTTPS e devolvem JSON, e há também um protocolo binário via socket. O modelo é de requisição e resposta; não há push por WebSocket nativo, então os dados ao vivo precisam ser obtidos por polling.
Posso construir o meu próprio WebTrader sobre a MT5 Web API?
Sim. É assim que o nosso WebTrader funciona: um back end em Go conversa com o MT5 pela Web API e transmite os dados para o navegador e os apps por WebSocket. É preciso tratar com cuidado o polling, o cache, os fusos horários e os timeouts das operações.
A Web API dá acesso à profundidade de mercado?
Não ao livro de ofertas agregado dos seus provedores de liquidez. Ela fornece os últimos ticks e estatísticas por símbolo. A profundidade de mercado e a conexão com os LPs ficam a cargo de gateways, bridges e do Ultency.
Qual a diferença entre a Web API e a Manager API?
As duas atuam como manager no servidor. A Manager API é uma biblioteca para criar ferramentas de administração e terminais de manager; a Web API foi projetada para integração em rede com serviços web, como um CRM ou uma área do cliente. O nosso guia da MT5 Manager API compara as duas em detalhe.
Uma corretora grey label consegue acesso à API?
Depende do provedor. No grey label, o provedor controla o servidor, e alguns só deixam você trabalhar pelo CRM e pelos front ends deles. No grey label da FXUP, você recebe uma conta Manager dedicada que vê apenas os seus próprios usuários e acesso à Manager API e ao SDK após o pagamento, que é o que você precisa para conectar um CRM ou um painel de prop firm.
A MT5 Web API tem limites de requisições?
A MetaQuotes não publica números nas suas páginas públicas. Na prática, o limite é a capacidade do seu servidor, então use comandos em lote, cache e um pool fixo de sessões, em vez de uma sessão por usuário.
A MT5 Web API é segura?
Sim, se você cuidar bem da conta de manager. A autenticação é por desafio e resposta, e as sessões podem ser criptografadas. Os principais riscos são managers com permissões em excesso, credenciais no código e a exposição da API diretamente aos clientes.
Quanto tempo leva uma integração com a MT5 Web API?
Depende do escopo. Ler contas e histórico para uma área do cliente é um trabalho pequeno; um front end de negociação completo, com dados ao vivo, gráficos e tratamento de ordens, é um projeto à parte. Definimos o escopo de cada caso depois de ver os requisitos.
Preciso de permissão da MetaQuotes para usar a Web API?
Você precisa de uma conta de manager em um servidor MT5, que é fornecida pelo titular da licença. A FXUP não tem vínculo com a MetaQuotes; para questões de licenciamento dos componentes de API, consulte diretamente a MetaQuotes ou o provedor do seu servidor.

Não encontrou sua pergunta? Abrir o buscador de soluções e veja a configuração, os preços e as condições que se encaixam no seu caso.

Fontes

  1. MetaQuotes — MetaTrader 5 trading platform for brokers and banks (consultado em outubro de 2026)
  2. MetaQuotes — MetaTrader 5 for brokers (metaquotes.net) (consultado em outubro de 2026)
  3. MetaQuotes — Liquidity providers for MetaTrader 5 (consultado em outubro de 2026)
  4. MQL5 Reference — Python integration for the MetaTrader 5 terminal (consultado em outubro de 2026)

A FXUP é uma consultoria e empresa de tecnologia independente e não tem vínculo com a MetaQuotes Ltd. MetaTrader 4 e MetaTrader 5 são marcas registradas da MetaQuotes Ltd. Esta página traz informações gerais e não constitui aconselhamento jurídico, tributário ou de investimento; as exigências regulatórias dependem de cada jurisdição e mudam com o tempo. Os preços e as condições atualizados da FXUP aparecem no buscador de soluções.

Buscador de soluções

Veja qual estrutura MT5 dá o acesso à API de que você precisa

Diga ao buscador se você opera o seu próprio servidor ou precisa de um, e o que pretende conectar. Ele mostra o produto da FXUP correspondente, com preços e condições atuais.

  1. 01
    Responda a algumas perguntas

    O que você está montando, qual plataforma, real ou demo.

  2. 02
    Veja preço e condições

    Na mesma tela em que você escolhe, antes de compartilhar qualquer dado.

  3. 03
    Continue com uma referência

    Suas escolhas chegam à equipe e você continua pelo WhatsApp, Telegram ou e-mail.

Soluções e preços