MQTTFive — Biblioteca de cliente MQTT 5.0 - biblioteca para MetaTrader 5

MQTTFive — cliente MQTT 5.0 para MQL5

Biblioteca (#include) para conectar consultores do MetaTrader 5 e scripts a servidores MQTT (Mosquitto, EMQX, HiveMQ). Ela permite publicar preços e sinais, receber comandos de sistemas externos e monitorar o status dos consultores.

Sem DLL — MQL5 puro, API de soquetes própria. Protocolo MQTT v5.0.

Recursos

• QoS 0, 1, 2 com repetição automática de mensagens não enviadas
• Propriedades CONNECT/CONNACK: tempo de validade da sessão, número máximo de pacotes recebidos, número máximo de pseudônimos de tópicos.
• Mensagens agendadas com atraso na publicação
• Pseudônimos de tópicos — redução do tráfego em tópicos duplicados.
• Gerenciamento de fluxo — controle da cota para o volume máximo de dados recebidos.
• Opções de assinatura: no_local, retain_as_published, retain_handling
• TLS/SSL, carga útil binária, UTF-8

Instalação

1. Copie os 5 arquivos do arquivo compactado para a pasta MQL5/Include/MQTTFive/
2. No código: #include <MQTTFive/MQTTClient.mqh>

Exemplo — publicação de preço

#include <MQTTFive/MQTTClient.mqh>

void OnStart ()
  {
   MQTTClient client;
   MQTTConnectParams params;
   params.Init();
   params.client_id = "price_pub" ;

   if (client.Connect( "127.0.0.1" , 1883 , params))
     {
       double bid = SymbolInfoDouble ( _Symbol , SYMBOL_BID );
      client.Publish( "mt5/price/" + _Symbol , DoubleToString (bid, _Digits ), 0 );
      client.Disconnect();
     }
  }

Exemplo — assinatura de sinais

MQTTClient *mqtt;

void OnSignal( string &topic, uchar &payload[], uint payload_len)
  {
   string msg = CharArrayToString (payload, 0 , ( int )payload_len, CP_UTF8 );
   Print ( "Signal: " , topic, " = " , msg);
  }

void OnStart ()
  {
   mqtt = new MQTTClient();
   mqtt.SetCallback(OnSignal);
   MQTTConnectParams params;
   params.Init();
   params.client_id = "signal_sub" ;
   mqtt.Connect( "127.0.0.1" , 1883 , params);
   mqtt.Subscribe( "trade/signal/#" , 1 );
   while (! IsStopped ())
     {
      mqtt.Loop();
       Sleep ( 100 );
     }
   mqtt.Disconnect();
   delete mqtt;
  }

Métodos principais

Requisitos

• MetaTrader 5 (versão 3390+)
• Broker MQTT 5.0 (Mosquitto >= 5.0, EMQX, HiveMQ)

Documentação: github.com/chekh/MQTTFive

Licença: MIT