API MetaTrader 5 com Python: automatize a B3 e Forex.

O MQL5 (linguagem nativa do MetaTrader) é poderoso, mas o Python tem um ecossistema imbatível: pandas, numpy, scikit-learn, bibliotecas de indicadores prontas. A biblioteca oficial MetaTrader5 resolve o melhor dos dois mundos — você usa o Python pra pensar e o MT5 pra executar. E o mais importante pra você: é a forma mais acessível de automatizar a B3 (mini índice e mini dólar) com Python.

01Instalação e pré-requisitos

Você precisa de: Windows, o terminal MT5 da sua corretora instalado e logado, e Python 3.11+. Então:

pip install MetaTrader5 pandas

02Conectar ao terminal

Com o MT5 aberto e logado na sua conta (use conta demo!), inicialize a conexão:

# conectar.py
import MetaTrader5 as mt5

# inicializa a conexão com o terminal MT5 aberto
if not mt5.initialize():
    print("Falha ao conectar:", mt5.last_error())
    quit()

# informações da conta (confirme que é DEMO)
conta = mt5.account_info()
print(f"Conta: {conta.login} | Saldo: {conta.balance} | Servidor: {conta.server}")

# sempre encerre a conexão ao terminar
# mt5.shutdown()

Se você precisa logar via código (em vez de manualmente no terminal), passe credenciais ao initialize:

mt5.initialize(login=12345678, password="sua_senha", server="NomeDoServidor-Demo")

03Puxar candles (incluindo da B3)

Aqui está o que conecta com seus indicadores. Puxe candles de qualquer ativo que sua corretora oferece — incluindo WIN e WDO se ela der acesso à B3:

# dados.py
import MetaTrader5 as mt5
import pandas as pd
from datetime import datetime

mt5.initialize()

# símbolo: ex "WIN$N" (mini índice), "WDO$N" (mini dólar) ou "EURUSD"
# o nome exato do símbolo varia por corretora — confira no Market Watch
simbolo = "WIN$N"
timeframe = mt5.TIMEFRAME_M5   # M1, M5, M15, H1, etc.

# pega os últimos 500 candles
rates = mt5.copy_rates_from_pos(simbolo, timeframe, 0, 500)
df = pd.DataFrame(rates)
df["time"] = pd.to_datetime(df["time"], unit="s")
print(df[["time","open","high","low","close","tick_volume"]].tail())

04Calcular sinal com seus indicadores

Aqui o Python brilha — use as funções de indicador que você já aprendeu nos nossos guias. O DataFrame que veio do MT5 entra direto:

# reuse as funções dos guias de indicadores
from indicadores import calcular_rsi, calcular_macd   # seus módulos

df["rsi"] = calcular_rsi(df["close"])
macd, sinal, hist = calcular_macd(df["close"])

# exemplo de sinal combinado
u = df.iloc[-1]
sinal_compra = (u["rsi"] < 70) and (macd.iloc[-1] > sinal.iloc[-1])

05Enviar ordem

O envio de ordem no MT5 é mais verboso que na Binance, porque você monta um "request" detalhado. Exemplo de compra a mercado com stop e alvo:

# executar.py
def comprar(simbolo, lote, stop_pts, alvo_pts):
    info = mt5.symbol_info_tick(simbolo)
    preco = info.ask
    point = mt5.symbol_info(simbolo).point

    request = {
        "action": mt5.TRADE_ACTION_DEAL,
        "symbol": simbolo,
        "volume": lote,
        "type": mt5.ORDER_TYPE_BUY,
        "price": preco,
        "sl": preco - stop_pts * point,   # stop loss
        "tp": preco + alvo_pts * point,   # take profit
        "deviation": 20,                   # slippage tolerado
        "magic": 123456,                  # id do seu robô
        "type_filling": mt5.ORDER_FILLING_FOK,
    }
    resultado = mt5.order_send(request)
    if resultado.retcode != mt5.TRADE_RETCODE_DONE:
        print("Erro na ordem:", resultado.retcode, resultado.comment)
    return resultado

06Gerenciar posições

Pra um robô completo, você precisa consultar e fechar posições:

# consultar posições abertas do seu robô (pelo magic)
posicoes = mt5.positions_get(symbol="WIN$N")
for p in posicoes:
    if p.magic == 123456:
        print(f"Posição {p.ticket}: lucro {p.profit}")

# fechar uma posição
def fechar(posicao):
    tick = mt5.symbol_info_tick(posicao.symbol)
    request = {
        "action": mt5.TRADE_ACTION_DEAL,
        "symbol": posicao.symbol,
        "volume": posicao.volume,
        "type": mt5.ORDER_TYPE_SELL if posicao.type == 0 else mt5.ORDER_TYPE_BUY,
        "position": posicao.ticket,
        "price": tick.bid if posicao.type == 0 else tick.ask,
        "deviation": 20,
        "type_filling": mt5.ORDER_FILLING_FOK,
    }
    return mt5.order_send(request)

07O loop do robô

Juntando tudo, o esqueleto do robô MT5:

import time

mt5.initialize()
try:
    while True:
        df = puxar_candles("WIN$N", mt5.TIMEFRAME_M5)
        sinal = calcular_sinal(df)              # sua estratégia
        atr = calcular_atr(df).iloc[-1]        # stop dinâmico

        if sinal == "COMPRA" and not tem_posicao():
            lote = dimensionar(atr)             # gestão de risco
            comprar("WIN$N", lote, stop_pts=2*atr, alvo_pts=4*atr)

        time.sleep(60)                       # checa a cada minuto
except Exception as e:
    print("Erro:", e)
finally:
    mt5.shutdown()

08Perguntas frequentes