Estructuras del calendario económico

En este apartado se describen las estructuras para trabajar con el Calendario Económico, disponible directamente en la plataforma MetaTrader. El calendario económico es una enciclopedia ya preparada que contiene las descripciones de los más importantes indicadores macroeconómicos, sus fechas de salida y su nivel de importancia. Los valores actuales de los indicadores macroeconímicos llegan a la plataforma MetaTrader justo tras su publicación, y se representan en un gráfico en forma de rótulos: esto permitirá monitorear visualmente los índices necesarios en función del país, la divisa y la importancia.

Las funciones del Calendario Económico permiten analizar de forma automática los eventos entrantes según nuestros propios criterios de importancia, y también en función de los países/divisas requeridos.

Las descripciones de los países de indican con la estructura MqlCalendarCountry. Se usa en las funciones CalendarCountryById() y CalendarCountries()

struct MqlCalendarCountry
  {
   ulong                               id;                    // identificador del país según el estándar ISO 3166-1
   string                              name;                  // nombre de texto del país (en la codificación actual del terminal)
   string                              code;                  // nombre en clave del país ISO 3166-1 alpha-2
   string                              currency;              // código de la divisa del país
   string                              currency_symbol;       // símbolo/signo de la divisa del país
   string                              url_name;              // nombre del país usado en la URL en el sitio web mql5.com
  };

 

Las descripciones de los eventos se indican con la estructura MqlCalendarEvent. Se usa en las funciones CalendarEventById(), CalendarEventByCountry() y CalendarEventByCurrency()

struct MqlCalendarEvent
  {
   ulong                               id;                    // identificador del evento
   ENUM_CALENDAR_EVENT_TYPE            name;                  // tipo de evento de la enumeración ENUM_CALENDAR_EVENT_TYPE
   ENUM_CALENDAR_EVENT_SECTOR          sector;                // sector con el que se relaciona el evento
   ENUM_CALENDAR_EVENT_FREQUENCY       frequency;             // frecuencia (periodicidad) del evento
   ENUM_CALENDAR_EVENT_TIMEMODE        sector;                // modo temporal del evento
   ulong                               country_id;            // identificador del país
   ENUM_CALENDAR_EVENT_UNIT            unit;                  // unidad de medición del valor del indicador económico
   ENUM_CALENDAR_EVENT_IMPORTANCE      importance;            // importancia del evento
   ENUM_CALENDAR_EVENT_MULTIPLIER      multiplier;            // multiplicador del valor del indicador económico
   uint                                digits;                // número de decimales tras la coma
   string                              source_url;            // URL de la fuente donde se publica el evento
   string                              event_code;            // código del evento
   string                              name;                  // nombre de texto del evento en el lenguaje del terminal (en la codificación actual del terminal)
  };

 

Los valores de los eventos se indican con la estructura MqlCalendarValue. Se usa en las funciones CalendarValueById(), CalendarValueHistoryByEvent(), CalendarValueHistory(), CalendarValueLastByEvent() y CalendarValueLast()

struct MqlCalendarValue
  {
   ulong                               id;                    // ID del valor
   ulong                               event_id;              // ID del evento
   datetime                            time;                  // hora y fecha del evento
   datetime                            period;                // periodo de informe del evento
   int                                 revision;              // revisión del indicador publicado con respecto al periodo de informe
   long                                actual_value;          // valor actual del indicador
   long                                prev_value;            // valor anterior del indicador
   long                                revised_prev_value;    // valor anterior revisado del indicador
   long                                forecast_value;        // valor pronosticado del indicador
   ENUM_CALENDAR_EVENT_IMPACT          impact_type;           // influencia potencial en el curso de la divisa
  };

 

La frecuencia (periodicidad) del evento se muestra en la estructura MqlCalendarEvent. Los posibles valores se indican en la numeración ENUM_CALENDAR_EVENT_FREQUENCY

Identificador

Descripción

CALENDAR_FREQUENCY_NONE

La frecuencia de la publicación no ha sido indicada

CALENDAR_FREQUENCY_WEEK

Publicación semanal

CALENDAR_FREQUENCY_MONTH

Publicación mensual

CALENDAR_FREQUENCY_QUARTER

Publicación trimestral

CALENDAR_FREQUENCY_YEAR

Publicación anual

CALENDAR_FREQUENCY_DAY

Publicación diaria

 

El tipo de evento se indica en la estructura MqlCalendarEvent. Los posibles valores se indican en la numeración ENUM_CALENDAR_EVENT_TYPE

Identificador

Descripción

CALENDAR_TYPE_EVENT

Evento (reunión, discurso, etcétera)

CALENDAR_TYPE_INDICATOR

Indicador

CALENDAR_TYPE_HOLIDAY

Festivo

 

El sector de la economía con el que se relaciona el evento se indica en la estructura MqlCalendarEvent. Los posibles valores se indican en la numeración ENUM_CALENDAR_EVENT_SECTOR

Identificador

Descripción

CALENDAR_SECTOR_NONE

El sector no ha sido indicado

CALENDAR_SECTOR_MARKET

Mercado, bolsa

CALENDAR_SECTOR_GDP

Producto interior bruto (PIB)

CALENDAR_SECTOR_JOBS

Mercado laboral

CALENDAR_SECTOR_PRICES

Precios

CALENDAR_SECTOR_MONEY

Dinero

CALENDAR_SECTOR_TRADE

Comercio

CALENDAR_SECTOR_GOVERNMENT

Gobierno

CALENDAR_SECTOR_BUSINESS

Negocios

CALENDAR_SECTOR_CONSUMER

Consumo

CALENDAR_SECTOR_HOUSING

Vivienda

CALENDAR_SECTOR_TAXES

Impuestos

CALENDAR_SECTOR_HOLIDAYS

Festivos

 

La importancia del evento se indica en la estructura MqlCalendarEvent. Los posibles valores se indican en la numeración ENUM_CALENDAR_EVENT_IMPORTANCE

Identificador

Descripción

CALENDAR_IMPORTANCE_NONE

El nivel de importancia no ha sido indicado

CALENDAR_IMPORTANCE_LOW

Baja importancia

CALENDAR_IMPORTANCE_MODERATE

Media importancia

CALENDAR_IMPORTANCE_HIGH

Alta importancia

 

El tipo de la unidad de medición en el que se dan los valores del evento se indica en la estructura MqlCalendarEvent. Los posibles valores se indican en la numeración ENUM_CALENDAR_EVENT_UNIT

Identificador

Descripción

CALENDAR_UNIT_NONE

La unidad de medición no ha sido indicada

CALENDAR_UNIT_PERCENT

Porcentaje

CALENDAR_UNIT_CURRENCY

Divisa nacional

CALENDAR_UNIT_HOUR

Número de horas

CALENDAR_UNIT_JOB

Número de puestos de trabajo

CALENDAR_UNIT_RIG

Plataformas petrolíferas

CALENDAR_UNIT_USD

Dólares USA

CALENDAR_UNIT_PEOPLE

Número de personas

CALENDAR_UNIT_MORTGAGE

Número de créditos hipotecarios

CALENDAR_UNIT_VOTE

Número de votos

CALENDAR_UNIT_BARREL

Número de barriles

CALENDAR_UNIT_CUBICFEET

Número de pies cúbicos

CALENDAR_UNIT_POSITION

Número de puestos de trabajo

CALENDAR_UNIT_BUILDING

Número de construcciones

 

En ciertos casos, los valores del indicador económico necesitan que se indique el multiplicador especificado en la estructura MqlCalendarEvent. Los posibles valores se indican en la numeración ENUM_CALENDAR_EVENT_MULTIPLIER

Identificador

Descripción

CALENDAR_MULTIPLIER_NONE

El multiplicador no ha sido indicado

CALENDAR_MULTIPLIER_THOUSANDS

Miles

CALENDAR_MULTIPLIER_MILLIONS

Millones

CALENDAR_MULTIPLIER_BILLIONS

Miles de millones

CALENDAR_MULTIPLIER_TRILLIONS

Billones

 

La influencia potencial de un evento en el curso de la divisa nacional se indica en la estructura MqlCalendarValue. Los posibles valores se indican en la numeración ENUM_CALENDAR_EVENT_IMPACT

Identificador

Descripción

CALENDAR_IMPACT_NA

La influencia no ha sido indicada

CALENDAR_IMPACT_POSITIVE

Influencia positiva

CALENDAR_IMPACT_NEGATIVE

Influencia negativa

 

La hora del evento se indica en la estructura MqlCalendarEvent. Los posibles valores se indican en la numeración ENUM_CALENDAR_EVENT_TIMEMODE

Identificador

Descripción

CALENDAR_TIMEMODE_DATETIME

La fuente publica la hora exacta del evento

CALENDAR_TIMEMODE_DATE

El evento ocupa el día completo

CALENDAR_TIMEMODE_NOTIME

La fuente no publica la hora del evento

CALENDAR_TIMEMODE_TENTATIVE

La fuente no publica de antemano la hora exacta del evento, solo el día. La hora se concreta cuando tiene lugar el evento

 

Ver también

Calendario económico