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

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

Получение рыночной информации

501

Получение рыночной информации

Функции для получения информации о состоянии рынка.

Функция

Действие

SymbolsTotal

Возвращает количество доступных

(выбранных в MarketWatch или всех)

символов

SymbolName

Возвращает наименование указанного

символа

SymbolSelect

Выбирает символ в окне MarketWatch или

убирает символ из окна

SymbolIsSynchronized

Проверяет синхронизированность данных по

указанному символу в терминале с данными

на торговом сервере

SymbolInfoDouble

Возвращает значение типа double указанного

символа для соответствующего свойства

SymbolInfoInteger

Возвращает значение целочисленного типа

(long, datetime, int или bool) указанного

символа для соответствующего свойства

SymbolInfoString

Возвращает значение типа string указанного

символа для соответствующего свойства

SymbolInfoTick

Возвращает текущие цены для указанного

символа в переменной типа MqlTick

SymbolInfoSessionQuote

Позволяет получить время начала и время

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

для указанных символа и дня недели.

SymbolInfoSessionTrade

Позволяет получить время начала и время

окончания указанной торговой сессии для

указанных символа и дня недели.

MarketBookAdd

Обеспечивает открытие стакана цен по

указанному инструменту, а также производит

подписку на получение извещений об

изменении указанного стакана

MarketBookRelease

Обеспечивает закрытие стакана цен по

указанному инструменту, а также отменяет

подписку на получение извещений об

изменении указанного стакана

MarketBookGet

Возвращает массив структур типа MqlBookInfo

, содержащий записи стакана цен указанного

символа

Получение рыночной информации

502

SymbolsTotal

Возвращает количество доступных (выбранных в MarketWatch или всех) символов.

int SymbolsTotal(

bool selected // true – только символы в MarketWatch

);

Параметры

selected

[in] Режим запроса. Может принимать значения true или false.

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

Если параметр selected равно true, то возвращается количество выбранных в MarketWatch

символов. Если значение false, то возвращается общее количество всех символов.

Получение рыночной информации

503

SymbolName

Возвращает наименование указанного символа.

string SymbolName(

int pos, // номер в списке

bool selected // true – только символы в MarketWatch

);

Параметры

pos

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

selected

[in] Режим запроса. Если значение true, то символ берется из списка выбранных в

MarketWatch. Если значение false, то символ берется из общего списка.

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

Значение типа string c именем символа.

Получение рыночной информации

504

SymbolSelect

Выбирает символ в окне MarketWatch или убирает символ из окна.

bool SymbolSelect(

string name, // имя символа

bool select // включить или выключить

);

Параметры

name

[in] Имя символа.

select

[in] Переключатель. Если значение false, то символ должен быть убран из окна MarketWatch,

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

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

символу.

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

В случае неудачи функция возвращает false.

Получение рыночной информации

505

SymbolIsSynchronized

Проверяет факт синхронизированности данных по указанному символу в терминале с данными на

торговом сервере

bool SymbolIsSynchronized(

string name, // имя символа

);

Параметры

name

[in] Имя символа.

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

Если данные синхронизированы, возвращает true, иначе возвращает false.

Смотри также

SymbolInfoInteger, Организация доступа к данным

Получение рыночной информации

506

SymbolInfoDouble

Возвращает соответствующее свойство указанного символа. Существует 2 варианта функции.

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

double SymbolInfoDouble(

string name, // символ

int prop_id // идентификатор свойства

);

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

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

параметром.

bool SymbolInfoDouble(

string name, // символ

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

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

);

Параметры

name

[in] Имя символа.

prop_id

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

ENUM_SYMBOL_INFO_DOUBLE.

double_var

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

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

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

Пример:

void OnTick()

{

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

bool spreadfloat=SymbolInfoInteger(Symbol(),SYMBOL_SPREAD_FLOAT);

string comm=StringFormat("Спред %s = %I64d пунктов\r\n",

spreadfloat?"плавающий":"фиксированный",

SymbolInfoInteger(Symbol(),SYMBOL_SPREAD));

//--- вычислим теперь спред сами

double ask=SymbolInfoDouble(Symbol(),SYMBOL_ASK);

double bid=SymbolInfoDouble(Symbol(),SYMBOL_BID);

double spread=ask-bid;

int spread_points=(int)MathRound(spread/SymbolInfoDouble(Symbol(),SYMBOL_POINT));

comm=comm+"Вычисленный спред = "+(string)spread_points+" пунктов";

Получение рыночной информации

507

Comment(comm);

}

Получение рыночной информации

508

SymbolInfoInteger

Возвращает соответствующее свойство указанного символа. Существует 2 варианта функции.

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

long SymbolInfoInteger(

string name, // символ

int prop_id // идентификатор свойства

);

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

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

параметром.

bool SymbolInfoInteger(

string name, // символ

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

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

);

Параметры

name

[in] Имя символа.

prop_id

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

ENUM_SYMBOL_INFO_INTEGER.

long_var

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

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

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

Пример:

void OnTick()

{

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

bool spreadfloat=SymbolInfoInteger(Symbol(),SYMBOL_SPREAD_FLOAT);

string comm=StringFormat("Спред %s = %I64d пунктов\r\n",

spreadfloat?"плавающий":"фиксированный",

SymbolInfoInteger(Symbol(),SYMBOL_SPREAD));

//--- вычислим теперь спред сами

double ask=SymbolInfoDouble(Symbol(),SYMBOL_ASK);

double bid=SymbolInfoDouble(Symbol(),SYMBOL_BID);

double spread=ask-bid;

int spread_points=(int)MathRound(spread/SymbolInfoDouble(Symbol(),SYMBOL_POINT));

comm=comm+"Вычисленный спред = "+(string)spread_points+" пунктов";

Получение рыночной информации

509

Comment(comm);

}

Получение рыночной информации

510

SymbolInfoString

возвращает соответствующее свойство указанного символа. Существует 2 варианта функции.

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

string SymbolInfoString(

string name, // символ

int prop_id // идентификатор свойства

);

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

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

параметром.

bool SymbolInfoString(

string name, // символ

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

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

);

Параметры

name

[in] Имя символа.

prop_id

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

ENUM_SYMBOL_INFO_STRING.

string_var

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

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

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