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

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

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

641

void OnStart()

{

color BuyColor =clrBlue;

color SellColor=clrRed;

//--- request trade history

HistorySelect(0,TimeCurrent());

//--- create objects

string name;

uint total=HistoryDealsTotal();

ulong ticket=0;

double price;

double profit;

datetime time;

string symbol;

long type;

long entry;

//--- for all deals

for(uint i=0;i<total;i++)

{

//--- try to get deals ticket

if(ticket=HistoryDealGetTicket(i))

{

//--- get deals properties

price =HistoryDealGetDouble(ticket,DEAL_PRICE);

time =HistoryDealGetInteger(ticket,DEAL_TIME);

symbol=HistoryDealGetString(ticket,DEAL_SYMBOL);

type =HistoryDealGetInteger(ticket,DEAL_TYPE);

entry =HistoryDealGetInteger(ticket,DEAL_ENTRY);

profit=HistoryDealGetDouble(ticket,DEAL_PROFIT);

//--- only for current symbol

if(price && time && symbol==Symbol())

{

//--- create price object

name="TradeHistory_Deal_"+string(ticket);

if(entry) ObjectCreate(0,name,OBJ_ARROW_RIGHT_PRICE,0,time,price,0,0);

else ObjectCreate(0,name,OBJ_ARROW_LEFT_PRICE,0,time,price,0,0);

//--- set object properties

ObjectSetInteger(0,name,OBJPROP_SELECTABLE,0);

ObjectSetInteger(0,name,OBJPROP_BACK,0);

ObjectSetInteger(0,name,OBJPROP_COLOR,type?BuyColor:SellColor);

if(profit!=0) ObjectSetString(0,name,OBJPROP_TEXT,"Profit: "+string(profit));

}

//--- apply on chart

ChartRedraw();

}

Смотри также

HistoryOrderSelect(), HistoryDealSelect()

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

642

HistorySelectByPosition

Запрашивает историю сделок и ордеров, имеющих указанный идентификатор позиции.

bool HistorySelectByPosition(

long  position_id // идентификатор позиции - POSITION_IDENTIFIER

);

Параметры

position_id

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

каждой сделке.

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

Возвращает true в случае успеха, иначе false.

Примечание

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

которые отображаются на вкладке "Торговля" в панели "Инструменты". Список ордеров,

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

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

Функция HistorySelectByPosition() создает в mql5-программе список ордеров и список сделок с

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

посредством соответствующих функций. Размер списка сделок можно узнать с помощью

функции HistoryDealsTotal(), размер списка ордеров в истории можно получить с

HistoryOrdersTotal(). Перебор элементов списка ордеров лучше всего проводить функцией

HistoryOrderGetTicket(), для элементов списка сделок соответственно подходит функция

HistoryDealGetTicket().

После применения функции HistoryOrderSelect() список ордеров в истории, доступных mql5-

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

тикету завершился успешно. То же самое относится к списку сделок, доступных mql5-программе

– он сбрасывается функцией HistoryDealSelect() и заполняется заново в случае успешного

получения сделки по номеру тикета.

Смотри также

HistorySelect(), HistoryOrderGetTicket(), Свойства ордеров

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

643

HistoryOrderSelect

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

Возвращает true при успешном завершении функции. Возвращает false при неудачном завершении

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

bool HistoryOrderSelect(

ulong ticket // тикет ордера

);

Параметры

ticket

[in] Тикет ордера

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

Возвращает true в случае успеха, иначе false.

Примечание

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

которые отображаются на вкладке "Торговля" в панели "Инструменты". Список ордеров,

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

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

Функция HistoryOrderSelect() очищает в mql5-программе список ордеров из истории, доступных

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

HistoryOrderSelect() завершилось успешно. Если необходимо перебрать все сделки, выбранные

функцией HistorySelect(), то лучше использовать функцию HistoryOrderGetTicket().

Смотри также

HistorySelect(), HistoryOrderGetTicket(), Свойства ордеров

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

644

HistoryOrdersTotal

Возвращает количество ордеров в истории. Перед вызовом функции HistoryOrdersTotal()

необходимо получить историю сделок и ордеров с помощью функции HistorySelect() или

HistorySelectByPosition().

int HistoryOrdersTotal();

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

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

Примечание

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

которые отображаются на вкладке "Торговля" в панели "Инструменты". Список ордеров,

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

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

Смотри также

HistorySelect(), HistoryOrderSelect(), HistoryOrderGetTicket(), Свойства ордеров

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

645

HistoryOrderGetTicket

Возвращает тикет соответствующего ордера в истории. Перед вызовом функции

HistoryOrderGetTicket() необходимо получить историю сделок и ордеров с помощью функции

HistorySelect() или HistorySelectByPosition().

ulong HistoryOrderGetTicket(

int index // номер в списке ордеров

);

Параметры

index

[in] Номер ордера в списке ордеров.

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

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

Примечание

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

которые отображаются на вкладке "Торговля" в панели "Инструменты". Список ордеров,

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

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

Пример:

void OnStart()

{

datetime from=0;

datetime to=TimeCurrent();

//--- запросить всю историю

HistorySelect(from,to);

//--- переменные для получения значений из свойств ордера

ulong ticket;

double open_price;

double initial_volume;

datetime time_setup;

datetime time_done;

string symbol;

string type;

long order_magic;

long positionID;

//--- количество текущих отложенных ордеров

uint total=HistoryOrdersTotal();

//--- пройдем в цикле по всем ордерам

for(uint i=0;i<total;i++)

{

//--- получим тикет ордера по его позиции в списке

if(ticket=HistoryOrderGetTicket(i))

{

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

646

//--- получим свойства ордера

open_price= HistoryOrderGetDouble(ticket,ORDER_PRICE_OPEN);

time_setup= HistoryOrderGetInteger(ticket,ORDER_TIME_SETUP);

time_done= HistoryOrderGetInteger(ticket,ORDER_TIME_DONE);

symbol= HistoryOrderGetString(ticket,ORDER_SYMBOL);

order_magic= HistoryOrderGetInteger(ticket,ORDER_MAGIC);

positionID = HistoryOrderGetInteger(ticket,ORDER_POSITION_ID);

initial_volume= HistoryOrderGetDouble(ticket,ORDER_VOLUME_INITIAL);

type=GetOrderType(HistoryOrderGetInteger(ticket,ORDER_TYPE));

//--- подготовим и выведм информацию об ордере

printf("#ticket %d %s %G %s at %G was set up at %s => done at %s, pos ID=%d",

ticket, // тикет ордера

type, // тип

initial_volume, // выставленный объем

symbol, // символ, по которому выставили

open_price, // указанная цена открытия

TimeToString(time_setup),// время установки ордера

TimeToString(time_done), // время исполнения илм удаления

positionID // ID позиции, в которую влилась сделка по ордеру

);

}

//---

}

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

//| возвращает строковое наименование типа ордера |

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

string GetOrderType(long type)

{

string str_type="unknown operation";

switch(type)

{

case (ORDER_TYPE_BUY): return("buy");

case (ORDER_TYPE_SELL): return("sell");

case (ORDER_TYPE_BUY_LIMIT): return("buy limit");

case (ORDER_TYPE_SELL_LIMIT): return("sell limit");

case (ORDER_TYPE_BUY_STOP): return("buy stop");

case (ORDER_TYPE_SELL_STOP): return("sell stop");

case (ORDER_TYPE_BUY_STOP_LIMIT): return("buy stop limit");

case (ORDER_TYPE_SELL_STOP_LIMIT):return("sell stop limit");

}

return(str_type);

}

Смотри также

HistorySelect(), HistoryOrdersTotal(), HistoryOrderSelect(), Свойства ордеров

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

647

HistoryOrderGetDouble

Возвращает запрошенное свойство ордера. Свойство ордера должно быть типа double. Существует

2 варианта функции.

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

double HistoryOrderGetDouble(

ulong ticket_number, // тикет

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

);

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

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

параметром.

bool HistoryOrderGetDouble(

ulong ticket_number, // тикет

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

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

);

Параметры

ticket_number

[in] Тикет ордера.

property_id

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

ENUM_ORDER_PROPERTY_DOUBLE.

double_var

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

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

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

Примечание

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

которые отображаются на вкладке "Торговля" в панели "Инструменты". Список ордеров,

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

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

Смотри также

HistorySelect(), HistoryOrdersTotal(), HistoryOrderSelect(), Свойства ордеров

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

648

HistoryOrderGetInteger

Возвращает запрошенное свойство ордера. Свойство ордера должно быть типа datetime, int.

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

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

long HistoryOrderGetInteger(

ulong ticket_number, // тикет

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

);

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

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

параметром.

bool HistoryOrderGetInteger(

ulong ticket_number, // тикет

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

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

);

Параметры

ticket_number

[in] Тикет ордера.

property_id

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

ENUM_ORDER_PROPERTY_INTEGER.

long_var

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

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

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

Примечание

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

которые отображаются на вкладке "Торговля" в панели "Инструменты". Список ордеров,

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

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

Смотри также

HistorySelect(), HistoryOrdersTotal(), HistoryOrderSelect(), Свойства ордеров

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

649

HistoryOrderGetString

Возвращает запрошенное свойство ордера. Свойство ордера должно быть типа string. Существует

2 варианта функции.

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

string HistoryOrderGetString(

ulong ticket_number, // тикет

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

);

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

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

параметром.

bool HistoryOrderGetString(

ulong ticket_number, // тикет

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

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

);

Параметры

ticket_number

[in] Тикет ордера.

property_id

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

ENUM_ORDER_PROPERTY_STRING.

string_var

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

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

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

Примечание

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

которые отображаются на вкладке "Торговля" в панели "Инструменты". Список ордеров,

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

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

Смотри также

HistorySelect(), HistoryOrdersTotal(), HistoryOrderSelect(), Свойства ордеров

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

650

HistoryDealSelect

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

Возвращает true при успешном завершении функции. Возвращает false при неудачном завершении

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

bool HistoryDealSelect(

ulong ticket // тикет сделки

);

Параметры

ticket

[in] Тикет сделки

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

Возвращает true в случае успеха, иначе false.

Примечание

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

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

одной или нескольких сделок.

Функция HistoryDealSelect() очищает в mql5-программе список сделок, доступных для

обращений, и копирует в него одну единственную сделку, если выполнение HistoryDealSelect()

завершилось успешно. Если необходимо перебрать все сделки, выбранные функцией

HistorySelect(), то лучше использовать функцию HistoryDealGetTicket().

Смотри также

HistorySelect(), HistoryDealGetTicket(), Свойства сделок