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.”
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.
| API | Definição da MetaQuotes | Onde o seu código roda | Uso 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 rede | CRM, á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 servidor | Ferramentas 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 plugin | Regras 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 à plataforma | Provedores 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órios | Relatórios regulatórios e gerenciais personalizados |
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:
- 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.
- RespostaA aplicação combina o hash da senha com esse desafio, envia o resultado e acrescenta um desafio aleatório próprio.
- 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.
- 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.
| Área | O que abrange | Uso típico |
|---|---|---|
| Usuários e contas | Criar, atualizar, excluir e ler contas; verificar ou alterar senhas; ler saldo, equity e margem | Abertura de conta após o KYC no CRM, redefinição de senha, painéis da área do cliente |
| Operações de saldo | Depósitos, saques, crédito e correções em uma conta | Creditar automaticamente um depósito por cartão ou transferência bancária |
| Grupos e símbolos | Ler e manter grupos e configurações de símbolos | Mostrar especificações de contrato, margem e sessões corretas em um front end |
| Ordens, posições, negócios, histórico | Dados de negociação em aberto e históricos, incluindo consultas em lote para várias contas | Histó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áfico | Cotações e gráficos em um WebTrader ou app para celular |
| Requisições de negociação | Requisições executadas no servidor em nome de uma conta, com um código de resultado | Enviar, modificar e fechar ordens a partir de um front end personalizado |
| Correio e notícias | Correio interno e notícias para os terminais | Mensagens de serviço para os clientes |
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.
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.
| Estrutura | Quem controla o servidor | O que normalmente é possível obter |
|---|---|---|
| Licença própria de MT5 | A sua empresa | Acesso total; você mesmo cria os managers e define as permissões |
| White label de MT5 | O titular da licença | Um manager restrito aos seus grupos, se o contrato permitir |
| Grey label de MT5 | O provedor | Varia 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 |
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 MT5 Web API é REST?
Posso construir o meu próprio WebTrader sobre a MT5 Web API?
A Web API dá acesso à profundidade de mercado?
Qual a diferença entre a Web API e a Manager API?
Uma corretora grey label consegue acesso à API?
A MT5 Web API tem limites de requisições?
A MT5 Web API é segura?
Quanto tempo leva uma integração com a MT5 Web API?
Preciso de permissão da MetaQuotes para usar a Web API?
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
- MetaQuotes — MetaTrader 5 trading platform for brokers and banks (consultado em outubro de 2026)
- MetaQuotes — MetaTrader 5 for brokers (metaquotes.net) (consultado em outubro de 2026)
- MetaQuotes — Liquidity providers for MetaTrader 5 (consultado em outubro de 2026)
- 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.