DocumentaciónSecciones
Manual de referencia de MQL5Obtención de información de mercadoMarketBookAdd 

MarketBookAdd

Proporciona la apertura de profundidad de mercado (Depth Market) para un símbolo indicado, además se encarga de la suscripción a las notificaciones acerca del cambio de esta profundidad de mercado.

bool  MarketBookAdd(
   string  symbol      // símbolo
   );

Parámetros

symbol

[in]  Nombre del símbolo cuya profundidad de mercado va a ser usada en el  Asesor Experto o script.

Valor devuelto

Devuelve valor true en caso de apertura con éxito, de lo contrario devuelve false.

Nota

Normalmente, esta función debe invocarse desde la función OnInit() o en el constructor de clase. Para procesar las notificaciones que llegan en el programa de Asesor Experto tiene que haber la función void OnBookEvent(string& symbol).

Ejemplo:

#define   SYMBOL_NAME   "GBPUSD"
 
//+------------------------------------------------------------------+
//| Script program start function                                    |
//+------------------------------------------------------------------+
void OnStart()
  {
//--- abrimos la profundidad de mercado del símbolo SYMBOL_NAME
   if(!MarketBookAdd(SYMBOL_NAME))
     {
      PrintFormat("MarketBookAdd(%s) failed. Error ", SYMBOL_NAME, GetLastError());
      return;
     }
 
//--- mostramos un mensaje en el diario de registro sobre la apertura exitosa de la profundidad de mercado.
   PrintFormat("The MarketBook for the '%s' symbol was successfully opened and a subscription to change it was received", SYMBOL_NAME);
   
//--- esperamos 2 segundos
   Sleep(2000);
   
//--- al finalizar, nos desuscribimos de la profundidad de mercado abierta
   ResetLastError();
   if(MarketBookRelease(SYMBOL_NAME))
      PrintFormat("MarketBook for the '%s' symbol was successfully closed", SYMBOL_NAME);
   else
      PrintFormat("Error %d occurred when closing MarketBook using the '%s' symbol", GetLastError(), SYMBOL_NAME);
      
   /*
   resultado:
   The MarketBook for the 'GBPUSD' symbol was successfully opened and a subscription to change it was received
   MarketBook for the 'GBPUSD' symbol was successfully closed
   */
  }

Véase también

Estructura de profundidad de mercado, Estructuras y clases