CustomSymbolSetMarginRate

Define o coeficiente de cobrança da margem - dependendo do tipo e direção da ordem - para o símbolo personalizado.

bool  CustomSymbolSetMarginRate(
   const string       symbol_name,              // nome do símbolo
   ENUM_ORDER_TYPE    order_type,               // tipo de ordem
   double             initial_margin_rate,      // coeficiente de cobrança da margem inicial
   double             maintenance_margin_rate   // coeficiente de cobrança da margem de manutenção
   );

Parâmetros

symbol_name

[in]  Nome do símbolo personalizado.

order_type

[in]  Tipo de ordem.

initial_margin_rate

[in] Variável de tipo double com o valor de coeficiente de cobrança da margem inicial. A margem inicial é o tamanho da soma de garantia (margem) das transações concluídas com volume de um lote para a direção correspondente. Ao multiplicar o coeficiente pela margem inicial, nós podemos obter o montante que será reservado na conta ao colocar a ordem do tipo especificado.

maintenance_margin_rate

[in] Variável do tipo double com o valor de coeficiente de cobrança da margem de manutenção. A margem de manutenção é a quantidade mínima para manter uma posição aberta com volume de um lote para a direção correspondente. Ao multiplicar o coeficiente pela margem de manutenção, nós podemos obter o montante que será reservado na conta após a ativação da ordem do tipo especificado.

Valor de retorno

true, em caso de sucesso, caso contrário, false. Para obter informações sobre o erro, você deve chamar a função GetLastError().

 

Exemplo:

//+------------------------------------------------------------------+
//|                                    CustomSymbolSetMarginRate.mq5 |
//|                                  Copyright 2024, MetaQuotes Ltd. |
//|                                             https://www.mql5.com |
//+------------------------------------------------------------------+
#property copyright "Copyright 2024, MetaQuotes Ltd."
#property link      "https://www.mql5.com"
#property version   "1.00"
 
#define   CUSTOM_SYMBOL_NAME     Symbol()+".C"     // nome do símbolo personalizado
#define   CUSTOM_SYMBOL_PATH     "Forex"           // nome do grupo onde o símbolo será criado
#define   CUSTOM_SYMBOL_ORIGIN   Symbol()          // nome do símbolo usado como base para a criação do símbolo personalizado
 
#define   INITIAL_MARGIN_RATE       1.5         // coeficiente de cobrança da margem inicial
#define   MAINTENANCE_MARGIN_RATE   1.5         // coeficiente de cobrança da margem de manutenção
 
//+------------------------------------------------------------------+
//| Script program start function                                    |
//+------------------------------------------------------------------+
void OnStart()
  {
//--- obtemos o código de erro ao criar o símbolo personalizado
   int create=CreateCustomSymbol(CUSTOM_SYMBOL_NAMECUSTOM_SYMBOL_PATHCUSTOM_SYMBOL_ORIGIN);
   
//--- se o código de erro não for 0 (criação bem-sucedida do símbolo) e não for 5304 (símbolo já criado), saímos.
   if(create!=0 && create!=5304)
      return;
      
//--- obtemos e imprimimos no log as propriedades do símbolo, com base no qual o símbolo personalizado foi criado
//--- (coeficientes de cobrança da margem inicial e de manutenção para ordens Buy e Sell)
   double initial_margin_rate_buy=0;
   double maintenance_margin_rate_buy=0;
   double initial_margin_rate_sell=0;
   double maintenance_margin_rate_sell=0;
   
   if(!GetSymbolMarginRate(CUSTOM_SYMBOL_ORIGINORDER_TYPE_BUYinitial_margin_rate_buymaintenance_margin_rate_buy))
      return;
   if(!GetSymbolMarginRate(CUSTOM_SYMBOL_ORIGINORDER_TYPE_SELL,initial_margin_rate_sell,maintenance_margin_rate_sell))
      return;
   
   PrintFormat("The '%s' symbol from which the custom '%s' was created:\n"+
               "  Buy order initial margin rate: %f\n  Buy order maintenance margin rate: %f\n"+
               "  Sell order initial margin rate: %f\n  Sell order maintenance margin rate: %f",
               CUSTOM_SYMBOL_ORIGINCUSTOM_SYMBOL_NAME,
               initial_margin_rate_buymaintenance_margin_rate_buyinitial_margin_rate_sellmaintenance_margin_rate_sell);
   
//--- definimos outros valores para essas propriedades do símbolo personalizado
   ResetLastError();
   bool res=true;
   res &=CustomSymbolSetMarginRate(CUSTOM_SYMBOL_NAMEORDER_TYPE_BUYINITIAL_MARGIN_RATEMAINTENANCE_MARGIN_RATE);
   res &=CustomSymbolSetMarginRate(CUSTOM_SYMBOL_NAMEORDER_TYPE_SELL,INITIAL_MARGIN_RATEMAINTENANCE_MARGIN_RATE);
 
//--- se houver erro ao definir qualquer uma das propriedades, informamos no log
   if(!res)
      Print("CustomSymbolSetMarginRate() failed. Error "GetLastError());
   
//--- obtemos e imprimimos no log as propriedades alteradas do símbolo personalizado
//--- (coeficientes de cobrança da margem inicial e de manutenção para ordens Buy e Sell)
   if(!GetSymbolMarginRate(CUSTOM_SYMBOL_NAMEORDER_TYPE_BUYinitial_margin_rate_buymaintenance_margin_rate_buy))
      return;
   if(!GetSymbolMarginRate(CUSTOM_SYMBOL_NAMEORDER_TYPE_SELL,initial_margin_rate_sell,maintenance_margin_rate_sell))
      return;
   
   PrintFormat("Custom symbol '%s' based on '%s':\n"+
               "  Buy order initial margin rate: %f\n  Buy order maintenance margin rate: %f\n"+
               "  Sell order initial margin rate: %f\n  Sell order maintenance margin rate: %f",
               CUSTOM_SYMBOL_NAMECUSTOM_SYMBOL_ORIGIN
               initial_margin_rate_buymaintenance_margin_rate_buyinitial_margin_rate_sellmaintenance_margin_rate_sell);
   
//--- no comentário do gráfico exibimos a dica sobre as chaves de encerramento do script
   Comment(StringFormat("Press 'Esc' to exit or 'Del' to delete the '%s' symbol and exit"CUSTOM_SYMBOL_NAME));
 
//--- em um loop infinito, esperamos as teclas Esc ou Del para sair
   while(!IsStopped() && TerminalInfoInteger(TERMINAL_KEYSTATE_ESCAPE)==0)
     {
      Sleep(16);
      //--- ao pressionar Del, excluímos o símbolo personalizado criado
      if(TerminalInfoInteger(TERMINAL_KEYSTATE_DELETE)<0)
        {
         if(DeleteCustomSymbol(CUSTOM_SYMBOL_NAME))
            PrintFormat("Custom symbol '%s' deleted successfully"CUSTOM_SYMBOL_NAME);
         break;
        }
     }
//--- antes de sair, limpamos o gráfico
   Comment("");
   /*
   resultado:
   The 'EURUSDsymbol from which the custom 'EURUSD.Cwas created:
     Buy order initial margin rate1.000000
     Buy order maintenance margin rate0.000000
     Sell order initial margin rate1.000000
     Sell order maintenance margin rate0.000000
   Custom symbol 'EURUSD.Cbased on 'EURUSD':
     Buy order initial margin rate1.500000
     Buy order maintenance margin rate1.500000
     Sell order initial margin rate1.500000
     Sell order maintenance margin rate1.500000
   */
  }
//+------------------------------------------------------------------+
//| Cria um símbolo personalizado, retorna o código de erro         |
//+------------------------------------------------------------------+
int CreateCustomSymbol(const string symbol_nameconst string symbol_pathconst string symbol_origin=NULL)
  {
//--- definimos o nome do símbolo usado como base para criar o símbolo personalizado
   string origin=(symbol_origin==NULL ? Symbol() : symbol_origin);
   
//--- se não for possível criar o símbolo personalizado, e isso não for um erro 5304, informamos no log
   ResetLastError();
   int error=0;
   if(!CustomSymbolCreate(symbol_namesymbol_pathorigin))
     {
      error=GetLastError();
      if(error!=5304)
         PrintFormat("CustomSymbolCreate(%s, %s, %s) failed. Error %d"symbol_namesymbol_pathoriginerror);
     }
//--- sucesso
   return(error);
  }
//+------------------------------------------------------------------+
//| Exclui o símbolo personalizado                                   |
//+------------------------------------------------------------------+
bool DeleteCustomSymbol(const string symbol_name)
  {
//--- ocultamos o símbolo da janela Observação do Mercado
   ResetLastError();
   if(!SymbolSelect(symbol_namefalse))
     {
      PrintFormat("SymbolSelect(%s, false) failed. Error %d"GetLastError());
      return(false);
     }
      
//--- se não for possível excluir o símbolo personalizado, informamos no log e retornamos false
   ResetLastError();
   if(!CustomSymbolDelete(symbol_name))
     {
      PrintFormat("CustomSymbolDelete(%s) failed. Error %d"symbol_nameGetLastError());
      return(false);
     }
//--- sucesso
   return(true);
  }
//+------------------------------------------------------------------+
//| Retorna os coeficientes de cobrança da margem                    |
//+------------------------------------------------------------------+
bool GetSymbolMarginRate(const string symbolconst ENUM_ORDER_TYPE order_typedouble &initial_margin_ratedouble &maintenance_margin_rate)
  {
   ResetLastError();
   if(!SymbolInfoMarginRate(symbolorder_typeinitial_margin_ratemaintenance_margin_rate))
     {
      PrintFormat("%s: SymbolInfoMarginRate(%s, %s) failed. Error %d",__FUNCTION__symbolEnumToString(order_type), GetLastError());
      return false;
     }
   return true;
  }

 

Veja também

SymbolInfoMarginRate