Conector MetaTrader 5

O que ele faz e o que ele não faz

O conector lê saldo, patrimônio, margem, posições abertas e histórico de ordens e negócios da conta em que está anexado, e envia esses dados para a sua conta no TCC depois de um pareamento com código de uso único.

Ele não envia ordens, não modifica stop nem alvo, não fecha posição e não importa DLL. Não existe caminho de código no arquivo que chegue a uma função de negociação — e isso é verificável em segundos, sem confiar na nossa palavra.

Ele existe para que o número não dependa da mesa: o saldo e o patrimônio que aparecem no TCC são os que o terminal da sua corretora reporta, não os que você digitou. O estado da conta é reenviado a cada dois minutos enquanto o gráfico está aberto, e um sinal de vida a cada minuto. Os dois valores estão no código, em Include/TCCConfig.mqh, nas linhas TCC_SYNC_SECONDS e TCC_HEARTBEAT_SECONDS — é lá que se confere, não aqui.

O conector está no plano gratuito e não custa por conta conectada: quem acompanha três mesas anexa o EA em três terminais e continua sem pagar por isso. No resto do mercado, acompanhar a conta perto do tempo real é pedágio ou trabalho — há ferramenta que cobra uma assinatura por ano e por conta para tirar o atraso do plano grátis, e há ferramenta que exige um robô no terminal mais um servidor Windows ligado o tempo todo. Aqui o que se exige é o seu próprio MetaTrader aberto no gráfico.

Como conferir que é somente leitura

O arquivo é código-fonte MQL5 em texto puro. Abra-o no MetaEditor ou em qualquer editor de texto e procure por estes termos: OrderSend, OrderSendAsync, CTrade, PositionClose, PositionModify, OrderModify, #import. Nenhum deles aparece no código do conector.

Se algum desses termos aparecer em um arquivo que alguém lhe entregou como sendo o conector do TCC, esse arquivo não é o nosso. Compare o SHA-256 antes de anexar qualquer coisa a uma conta com dinheiro.

No Windows: certutil -hashfile TCCConnector.mq5 SHA256. No macOS ou Linux: shasum -a 256 TCCConnector.mq5. O valor precisa bater exatamente com o publicado nesta página.

O pacote completo também tem hash publicado, abfa0c4991ca75537b35687f4bc25c8c806f99b7723ad6e6c0b66250e43f530f, e ele é reprodutível: gerar o pacote de novo a partir do mesmo código devolve o mesmo arquivo, byte a byte. O instalador confere o SHA-256 de cada arquivo contra o manifesto antes de copiar qualquer coisa e se recusa a instalar se um só divergir — ele fortalece a conferência, não substitui a sua.

Segurança do pareamento

A ligação entre o terminal e a sua conta no TCC é feita por um código de seis a oito dígitos de uso único, digitado no painel do gráfico. O código não é parâmetro do EA de propósito: parâmetro fica gravado em arquivo de preset e vaza junto com ele.

O token da sessão é vinculado ao login e ao servidor da conta. Se a conta ou o servidor mudarem, a sessão cai sozinha e é preciso parear de novo. A revogação também pode ser feita a qualquer momento pelo painel do TCC.

Desde a versão 0.23 o token é gravado no seu computador, na pasta de dados do terminal, para que fechar o MetaTrader não exija um código novo toda vez. Ele tem escopo somente leitura: quem lesse esse arquivo poderia enviar telemetria daquela conexão, e nada além disso — nenhum poder de operar, nenhum acesso à corretora, nenhum acesso à sua conta no TCC. Ao voltar, o login e o servidor gravados precisam bater com a conta do gráfico e o servidor revalida o token; qualquer divergência apaga o arquivo. Quem preferir o modelo antigo desliga o parâmetro Restaurar sessão e volta a parear a cada reinício.

Instalação

Baixe o pacote TCCConnector-0.30.zip: 131 KB, 16 arquivos, todos texto — não há executável nenhum lá dentro. São o Expert Advisor, os doze arquivos de include que ele exige para compilar, o instalador e um manifesto com o SHA-256 de cada um. O .mq5 sozinho não compila: a primeira coisa que ele faz é incluir os outros doze.

No Windows, o caminho curto é extrair o pacote e rodar, na pasta extraída: powershell -ExecutionPolicy Bypass -File instalar-tcc.ps1. O instalador localiza o diretório de dados do terminal, confere os hashes, copia os arquivos e chama o MetaEditor para compilar. Ele também é código-fonte em texto puro, com hash publicado — pelo mesmo motivo que o EA é.

O -ExecutionPolicy Bypass é preciso porque o script não tem assinatura digital, e é justamente por isso que o SHA-256 dele está publicado aqui. Assinatura e hash resolvem o mesmo problema por caminhos diferentes: a assinatura pede que você confie em uma autoridade certificadora, o hash você confere sozinho, e o segundo é o que esta página inteira defende.

Fora do Windows, o caminho manual é o único: o instalador é PowerShell e pressupõe Windows, então no macOS e no Linux — e no Windows, para quem preferir — copie TCCConnector.mq5 e a pasta Include para MQL5/Experts no diretório de dados do terminal e compile no MetaEditor com F7.

Os dois caminhos param no mesmo lugar, e isso é de propósito: autorize https://tgsxkgabhiqpxcunybzi.supabase.co em Ferramentas › Opções › Expert Advisors › "Permitir WebRequest para as URLs listadas". O MetaTrader guarda essa lista cifrada justamente para que nenhum programa possa se autorizar sozinho a falar com a internet. Nenhum instalador, nosso ou de terceiro, consegue fazer esse passo por você — se conseguisse, a proteção não existiria.

Por último, arraste o EA para um gráfico qualquer da conta que quer acompanhar e digite no painel o código de pareamento. Um gráfico por conta é suficiente: o conector lê a conta inteira, não o símbolo do gráfico.

Histórico de versões

0.23 — restauração da sessão ao reabrir o terminal, com validação fail-closed: login e servidor precisam bater com a conta atual e o primeiro heartbeat confirma o token no servidor.

0.20 — reconciliação de cursor antes de qualquer lote histórico: nenhum histórico começa sem o servidor confirmar até onde já recebeu.

0.15 — painel no gráfico com campo de código de pareamento; o código deixou de ser parâmetro do EA para não ficar gravado em arquivo de preset.

0.10 — primeira versão pública somente-leitura: leitura de conta, posições, ordens e negócios, com envio ao TCC após pareamento.