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

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

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

251

SYMBOL_TRADE_TICK_SIZE

Минимальное изменение

цены

double

SYMBOL_TRADE_CONTRACT_SI

Размер торгового контракта

double

SYMBOL_VOLUME_MIN

Минимальный объем для

заключения сделки

double

SYMBOL_VOLUME_MAX

Максимальный объем для

заключения сделки

double

SYMBOL_VOLUME_STEP

Минимальный шаг изменения

объема для заключения

сделки

double

SYMBOL_VOLUME_LIMIT

Максимально допустимый

совокупный объем открытой

позиции и отложенных

ордеров (вне зависимости от

направления) на одном

символе

double

SYMBOL_SWAP_LONG

Значение свопа в покупку

double

SYMBOL_SWAP_SHORT

Значение свопа в продажу

double

SYMBOL_MARGIN_INITIAL

Начальная (инициирующая)

маржа обозначает размер

необходимых залоговых

средств в маржинальной

валюте для открытия позиции

объемом в один лот.

Используется при проверке

средств клиента при входе в

рынок.

double

SYMBOL_MARGIN_MAINTENANC

Поддерживающая маржа по

инструменту. В случае если

задана – указывает размер

маржи в маржинальной

валюте инструмента,

удерживаемой с одного лота.

Используется при проверке

средств клиента при

изменении состояния счета

клиента. Если

поддерживающая маржа

равна 0, то используется

начальная маржа.

double

SYMBOL_MARGIN_LONG

Коэффициент взимания

маржи по длинным позициям

double

SYMBOL_MARGIN_SHORT

Коэффициент взимания

маржи по коротким позициям

double

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

252

SYMBOL_MARGIN_LIMIT

Коэффициент взимания

маржи по Limit ордерам

double

SYMBOL_MARGIN_STOP

Коэффициент взимания

маржи по Stop ордерам

double

SYMBOL_MARGIN_STOPLIMIT

Коэффициент взимания

маржи по Stop Limit ордерам

double

Для функции SymbolInfoString()

ENUM_SYMBOL_INFO_STRING

Идентификатор

Описание

Тип свойства

SYMBOL_CURRENCY_BASE

Базовая валюта инструмента

string

SYMBOL_CURRENCY_PROFIT

Валюта прибыли

string

SYMBOL_CURRENCY_MARGIN

Валюта в которой

вычисляется залоговые

средства

string

SYMBOL_BANK

Источник текущей котировки

string

SYMBOL_DESCRIPTION

Строковое описание символа

string

SYMBOL_PATH

Путь в дереве символов

string

Для каждого финансового инструмента могут быть указаны несколько режимов срока действия

(истечения) отложенных ордеров. Каждому режиму сопоставлен флаг, флаги могут

комбинироваться операцией логического ИЛИ (|), например, SYMBOL_EXPIRATION_GTC|

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

инструмента, необходимо результат логического И (&) сравнить с флагом режима.

Если для символа указан флаг SYMBOL_EXPIRATION_SRECIFIED, то при отправке отложенного

ордера можно конкретно указать, до какого момента действует данный отложенный ордер.

Идентификатор

Значение

Описание

SYMBOL_EXPIRATION_GTC

Ордер действителен

неограниченно по времени до

явной его отмены

SYMBOL_EXPIRATION_DAY

Ордер действителен до конца

дня

SYMBOL_EXPIRATION_SRECIFIE

Срок истечения указывается

в ордере

Пример:

//+------------------------------------------------------------------+

//| проверяет разрешенность указанного режима экспирации |

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

253

//+------------------------------------------------------------------+

bool IsExpirationTypeAllowed(string symbol,int exp_type)

{

//--- получим значение свойства, описывающего допустимые режимы истечения срока действия

int expiration=(int)SymbolInfoInteger(symbol,SYMBOL_EXPIRATION_MODE);

//--- вернем true, если режим exp_type разрешен

return((expiration&exp_type)==exp_type);

}

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

объема. Допустимые варианты исполнения ордера по объему для каждого символа указаны

таблице. Для каждого инструмента может быть установлен не один режим, а несколько через

комбинацию флагов. Комбинация флагов выражается операцией логического ИЛИ (|), например,

SYMBOL_FILLING_ALL_OR_NONE|SYMBOL_CANCEL_REMAIND. Чтобы проверить разрешенность

конкретного режима для инструмента, необходимо результат логического И (&) сравнить с

флагом режима.

Идентификатор

Значение

Описание

SYMBOL_FILLING_ALL_OR_NON

Указано "Все или ничего",

если необходимый объем в

ордере по указанной цене не

набирается, то ордер

отменяется и сделка не

проводится

SYMBOL_CANCEL_REMAIND

Если по указанной в ордере

цене сделку можно заполнить

только частично, то

совершается сделка на

доступный объем. Остаток по

ордеру снимается, новый

ордер не выставляется

SYMBOL_RETURN_REMAIND

Совершается сделка по

указанной в заявке цене в

пределах доступного объема.

На остаток от заполнения

выставляется новый ордер по

той же цене

Пример:

//+------------------------------------------------------------------+

//| проверяет разрешенность указанного режима заполнения |

//+------------------------------------------------------------------+

bool IsFiilingTypeAllowed(string symbol,int fill_type)

{

//--- получим значение свойства, описывающего режим заполнения

int filling=(int)SymbolInfoInteger(symbol,SYMBOL_FILLING_MODE);

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

254

//--- вернем true, если режим fill_type разрешен

return((filling&fill_type)==fill_type);

}

Для получения информации о способе вычисления величины залоговых средств по инструменту

(размера маржинальных требований) предназначено перечисление ENUM_SYMBOL_CALC_MODE.

ENUM_SYMBOL_CALC_MODE

Идентификатор

Описание

Формула

SYMBOL_CALC_MODE_FOREX

Forex mode – расчет прибыли

и маржи для Форекс

Margin: Lots*Contract_Size/

Leverage

Profit: (close_price-

open_price)

*Contract_Size*Lots

SYMBOL_CALC_MODE_FUTURE

Futures mode – расчет залога

и прибыли для фьючерсов

Margin: Lots

*InitialMargin*Percentage/100

Profit: (close_price-

open_price)*TickPrice/

TickSize*Lots

SYMBOL_CALC_MODE_CFD

CFD mode – расчет залога и

прибыли для CFD

Margin: Lots

*ContractSize*MarketPrice*Per

centage/100

Profit: (close_price-

open_price)

*Contract_Size*Lots

SYMBOL_CALC_MODE_CFDINDE

CFD index mode – расчет

залога и прибыли для CFD на

индексы

Margin:

(Lots*ContractSize*MarketPric

e)*TickPrice/TickSize

Profit: (close_price-

open_price)

*Contract_Size*Lots

SYMBOL_CALC_MODE_CFDLEVE

RAGE

CFD Leverage mode – расчет

залога и прибыли для CFD

при торговле с плечом

Margin:

(Lots*ContractSize*MarketPric

e*Percentage)/Leverage

Profit: (close_price-

open_price)

*Contract_Size*Lots

Существует несколько режимов торговли по финансовым инструментам. Информация о режимах

торговли по конкретному инструменту отображена в значениях перечисления

ENUM_SYMBOL_TRADE_MODE.

ENUM_SYMBOL_TRADE_MODE

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

255

Идентификатор

Описание

SYMBOL_TRADE_MODE_DISABLED

Торговля по символу запрещена

SYMBOL_TRADE_MODE_LONGONLY

Разрешены только покупки

SYMBOL_TRADE_MODE_SHORTONLY

Разрешены только продажи

SYMBOL_TRADE_MODE_CLOSEONLY

Разрешены только операции закрытия

позиций

SYMBOL_TRADE_MODE_FULL

Нет ограничений на торговые операции

Возможные режимы заключения сделок по конкретному инструменту определены в перечислении

ENUM_SYMBOL_TRADE_EXECUTION.

ENUM_SYMBOL_TRADE_EXECUTION

Идентификатор

Описание

SYMBOL_TRADE_EXECUTION_REQUEST

Торговля по запросу

SYMBOL_TRADE_EXECUTION_INSTANT

Торговля по потоковым ценам

SYMBOL_TRADE_EXECUTION_MARKET

Исполнение ордеров по рынку

Способы начисления свопов при переносе позиции указаны в перечислении

ENUM_SYMBOL_SWAP_MODE.

ENUM_SYMBOL_SWAP_MODE

Идентификатор

Описание

SYMBOL_SWAP_MODE_DISABLED

Нет свопов

SYMBOL_SWAP_MODE_BY_POINTS

Свопы начисляются в пунктах

SYMBOL_SWAP_MODE_BY_MONEY

Свопы начисляются в деньгах, размер свопа

в свойствах символа указан в валюте

депозита клиента.

SYMBOL_SWAP_MODE_BY_INTEREST

Свопы начисляются в годовых процентах

(банковский режим – 360 дней в году)

SYMBOL_SWAP_MODE_BY_MARGIN_CURRENCY

Свопы начисляются в деньгах, размер свопа

в свойствах символа указан в маржинальной

валюте символа.

Для указания дня недели предназначены значения перечисления ENUM_DAY_OF_WEEK.

ENUM_DAY_OF_WEEK

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

256

Идентификатор

Описание

SUNDAY

Воскресенье

MONDAY

Понедельник

TUESDAY

Вторник

WEDNESDAY

Среда

THURSDAY

Четверг

FRIDAY

Пятница

SATURDAY

Суббота

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

257

Информация о счете

Для получения информации о текущем счете предназначены функции AccountInfoInteger(),

AccountInfoDouble() и AccountInfoString(). В качестве параметра эти функции принимают значения

из соответствующих перечислений ENUM_ACCOUNT_INFO.

Для функции AccountInfoInteger()

ENUM_ACCOUNT_INFO_INTEGER

Идентификатор

Описание

Тип свойства

ACCOUNT_LOGIN

Номер счета

long

ACCOUNT_TRADE_MODE

Тип торгового счета

ENUM_ACCOUNT_TRADE_MODE

ACCOUNT_LEVERAGE

Размер предоставленного

плеча

long

ACCOUNT_LIMIT_ORDERS

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

количество действующих

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

int

ACCOUNT_MARGIN_SO_MODE

Режим задания минимально

допустимого уровня

залоговых средств

ENUM_ACCOUNT_STOPOUT_MO

ACCOUNT_TRADE_ALLOWED

Разрешенность торговли для

текущего счета

bool

ACCOUNT_TRADE_EXPERT

Разрешенность торговли для

эксперта

bool

Для функции AccountInfoDouble()

ENUM_ACCOUNT_INFO_DOUBLE

Идентификатор

Описание

Тип свойства

ACCOUNT_BALANCE

Баланс счета в валюте

депозита

double

ACCOUNT_CREDIT

Размер предоставленного

кредита в валюте депозита

double

ACCOUNT_PROFIT

Размер текущей прибыли на

счете в валюте депозита

double

ACCOUNT_EQUITY

Значение собственных

средств на счете в валюте

депозита

double

ACCOUNT_MARGIN

Размер зарезервированных

залоговых средств на счете

в валюте депозита

double

ACCOUNT_FREEMARGIN

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

double

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

258

счете в валюте депозита,

доступных для открытия

позиции

ACCOUNT_MARGIN_LEVEL

Уровень залоговых средств

на счете в процентах

double

ACCOUNT_MARGIN_SO_CALL

Уровень залоговых средств,

при котором требуется

пополнение счета (Margin

Call). В зависимости от

установленного

ACCOUNT_MARGIN_SO_MODE

выражается в процентах

либо в валюте депозита

double

ACCOUNT_MARGIN_SO_SO

Уровень залоговых средств,

при достижении которого

происходит принудительное

закрытие самой убыточной

позиции (Stop Out). В

зависимости от

установленного

ACCOUNT_MARGIN_SO_MODE

выражается в процентах

либо в валюте депозита

double

Для функции AccountInfoString()

ENUM_ACCOUNT_INFO_STRING

Идентификатор

Описание

Тип свойства

ACCOUNT_NAME

Имя клиента

string

ACCOUNT_SERVER

Имя торгового сервера

string

ACCOUNT_CURRENCY

Валюта депозита

string

ACCOUNT_COMPANY

Имя компании,

обслуживающей счет

string

ENUM_ACCOUNT_TRADE_MODE

Идентификатор

Описание

ACCOUNT_TRADE_MODE_DEMO

Демонстрационный торговый счет

ACCOUNT_TRADE_MODE_CONTEST

Конкурсный торговый счет

ACCOUNT_TRADE_MODE_REAL

Реальный торговый счет

ENUM_ACCOUNT_STOPOUT_MODE

Идентификатор

Описание

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

259

ACCOUNT_STOPOUT_MODE_PERCENT

Уровень задается в процентах

ACCOUNT_STOPOUT_MODE_MONEY

Уровень задается в деньгах

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

260

Статистика тестирования

После окончания тестирования вычисляются статистические показатели результатов торговли по

множеству параметров. Значения показателей можно получить с помощью функции

TesterStatistics(), указав идентификатор показателя из перечисления ENUM_STATISTICS.

Хотя при вычислении статистики используются показатели двух типов - int и double - функция

возвращает все значения в виде double. Все статистические величины, имеющие тип double, по

умолчанию выражаются в валюте депозита, если не сказано иное.

ENUM_STATISTICS

Идентификатор

Описание статистического

показателя

Тип

STAT_INITIAL_DEPOSIT

Значение начального

депозита

double

STAT_WITHDRAWAL

Количество выведенных со

счета средств

double

STAT_PROFIT

Чистая прибыль по окончании

тестирования, сумма

STAT_GROSS_PROFIT и

STAT_GROSS_LOSS

(STAT_GROSS_LOSS всегда

меньше или равно нулю)

double

STAT_GROSS_PROFIT

Общая прибыль, сумма всех

прибыльных

(положительных) трейдов.

Значение больше или равно

нулю

double

STAT_GROSS_LOSS

Общий убыток, сумма всех

убыточных (отрицательных)

трейдов. Значение меньше

или равно нулю

double

STAT_MAX_PROFITTRADE

Максимальная прибыль –

наибольшее значение среди

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

Значение больше или равно

нулю

double

STAT_MAX_LOSSTRADE

Максимальный убыток –

наименьшее значение среди

всех убыточных трейдов.

Значение меньше или равно

нулю

double

STAT_CONPROFITMAX

Максимальная прибыль в

последовательности

прибыльных трейдов.

Значение больше или равно

double