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

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

Торговые функции

621

OrderSend

Функция OrderSend() предназначена для совершения торговых операций через отправку запросов

на торговый сервер.

bool OrderSend(

MqlTradeRequest& request, // структура запроса

MqlTradeResult&  result  // структура ответа

);

Параметры

request

[in] Указатель на структуру типа MqlTradeRequest, описывающую торговое действие клиента.

result

[in,out] Указатель на структуру типа MqlTradeResult, описывающую результат торговой

операции в случае успешного выполнения (возврата true).

Возвращаемое значение

В случае успешной базовой проверки структур (проверка указателей) возвращается true - это не

свидетельствует об успешном выполнении торговой операции. Для получения более

подробного описания результата выполнения функции следует анализировать поля структуры

result.

Примечание

Торговый запрос проходит несколько стадий проверок на торговом сервере. В первую очередь

проверяется корректность заполнения всех необходимых полей параметра request, и при

отсутствии ошибок сервер принимает ордер для дальнейшей обработки. При успешном принятии

ордера торговым сервером функция OrderSend() возвращает значение true.

Рекомендуется самостоятельно проверить запрос перед отправкой его торговому серверу. Для

проверки запроса существует функция OrderCheck(), которая не только проверит достаточность

средств для совершения торговой операции, но и вернет в результатах проверки торгового

запроса многие другие полезные параметры:

код возврата, который сообщит об ошибке в проверяемом запросе;

значение баланса, которое будет после выполнения торговой операции;

значение собственных средств, которое будет после выполнения торговой операции;

значение плавающей прибыли, которое будет после выполнения торговой операции;

размер маржи, необходимый для требуемой торговой операции;

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

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

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

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

Следует иметь в виду при выставлении рыночного ордера, что успешное окончание работы

метода OrderSend() не всегда означает успешное совершение сделки. Необходимо проверять в

возвращаемой структуре результата result значение retcode, содержащее код возврата

торгового сервера, а также значение полей deal или order в зависимости от типа операции.

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

Торговые функции

622

не наступит одно из условий для его исполнения:

истечение срока действия,

появление встречного запроса,

срабатывание ордера при поступлении цены исполнения,

поступление запроса на отмену ордера.

В момент обработки ордера торговый сервер посылает терминалу сообщение о наступлении

торгового события Trade, которое можно обработать функцией OnTrade().

Пример:

//--- значения для ORDER_MAGIC

input long order_magic=55555;

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

//| Script program start function |

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

void OnStart()

{

//--- убедимся,что счет является учебным

if(AccountInfoInteger(ACCOUNT_TRADE_MODE)==ACCOUNT_TRADE_MODE_REAL)

{

Alert("Работа скрипта на реальном счете запрещена!");

return;

}

//--- установим либо удалим ордер

if(GetOrdersTotalByMagic(order_magic)==0)

{

//--- текущих ордеров нет - установим ордер

int res=SendRandomPendingOrder(order_magic);

Print("Код возврата торгового сервера ",res);

}

else // ордера есть - удалим ордера

{

DeleteAllOrdersByMagic(order_magic);

}

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

//| получить текущее количество ордеров с указанным ORDER_MAGIC |

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

int GetOrdersTotalByMagic(long const magic_number)

{

long order_ticket;

int total=0;

//--- сделаем выборку всей торговой истории

HistorySelect(0,TimeCurrent());

//--- пройдем по всем отложенным ордерам

for(int i=0;i<OrdersTotal();i++)

if(order_ticket=OrderGetTicket(i))

if(magic_number==OrderGetInteger(ORDER_MAGIC)) total++;

Торговые функции

623

//---

return(total);

}

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

//| удалаяет все отложенные ордера с указанным ORDER_MAGIC |

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

void DeleteAllOrdersByMagic(long const magic_number)

{

long order_ticket;

int total=0;

//--- сделаем выборку всей торговой истории

HistorySelect(0,TimeCurrent());

//--- пройдем по всем отложенным ордерам

for(int i=OrdersTotal()-1;i>=0;i--)

if(order_ticket=OrderGetTicket(i))

//--- ордер с подходящим ORDER_MAGIC

if(magic_number==OrderGetInteger(ORDER_MAGIC))

{

MqlTradeResult result;

MqlTradeRequest request;

request.order=order_ticket;

request.action=TRADE_ACTION_REMOVE;

OrderSend(request,result);

//--- выведем в лог ответ сервера

Print(__FUNCTION__,": ",result.comment," код ответа ",result.retcode);

}

//---

}

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

//| установить случайным образом отложенный ордер |

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

int SendRandomPendingOrder(long const magic_number)

{

//--- готовим запрос

MqlTradeRequest request;

request.action=TRADE_ACTION_PENDING; // установка отложенного ордера

request.magic=magic_number; // ORDER_MAGIC

request.symbol=_Symbol; // инструмент

request.volume=0.1; // объем в 0.1 лот

request.sl=0; // Stop Loss не указан

request.tp=0; // Take Profit не указан

request.deviation=5; // отклонение в 5 пунктов

//--- сформируем тип ордера

request.type=GetRandomType(); // тип ордера

//---сформируем цену для отложенного ордера

request.price=GetRandomPrice(request.type); // цена для открытия

//--- отправим торговый приказ

MqlTradeResult result;

Торговые функции

624

OrderSend(request,result);

//--- выведем в лог ответ сервера

Print(__FUNCTION__,":",result.comment);

if(result.retcode==10016) Print(result.bid,result.ask,result.price);

//--- вернем код ответа торгового сервера

return result.retcode;

}

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

//| получить случайным образом тип отложенного типа |

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

ENUM_ORDER_TYPE GetRandomType()

{

int t=MathRand()%4;

//--- 0<=t<4

switch(t)

{

case(0):return(ORDER_TYPE_BUY_LIMIT);

case(1):return(ORDER_TYPE_SELL_LIMIT);

case(2):return(ORDER_TYPE_BUY_STOP);

case(3):return(ORDER_TYPE_SELL_STOP);

}

//--- недопустимое значение

return(WRONG_VALUE);

//---

}

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

//| получить цену случайным образом |

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

double GetRandomPrice(ENUM_ORDER_TYPE type)

{

int t=(int)type;

//--- уровень стопов по символу

int distance=(int)SymbolInfoInteger(_Symbol,SYMBOL_TRADE_STOPS_LEVEL);

//--- получим данные последнего тика

MqlTick last_tick;

SymbolInfoTick(_Symbol,last_tick);

//--- вычислим цену в соответствие с типом

double price;

if(t==2 || t==5) // ORDER_TYPE_BUY_LIMIT или ORDER_TYPE_SELL_STOP

{

price=last_tick.bid; // оттолкнемся от цены Bid

price=price-(distance+(MathRand()%10)*5)*_Point;

}

else // ORDER_TYPE_SELL_LIMIT или ORDER_TYPE_BUY_STOP

{

price=last_tick.ask; // оттолкнемся от цены Ask

price=price+(distance+(MathRand()%10)*5)*_Point;

}

Торговые функции

625

return(price);

}

Смотри также

Типы торговых операций, Структура торгового запроса, Структура результатов проверки

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

Торговые функции

626

PositionsTotal

Возвращает количество открытых позиций.

int PositionsTotal();

Возвращаемое значение

Значение типа int.

Примечание

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

которая является результатом одной или более сделок. Не следует путать между собой позиции

и действующие отложенные ордера, которые также отображаются на вкладке "Торговля" в

панели "Инструменты".

Общее количество позиций на торговом счете не может превышать общего количества

финансовых инструментов.

Смотри также

PositionGetSymbol(), PositionSelect(), Свойства позиций

Торговые функции

627

PositionGetSymbol

Возвращает символ соответствующей открытой позиции и автоматически выбирает позицию для

дальнейшей работы с ней при помощи функций PositionGetDouble, PositionGetInteger,

PositionGetString.

string PositionGetSymbol(

int index // номер в списке позиций

);

Параметры

index

[in] Номер позиции в списке открытых позиций.

Возвращаемое значение

Значение типа string. Если позиция не найдена, то вернется пустая строка. Для получения кода

ошибки нужно вызвать функцию GetLastError().

Примечание

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

которая является результатом одной или более сделок. Не следует путать между собой позиции

и действующие отложенные ордера, которые также отображаются на вкладке "Торговля" в

панели "Инструменты".

Общее количество позиций на торговом счете не может превышать общего количества

финансовых инструментов.

Смотри также

PositionsTotal(), PositionSelect(), Свойства позиций

Торговые функции

628

PositionSelect

Выбирает открытую позицию для дальнейшей работы с ней. Возвращает true при успешном

завершении функции. Возвращает false при неудачном завершении функции. Чтобы получить

информацию об ошибке, необходимо вызвать функцию GetLastError().

bool PositionSelect(

string symbol // имя инструмента

);

Параметры

symbol

[in] Наименование финансового инструмента.

Возвращаемое значение

Значение типа bool.

Примечание

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

которая является результатом одной или нескольких сделок. Не следует путать между собой

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

"Торговля" в панели "Инструменты" клиентского терминала.

Функция PositionSelect() копирует данные о позиции в программное окружение, и последующие

вызовы PositionGetDouble(), PositionGetInteger() и PositionGetString() возвращают ранее

скопированные данные. Это означает, что самой позиции может уже и не быть (или же она

изменилась по объему, направлению и т.д.), а данные этой позиции можно еще получать. Для

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

PositionSelect() непосредственно перед обращением за ними.

Смотри также

PositionGetSymbol(), PositionsTotal(), Свойства позиций

Торговые функции

629

PositionGetDouble

Функция возвращает запрошенное свойство открытой позиции, предварительно выбранной при

помощи функции PositionGetSymbol или PositionSelect. Свойство позиции должно быть типа double.

Существует 2 варианта функции.

1. Непосредственно возвращает значение свойства.

double PositionGetDouble(

ENUM_POSITION_PROPERTY_DOUBLE property_id // идентификатор свойства

);

2. Возвращает true или false в зависимости от успешности выполнения функции. В случае успеха

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

параметром.

bool PositionGetDouble(

ENUM_POSITION_PROPERTY_DOUBLE property_id, // идентификатор свойства

double& double_var // сюда примем значение свойства

);

Параметры

property_id

[in] Идентификатор свойства позиции. Значение может быть одним из значений перечисления

ENUM_POSITION_PROPERTY_DOUBLE.

double_var

[out] Переменная типа double, принимающая значение запрашиваемого свойства.

Возвращаемое значение

Значение типа double. В случае неудачного выполнения возвращает 0.

Примечание

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

которая является результатом одной или нескольких сделок. Не следует путать между собой

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

"Торговля" в панели "Инструменты" клиентского терминала.

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

PositionSelect() непосредственно перед обращением за ними.

Смотри также

PositionGetSymbol(), PositionSelect(), Свойства позиций

Торговые функции

630

PositionGetInteger

Функция возвращает запрошенное свойство открытой позиции, предварительно выбранной при

помощи функции PositionGetSymbol или PositionSelect. Свойство позиции должно быть типа

datetime, int. Существует 2 варианта функции.

1. Непосредственно возвращает значение свойства.

long PositionGetInteger(

ENUM_POSITION_PROPERTY_INTEGER property_id // идентификатор свойства

);

2. Возвращает true или false в зависимости от успешности выполнения функции. В случае успеха

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

параметром.

bool PositionGetInteger(

ENUM_POSITION_PROPERTY_INTEGER property_id, // идентификатор свойства

long& long_var // сюда примем значение свойства

);

Параметры

property_id

[in] Идентификатор свойства позиции. Значение может быть одним из значений перечисления

ENUM_POSITION_PROPERTY_INTEGER.

long_var

[out] Переменная типа long, принимающая значение запрашиваемого свойства.

Возвращаемое значение

Значение типа long. В случае неудачного выполнения возвращает 0.

Примечание

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

которая является результатом одной или нескольких сделок. Не следует путать между собой

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

"Торговля" в панели "Инструменты" клиентского терминала.

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

PositionSelect() непосредственно перед обращением за ними.

Смотри также

PositionGetSymbol(), PositionSelect(), Свойства позиций