Справочник по языку программирования MQL5

Подождите немного. Документ загружается.

Стандартные константы, перечисления и структуры

291

MqlDateTime

Структура даты содержит в себе восемь полей типа int.

struct MqlDateTime

{

int year; // год

int mon; // месяц

int day; // день

int hour; // час

int min; // минуты

int sec; // секунды

int day_of_week; // день недели (0-воскресенье, 1-понедельник, ... ,6-суббота)

int day_of_year; // порядковый номер в году (1 января имеет номер 0)

};

Примечание

Порядковый номер в году day_of_year в високосном году, начиная с марта, будет отличаться от

порядкового номера соответствующего дня в невисокосном году.

Пример:

void OnStart()

{

//---

datetime date1=D'2008.03.01';

datetime date2=D'2009.03.01';

MqlDateTime str1,str2;

TimeToStruct(date1,str1);

TimeToStruct(date2,str2);

printf("%02d.%02d.%4d, day of year = %d",str1.day,str1.mon,

str1.year,str1.day_of_year);

printf("%02d.%02d.%4d, day of year = %d",str2.day,str2.mon,

str2.year,str2.day_of_year);

}

/* Результат

01.03.2008, day of year = 60

01.03.2009, day of year = 59

Смотри также

TimeToStruct, Структурыиклассы

Стандартные константы, перечисления и структуры

292

Структура входных параметров индикатора (MqlParam)

Структура MqlParam специально разработана для передачи входных параметров при создании

хэндла технического индикатора с помощью функции IndicatorCreate().

struct MqlParam

{

ENUM_DATATYPE type; // тип входного параметра, значение перечисления ENUM_DATATYPE

long integer_value; // поле для хранения целочисленного значения

double double_value; // поле для хранения значения double или float

string string_value; // поле для хранения значения строкового типа

};

Все входные параметры индикатора передаются в виде массива типа MqlParam, поле type

каждого элемента этого массива указывает тип данных, передаваемых данным элементом. Сами

значения параметров индикатора необходимо предварительно поместить в соответствующие поля

каждого элемента (в integer_value, в double_value или в string_value) в зависимости от того,

какое значение перечисления ENUM_DATATYPE содержится в поле type.

Если функции IndicatorCreate() третьим параметром в качестве типа индикатора передается

значение IND_CUSTOM, то первый элемент массива входных параметров должен иметь поле type

со значением TYPE_STRING из перечисления ENUM_DATATYPE, а поле string_value должно

содержать имя пользовательского индикатора.

Стандартные константы, перечисления и структуры

293

MqlRates

Структура для хранения информации о ценах, объемах и спреде.

struct MqlRates

{

datetime time; // время начала периода

double open; // цена открытия

double high; // наивысшая цена за период

double low; // наименьшая цена за период

double close; // цена закрытия

long tick_volume; // тиковый объем

int spread; // спред

long real_volume; // биржевой объем

};

Пример:

void OnStart()

{

MqlRates rates[];

int copied=CopyRates(NULL,0,0,100,rates);

if(copied<=0)

Print("Ошибка копирования ценовых данных ",GetLastError());

else Print("Скопировано ",ArraySize(rates)," баров");

}

Смотри также

CopyRates, Доступ к таймсериям

Стандартные константы, перечисления и структуры

294

MqlBookInfo

Структура, предоставляющая информацию в стакане цен.

struct MqlBookInfo

{

ENUM_BOOK_TYPE type; // тип заявки из перечисления ENUM_BOOK_TYPE

double price; // цена

long volume; // объем

};

Примечание

Стакан доступен не для всех финансовых инструментов. Чтобы использовать структуру

MqlBookInfo, достаточно просто объявить переменную этого типа, то есть нет необходимости

самому ее объявлять и описывать.

Пример:

MqlBookInfo priceArray[];

bool getBook=MarketBookGet(NULL,priceArray);

if(getBook)

{

int size=ArraySize(priceArray);

Print("MarketBookInfo по ",Symbol());

}

else

{

Print("Не удалось получить содержимое стакана по символу ",Symbol());

}

Смотри также

MarketBookAdd, MarketBookRelease, MarketBookGet, Виды заявок в стакане цен, Типыданных

Стандартные константы, перечисления и структуры

295

Структура торгового запроса (MqlTradeRequest)

Взаимодействие клиентского терминала и торгового сервера для проведения операций постановки

ордеров производится посредством торговых запросов. Запрос представлен специальной

предопределенной структурой MqlTradeRequest, которая содержит все поля, необходимые для

заключения торговых сделок. Результат обработки запроса представлен структурой

MqlTradeResult.

struct MqlTradeRequest

{

ENUM_TRADE_REQUEST_ACTIONS action; // Тип выполняемого действия

ulong magic; // Штамп эксперта (идентификатор magic number)

ulong order; // Тикет ордера

string symbol; // Имя торгового инструмента

double volume; // Запрашиваемый объем сделки в лотах

double price; // Цена

double stoplimit; // Уровень StopLimit ордера

double sl; // Уровень Stop Loss ордера

double tp; // Уровень Take Profit ордера

ulong deviation; // Максимально приемлемое отклонение от запрашиваемой цены

ENUM_ORDER_TYPE type; // Тип ордера

ENUM_ORDER_TYPE_FILLING type_filling; // Тип ордера по исполнению

ENUM_ORDER_TYPE_TIME type_time; // Тип ордера по времени действия

datetime expiration; // Срок истечения ордера (для ордеров типа ORDER_TIME_SPECIFIED)

string comment; // Комментарий к ордеру

};

Описание полей

Поле

Описание

action

Тип торговой операции. Значение может быть

одним из значений перечисления

ENUM_TRADE_REQUEST_ACTIONS

magic

Идентификатор эксперта. Позволяет

организовать аналитическую обработку

торговых ордеров. Каждый эксперт может

выставлять свой собственный уникальный

идентификатор при отправке торгового

запроса

order

Тикет ордера. Требуется для модификации

отложенных ордеров

symbol

Имя торгового инструмента, по которому

выставляется ордер. Не требуется при

операциях модификации ордеров и закрытии

позиций

volume

Запрашиваемый объем сделки в лотах.

Реальное значение объема при открытии

сделки будет зависеть от типа ордера по

исполнению.

Стандартные константы, перечисления и структуры

296

price

Цена, при достижении которой ордер должен

быть исполнен. Для рыночных ордеров по

инструментам с типом исполнения "Market

Execution" (

SYMBOL_TRADE_EXECUTION_MARKET),

имеющих тип TRADE_ACTION_DEAL, указание

цены не требуется

stoplimit

Цена, по которой будет выставлен

отложенный StopLimit ордер, при достижении

ценой значения price (это условие является

обязательным). До этого момента

отложенный ордер в торговую систему не

выводится

Цена, по которой сработает Stop Loss ордер

при движении цены в неблагоприятном

направлении

Цена, по которой сработает Take Profit ордер

при движении цены в благоприятном

направлении

deviation

Максимально приемлемое отклонение от

запрашиваемой цены, задаваемое в пунктах

type

Тип ордера. Значение может быть одним из

значений перечисления ENUM_ORDER_TYPE

type_filling

Тип ордера по исполнению. Значение может

быть одним из значений

ENUM_ORDER_TYPE_FILLING

type_time

Тип ордера по по истечению. Значение может

быть одним из значений

ENUM_ORDER_TYPE_TIME

expiration

Срок истечения отложенного ордера (для

ордеров типа ORDER_TIME_SPECIFIED)

comment

Комментарий к ордеру

Для отправки приказов на совершение торговых операций необходимо использовать функцию

OrderSend(). Для каждой торговой операции необходимо указывать обязательные поля и можно

заполнять опциональные поля. Всего предусмотрено семь вариантов отправки торгового запроса:

Request Execution

Торговый ордер на открытие позиции в режиме Request Execution (режим торговли по запросу

текущих цен). Требуется указание 9 полей:

action

symbol

volume

price

Стандартные константы, перечисления и структуры

297

deviation

type

type_filling

Можно также задать значения полей magic и comment.

Instant Execution

Торговый ордер на открытие позиции в режиме Instant Execution (режим торговли по потоковым

ценам). Требуется указание 9 полей:

action

symbol

volume

price

deviation

type

type_filling

Можно также задать значения полей magic и comment.

Market Execution

Торговый ордер на открытие позиции в режиме Market Execution (режим исполнения торговых

приказов по рынку). Требуется указание 5 полей:

action

symbol

volume

type

type_filling

Можно также задать значения полей magic и comment.

SL & TP Modification

Торговый приказ на модификацию уровней StopLoss и/или TakeProfit. Требуется указание 5

полей:

action

symbol

deviation

Pending Order

Торговый приказ на установку отложенного ордера. Требуется указание 11 полей:

action

symbol

volume

Стандартные константы, перечисления и структуры

298

price

stoplimit

type

type_filling

type_time

expiration

Можно также задать значения полей magic и comment.

Modify Pending Order

Торговый приказ на модификацию уровней цен отложенного ордера. Требуется указание 7

полей:

action

order

price

type_time

expiration

Delete Pending Order

Торговый приказ на удаление отложенного ордера. Требуется указание 2 полей:

action

order

Смотри также

Структуры и классы, Торговые функции, Свойства ордеров

Стандартные константы, перечисления и структуры

299

Структура результатов проверки торгового запроса

(MqlTradeCheckResult)

Прежде чем отправить торговому серверу запрос на торговую операцию, рекомендуется провести

его проверку. Проверка осуществляется функцией OrderCheck(), которой передается сам

проверяемый запрос и переменная типа структуры MqlTradeCheckResult. В эту переменную и будет

записан результат проверки.

struct MqlTradeCheckResult

{

uint retcode; // Код ответа

double balance; // Баланс после совершения сделки

double equity; // Эквити после совершения сделки

double profit; // Плавающая прибыль

double margin; // Маржевые требования

double margin_free; // Свободная маржа

double margin_level; // Уровень маржи

string comment; // Комментарий к коду ответа (описание ошибки)

};

Описание полей

Поле

Описание

retcode

Код возврата

balance

Значение баланса, которое будет после

выполнения торговой операции

equity

Значение собственных средств, которое будет

после выполнения торговой операции

profit

Значение плавающей прибыли, которое будет

после выполнения торговой операции

margin

Размер маржи необходимый для требуемой

торговой операции

margin_free

Размер свободных собственных средств,

которые останутся после выполнения

требуемой торговой операции

margin_level

Уровень маржи, который установится после

выполнения требуемой торговой операции

comment

Комментарий к коду ответа, описание ошибки

Смотри также

Структура торгового запроса, Структура для получения текущих цен, OrderSend, OrderCheck

Стандартные константы, перечисления и структуры

300

Структура результата торгового запроса (MqlTradeResult)

В ответ на торговый запрос постановки ордера в торговую систему, торговый сервер возвращает

данные, содержащие информацию о результате обработки торгового запроса в виде специальной

предопределенной структуры MqlTradeResult.

struct MqlTradeResult

{

uint retcode; // Код результата операции

ulong deal; // Тикет сделки, если она совершена

ulong order; // Тикет ордера, если он выставлен

double volume; // Объем сделки, подтверждённый брокером

double price; // Цена в сделке, подтверждённая брокером

double bid; // Текущая рыночная цена предложения (цены реквота)

double ask; // Текущая рыночная цена спроса (цены реквота)

string comment; // Комментарий брокера к операции (по умолчанию заполняется расшифровкой)

};

Описание полей

Поле

Описание

retcode

Код возврата торгового сервера

deal

Тикет сделки, если она совершена.

Сообщается при торговой операции

TRADE_ACTION_DEAL

order

Тикет ордера, если он выставлен.

Сообщается при торговой операции

TRADE_ACTION_PENDING

volume

Объем сделки, подтверждённый брокером.

Зависит от типа ордера по исполнению

price

Цена в сделке, подтверждённая брокером.

Зависит от поля deviation в торговом запросе

и/или от типа торговой операции

bid

Текущая рыночная цена предложения (цены

реквоты)

ask

Текущая рыночная цена спроса (цены

реквоты)

comment

Комментарий брокера к операции (по

умолчанию заполняется расшифровкой)

Результат торговой операции возвращается в переменную типа MqlTradeResult, которая

передается вторым параметром в функцию OrderSend() для проведения торговых операций.

Пример: