API MetaTrader 5 con Python: automatiza la B3 y Forex.

MQL5 (el lenguaje nativo de MetaTrader) es potente, pero Python tiene un ecosistema imbatible: pandas, numpy, scikit-learn, librerías de indicadores listas para usar. La librería oficial MetaTrader5 resuelve lo mejor de los dos mundos — usas Python para pensar y MT5 para ejecutar. Y lo más importante para ti: es la forma más accesible de automatizar la B3 (mini índice y mini dólar) con Python.

01Instalación y requisitos previos

Necesitas: Windows, el terminal MT5 de tu bróker instalado y con sesión iniciada, y Python 3.11+. Entonces:

pip install MetaTrader5 pandas

02Conectar al terminal

Con MT5 abierto y con sesión iniciada en tu cuenta (¡usa cuenta demo!), inicializa la conexión:

# conectar.py
import MetaTrader5 as mt5

# inicializa la conexión con el terminal MT5 abierto
if not mt5.initialize():
    print("Falha ao conectar:", mt5.last_error())
    quit()

# información de la cuenta (confirme que es DEMO)
conta = mt5.account_info()
print(f"Conta: {conta.login} | Saldo: {conta.balance} | Servidor: {conta.server}")

# siempre cierre la conexión al terminar
# mt5.shutdown()

Si necesitas iniciar sesión por código (en vez de manualmente en el terminal), pasa las credenciales a initialize:

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

03Extraer velas (incluidas las de la B3)

Aquí está lo que conecta con tus indicadores. Extrae velas de cualquier activo que ofrezca tu bróker — incluidos WIN y WDO si te da acceso a la B3 brasileña:

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

mt5.initialize()

# símbolo: ej. "WIN$N" (mini índice), "WDO$N" (mini dólar) o "EURUSD"
# el nombre exacto del símbolo varía según el bróker — revise en Market Watch
simbolo = "WIN$N"
timeframe = mt5.TIMEFRAME_M5   # M1, M5, M15, H1, etc.

# toma las últimas 500 velas
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 la señal con tus indicadores

Aquí Python brilla — usa las funciones de indicador que ya aprendiste en nuestras guías. El DataFrame que vino de MT5 entra directo:

# reutilice las funciones de las guías de indicadores
from indicadores import calcular_rsi, calcular_macd   # sus módulos

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

# ejemplo de señal combinada
u = df.iloc[-1]
sinal_compra = (u["rsi"] < 70) and (macd.iloc[-1] > sinal.iloc[-1])

05Enviar orden

El envío de órdenes en MT5 es más verboso que en Binance, porque montas un "request" detallado. Ejemplo de compra a mercado con stop y objetivo:

# 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 de su bot
        "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

06Gestionar posiciones

Para un bot completo, necesitas consultar y cerrar posiciones:

# consultar posiciones abiertas de su bot (por el 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}")

# cerrar una posición
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)

07El bucle del bot

Juntando todo, el esqueleto del bot MT5:

import time

mt5.initialize()
try:
    while True:
        df = puxar_candles("WIN$N", mt5.TIMEFRAME_M5)
        sinal = calcular_sinal(df)              # su estrategia
        atr = calcular_atr(df).iloc[-1]        # stop dinámico

        if sinal == "COMPRA" and not tem_posicao():
            lote = dimensionar(atr)             # gestión de riesgo
            comprar("WIN$N", lote, stop_pts=2*atr, alvo_pts=4*atr)

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

08Preguntas frecuentes