MQL5 OrderSend Guide: MqlTradeRequest, Return Codes & Execution Code

//+------------------------------------------------------------------+
//|                                               OrderSendGuide.mq5 |
//|                             Copyright 2026, Pineify Guides Series |
//|                                              https://pineify.app |
//+------------------------------------------------------------------+
#property copyright "Pineify Guides Series"
#property link      "https://pineify.app/mql5/ordersend-guide"
#property version   "1.00"
#property script_show_inputs

//--- Input parameters
input double InpLotSize          = 0.10;   // Lot Size
input int    InpStopLossPoints   = 200;    // Stop Loss in points
input int    InpTakeProfitPoints = 400;    // Take Profit in points
input ulong  InpSlippagePoints   = 20;     // Slippage in points
input ulong  InpMagicNumber      = 770011; // EA Magic Number

//+------------------------------------------------------------------+
//| Helper: Determine supported filling mode for current symbol      |
//+------------------------------------------------------------------+
ENUM_ORDER_TYPE_FILLING GetSymbolFillingMode(const string symbol)
  {
   uint filling = (uint)SymbolInfoInteger(symbol, SYMBOL_FILLING_MODE);

   if((filling & SYMBOL_FILLING_FOK) != 0)
      return ORDER_FILLING_FOK;
   if((filling & SYMBOL_FILLING_IOC) != 0)
      return ORDER_FILLING_IOC;

   return ORDER_FILLING_RETURN;
  }

//+------------------------------------------------------------------+
//| Helper: Send Market Buy Order with Low-Level OrderSend          |
//+------------------------------------------------------------------+
bool SendMarketBuy(double lots, int slPoints, int tpPoints)
  {
   MqlTradeRequest request;
   MqlTradeResult  result;

   // 1. Always zero out request struct to avoid garbage values
   ZeroMemory(request);
   ZeroMemory(result);

   double point  = SymbolInfoDouble(_Symbol, SYMBOL_POINT);
   int digits    = (int)SymbolInfoInteger(_Symbol, SYMBOL_DIGITS);
   double ask    = SymbolInfoDouble(_Symbol, SYMBOL_ASK);

   // 2. Populate trade request
   request.action       = TRADE_ACTION_DEAL;
   request.symbol       = _Symbol;
   request.volume       = lots;
   request.type         = ORDER_TYPE_BUY;
   request.price        = ask;
   request.deviation    = InpSlippagePoints;
   request.magic        = InpMagicNumber;
   request.type_filling = GetSymbolFillingMode(_Symbol);
   request.comment      = "Pineify OrderSend";

   if(slPoints > 0)
      request.sl = NormalizeDouble(ask - (slPoints * point), digits);
   if(tpPoints > 0)
      request.tp = NormalizeDouble(ask + (tpPoints * point), digits);

   // 3. Send trade request to server
   if(!OrderSend(request, result))
     {
      PrintFormat("OrderSend critically failed! Retcode: %u, Error: %d",
                  result.retcode, GetLastError());
      return false;
     }

   // 4. Verify execution retcode
   if(result.retcode == TRADE_RETCODE_DONE || result.retcode == TRADE_RETCODE_PLACED)
     {
      PrintFormat("OrderSend SUCCESS! Order Ticket: %I64u, Deal: %I64u, Price: %.*f, Vol: %.2f",
                  result.order, result.deal, digits, result.price, result.volume);
      return true;
     }

   PrintFormat("OrderSend rejected by broker! Retcode: %u (%s)",
               result.retcode, result.comment);
   return false;
  }

//+------------------------------------------------------------------+
//| Script program start function                                    |
//+------------------------------------------------------------------+
void OnStart()
  {
   Print("Initiating OrderSend execution test on ", _Symbol);
   SendMarketBuy(InpLotSize, InpStopLossPoints, InpTakeProfitPoints);
  }