Integrações sob medida para corretoras MT5 são os softwares que ligam um servidor MetaTrader 5 a tudo ao redor: CRM, provedores de pagamento, fornecedores de KYC e PLD/AML, bridges de liquidez, fluxos de dados de mercado e sistemas da própria corretora. A FXUP as desenvolve sobre a Web API e a Manager API da MetaQuotes e sobre a API e os webhooks de cada fornecedor, com cada evento registrado e aplicado uma única vez.
De quais integrações sob medida uma corretora MT5 costuma precisar?
Normalmente de cinco tipos: dados de contas e operações do MT5 para o CRM, pagamentos para os saldos do MT5, resultados de verificação para o cadastro do cliente, preços e ordens entre o MT5 e a liquidez, e relatórios para o financeiro ou a diretoria. Uma corretora que entra no ar com uma stack pronta já recebe quase tudo isso conectado. O trabalho sob medida começa quando você adiciona um provedor de pagamento que ninguém integrou ainda, usa um fornecedor de KYC preferido pelo seu regulador, precisa de um relatório que o banco pediu ou quer que eventos do MT5 cheguem a um sistema do qual sua equipe já depende.
Chegamos a esse trabalho por um ângulo específico. Nosso próprio WebTrader com sua marca e nosso aplicativo de negociação para celular rodam sobre um back end em Go que conversa com o MetaTrader 5 pela Web API o dia inteiro, para cada cliente conectado. Os problemas que pesam em integrações, como timeouts, eventos duplicados, relógios de servidor e falhas parciais, são problemas que enfrentamos primeiro nos nossos próprios produtos.
Quais APIs do MetaTrader 5 uma integração pode usar?
A MetaQuotes oferece cinco APIs de servidor, e a escolha certa depende do que a integração precisa fazer. A maioria das integrações de corretoras usa a Manager API ou a Web API; a Gateway API e a Server API servem para trabalhos mais profundos na execução e no próprio servidor de negociação. A tabela usa as definições de uma linha da própria MetaQuotes.
| API | Definição da MetaQuotes | Integração típica na corretora |
|---|---|---|
| Manager API | “permite desenvolver utilitários próprios de administração e gestão, ou até mesmo o seu próprio terminal de gerente” | Abertura de contas pelo CRM, operações de saldo, ferramentas de back office |
| Web API | “usada para integrar a plataforma a recursos web e a outros serviços da empresa” | Serviços web, áreas do cliente, front ends de negociação como o nosso |
| Gateway API | “usada para integrar o MetaTrader 5 a outros sistemas de negociação e criar fluxos de dados próprios” | Conexões com ambientes de liquidez e fontes externas de preço |
| Server API | “pode ajudar a adicionar mais funções ao MetaTrader 5 Trade Server e ao MetaTrader 5 History Server” | Plugins de servidor para regras e processamentos próprios |
| Report API | “amplia os relatórios gerados pelos servidores de negociação do MetaTrader 5” | Relatórios próprios no lado do servidor |
Como é uma integração da FXUP por dentro?
Normalmente, um pequeno serviço em Go que fica ao lado do MT5, mantém a conexão com a API e faz bem uma única tarefa. Nossos front ends de negociação usam o mesmo desenho: o back end em Go mantém um pool de conexões com o servidor MT5, consulta o servidor em lotes para cada usuário conectado mais ou menos a cada 100 milissegundos e envia as mudanças para navegadores e celulares por WebSocket, o protocolo que a IETF padronizou na RFC 6455 para comunicação bidirecional entre cliente e servidor. O MT5 em si é acessado pela Web API, não por WebSocket.
Para integrações, esse desenho tem três consequências práticas. As credenciais ficam em um único lugar, no servidor. A carga sobre o MT5 não cresce a cada novo usuário ou relatório, porque as consultas são feitas em lote. E quando o servidor de negociação reinicia, como acontece nas atualizações do MT5, o serviço se reconecta e segue funcionando, sem ninguém precisar reiniciá-lo manualmente. As atualizações vão primeiro para a instância demo e são verificadas antes de mexer no ambiente real.
Como funciona a integração com um provedor de pagamento?
O provedor avisa seu sistema de que o dinheiro foi movimentado, e seu sistema transforma isso em uma operação de saldo no MT5 exatamente uma vez. O cliente inicia o depósito na área do cliente, o CRM cria uma solicitação de pagamento e envia o cliente ao provedor, que depois manda uma notificação com o resultado, geralmente por webhook. A integração verifica a notificação, associa-a à solicitação, registra tudo e só então credita o MT5.
Dois detalhes separam uma integração confiável de uma frágil. Primeiro, as notificações são verificadas antes de qualquer ação; a documentação da Stripe, por exemplo, descreve a checagem de uma assinatura em cada webhook para que ninguém consiga forjar uma mensagem de pagamento. Segundo, o mesmo evento pode chegar mais de uma vez, então a integração precisa reconhecer a repetição e ignorá-la. A Stripe diz isso com todas as letras.
Os saques fazem o caminho inverso e exigem mais cuidado, porque o dinheiro está saindo da empresa. A integração verifica o status do KYC e a margem livre, aguarda a aprovação da equipe quando suas regras exigem, debita o MT5 e só então dá a instrução ao provedor. Se alguma etapa falhar, o registro mostra exatamente onde, e o financeiro nunca precisa adivinhar se o cliente foi pago. É no CRM para forex que ficam essas aprovações.
“Endpoints de webhook podem, ocasionalmente, receber o mesmo evento mais de uma vez. Você pode se proteger contra o recebimento duplicado de eventos registrando os IDs dos eventos que já processou e, depois, não processando eventos já registrados.”
Como funcionam as integrações com fornecedores de KYC e PLD/AML?
O fornecedor faz as verificações de documentos e de identidade; a integração traz o resultado de volta para o seu CRM e avança o cliente para a próxima etapa ou o coloca em uma fila de análise. A maioria dos fornecedores oferece uma verificação hospedada ou embutida e depois informa o resultado por webhook; a Sumsub, por exemplo, descreve seus webhooks como uma forma de “receber notificações automáticas sobre eventos de verificação”. A integração associa cada status ao seu fluxo de trabalho: aprovado, recusado, faltam documentos ou análise manual.
O que mais importa é o registro. Um responsável de compliance deve conseguir abrir o cadastro de um cliente e ver qual verificação foi feita, quando, com qual resultado e quem tomou a decisão final. Se você trocar de fornecedor depois, o histórico do anterior deve continuar legível. Nosso verbete de KYC e PLD/AML no glossário explica os termos. Quais verificações você precisa fazer é definido pelo seu regulador e pelos países de onde vêm seus clientes; isto não é aconselhamento jurídico.
Vocês integram provedores de liquidez e bridges ao MT5?
Sim. A conexão do MT5 com a liquidez é feita por uma ponte (bridge), um sistema separado que roteia ordens e agrega preços, ou por um gateway que roda como parte do ambiente MT5. A MetaQuotes agora também oferece seu próprio produto de agregação, o Ultency, que ela descreve como uma “solução de latência ultrabaixa para agregação de liquidez, casamento de ordens e gestão de risco” e que permite roteamento entre execuções A-Book, B-Book e C-Book.
Nossa parte em um projeto de liquidez costuma ser a integração em volta da bridge: conectá-la, verificar se os instrumentos do provedor batem com os símbolos que a sua equipe configurou no MT5, implementar as regras de roteamento que a sua mesa de operações (dealing desk) define e montar os relatórios que mostram o que foi protegido (hedge) e onde. As vantagens e desvantagens de cada opção estão nas nossas páginas sobre integração com provedor de liquidez, bridges de liquidez para MT5 e execução A-book, B-book e híbrida.
Dá para conectar fluxos de dados próprios ao MetaTrader 5?
Sim, dentro do que o titular da licença MT5 permitir. Os dados de preço chegam ao MT5 pelas conexões de liquidez ou por um fluxo separado via Gateway API, que a MetaQuotes define como voltada também à “criação de fluxos de dados próprios”. Os dados também podem seguir no sentido contrário: preços, negócios e dados de contas do MT5 exportados para um painel de risco, um sistema contábil ou um data warehouse.
O detalhe que as pessoas esquecem é o horário. O MT5 registra barras, ticks e negócios no horário do próprio servidor de negociação, que muitas corretoras configuram em UTC+2 ou UTC+3, conforme a época do ano. Uma integração que mistura horário do servidor com UTC, ou que aplica regras próprias de horário de verão, gera candles e relatórios deslocados em duas ou três horas. Nós convertemos para o tempo Unix real na fronteira entre os sistemas e nunca supomos nada. Nosso guia de price feed para forex explica de onde vêm os preços.
Eventos do MT5 podem disparar webhooks para os meus sistemas?
Sim. Um pequeno serviço pode observar no MT5 os eventos que interessam a você e enviá-los para onde sua equipe trabalha. Exemplos que já nos pediram: um aviso para a mesa de operações quando a exposição de um único cliente passa de um limite, uma notificação ao gerente de contas quando um cliente VIP deposita, uma exportação noturna dos volumes de IBs para a contabilidade ou a atualização da pontuação de um lead na ferramenta de vendas quando um cliente demo faz a primeira operação.
O padrão é sempre o mesmo. Ler o MT5 pela API, decidir o que conta como evento, enviá-lo com uma assinatura para que o destinatário possa confiar nele, tentar de novo se o destinatário estiver fora do ar e registrar tudo. O destinatário deve conseguir receber o mesmo evento duas vezes sem executar o trabalho duas vezes.
Alertas de risco
Limites de exposição, nível de margem ou ordens grandes enviados à mesa de operações em tempo real.
Exportações para o financeiro
Depósitos, saques, pagamentos de IBs e captação líquida enviados à contabilidade em horários programados.
Sinais para vendas
Primeiro depósito, primeira operação ou inatividade enviados ao seu CRM ou ferramenta de vendas.
Contexto para o suporte
Ordens e erros recentes anexados automaticamente ao chamado de suporte do cliente.
Como a FXUP define o escopo e entrega uma integração?
Partimos da documentação do outro sistema e da sua regra de negócio, não do código. Na maior parte de uma integração, o tempo vai para combinar o que deve acontecer nos casos fora do comum, e o melhor momento para isso é antes de construir qualquer coisa.
- RequisitosVocê nos diz o que deve acontecer, em termos de negócio: “creditar o MT5 quando um depósito por cartão for confirmado e segurar para análise tudo o que passar do nosso limite de aprovação”.
- Documentação e acessoLemos a documentação da API do fornecedor e combinamos com você ou com seu provedor MT5 o acesso à API do MT5 necessário.
- Escopo por escritoUm documento curto com eventos, casos extremos, novas tentativas, logs e o que sua equipe vai ver. Você aprova.
- Desenvolvimento no demoA integração roda primeiro contra seu servidor MT5 demo e o sandbox do fornecedor.
- Testes com casos reaisSua equipe executa cenários reais, incluindo falhas: notificações duplicadas, timeouts, pagamentos recusados.
- Ambiente real com monitoramentoLiberada para o ambiente real depois de verificada no demo, com alertas caso algo pare de fluir.
Quais regras de segurança valem para integrações de corretoras?
As mesmas poucas regras, sempre, porque integrações mexem com dinheiro e dados pessoais. Nós as aplicamos aos nossos próprios serviços e as exigimos de qualquer fornecedor com quem nos conectamos.
- Credenciais da API do MT5 e chaves de fornecedores ficam só no servidor, nunca em um navegador ou aplicativo.
- Toda notificação recebida é verificada, pela assinatura do fornecedor ou outro método combinado, antes de alterar qualquer coisa.
- Todo evento é registrado com um identificador, para que repetições sejam reconhecidas e ignoradas.
- Operações que movimentam dinheiro nunca são repetidas às cegas depois de um timeout; o sistema verifica antes o estado real.
- As conexões usam TLS, e o acesso ao servidor MT5 fica restrito aos serviços que precisam dele.
- As mensagens de erro exibidas aos clientes são compreensíveis e não trazem detalhes internos do servidor.
Uso um plugin pronto ou uma integração sob medida?
Use um conector pronto quando ele existir e fizer o que você precisa; desenvolva sob medida quando ele não existir ou quando o conector disponível esconder problemas que você não consegue enxergar. Muitos CRMs anunciam longas listas de integrações prontas, e, para provedores de pagamento e KYC conhecidos, esse costuma ser o caminho mais rápido. O trabalho sob medida compensa quando o provedor é regional, a regra é específica do seu negócio ou os dados precisam chegar a um sistema que mais ninguém usa.
| Conector pronto | Integração sob medida | |
|---|---|---|
| Prazo para começar | Curto, se já existir | Depende da documentação do fornecedor e do escopo |
| Aderência às suas regras | O que o conector suporta | Construída em torno das suas regras |
| Visibilidade das falhas | Varia; peça para ver os logs | Logs e alertas pensados desde o início |
| Fornecedores regionais ou de nicho | Muitas vezes ausentes | Possível, se o fornecedor tiver API |
| Manutenção | Responsabilidade do fornecedor | Combinada no escopo; muda quando a API do fornecedor muda |
Do que vocês precisam para orçar uma integração?
De três coisas: o nome do sistema do outro lado (com o link da documentação da API, se você tiver), uma ou duas frases sobre o que deve acontecer e a sua configuração de MT5. Se você está em um grey label MT5, quem controla o acesso à API é o provedor MT5: em um grey label da FXUP, o acesso à Manager API e ao SDK é liberado depois do pagamento; com outro provedor, precisamos saber quem é e o que ele permite. Em servidor próprio, vamos precisar combinar o acesso com seu administrador.
O esforço e, portanto, o orçamento dependem da qualidade da documentação do fornecedor, do número de casos extremos (reembolsos, pagamentos parciais, sessões expiradas, notificações duplicadas), da existência de um sandbox, de quantos ambientes vamos implantar e de quem mantém a conexão quando o fornecedor muda a API. Os preços e as condições atuais dos produtos padrão da FXUP aparecem no buscador de soluções, e uma integração sob medida recebe um escopo por escrito assim que o fornecedor e a regra estão definidos. Se você estiver comparando orçamentos, confira se cada um cita os mesmos casos extremos, testes no sandbox do fornecedor e um acordo de manutenção, porque essas são as linhas que mais ficam de fora.
O CRM fica no centro da maioria das integrações. A FXUP tem CRM próprio e também trabalha com CRMs parceiros; propomos o que se encaixa nos seus provedores de pagamento, no seu fornecedor de KYC e na sua estrutura de IBs, e também podemos conectar um novo fornecedor ao CRM que você já usa.
A FXUP é uma fornecedora independente de tecnologia e não tem vínculo com a MetaQuotes; o MetaTrader 5 e suas APIs são licenciados por meio do seu arranjo de MT5. Para um planejamento mais amplo, nosso guia da stack tecnológica de uma corretora mostra onde cada integração se encaixa. Se você ainda está escolhendo a configuração de MT5 em que as suas integrações vão rodar, abra o buscador de soluções: ele mostra o produto da FXUP certo para o seu caso, com os preços e as condições atuais na mesma tela e um código de referência para continuar com a nossa equipe, e a integração pode ser discutida a partir daí.
Perguntas frequentes
Que API do MT5 as integrações usam?
Vocês conectam um provedor de pagamento que meu CRM não suporta?
Vocês integram meu fornecedor de KYC?
Preciso de licença MT5 própria para integrações via API?
O MT5 pode enviar alertas para Telegram, e-mail ou meus sistemas?
Quanto tempo leva uma integração?
O que acontece se o outro sistema estiver fora do ar?
Vocês trabalham com o meu CRM atual em vez do de vocês?
A FXUP tem vínculo com a MetaQuotes?
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 for brokers (API overview) (consultado em outubro de 2026)
- MetaQuotes — Ultency (consultado em outubro de 2026)
- Stripe — Receive Stripe events in your webhook endpoint (consultado em outubro de 2026)
- Sumsub — Webhooks documentation (consultado em outubro de 2026)
- IETF — RFC 6455: The WebSocket Protocol (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.