search Ничего не найдено
Главная Документация по алготрейдингу Торговые операции Позиции

Positions.Оpen

Посылаем запрос на открытие позиции с заданными параметрами.

Существует два варианта вызова метода:

int Positions.Open(symbolName, positionType, volume, takeProfit, stopLoss, takeProfitByPips,
stopLossByPips, label, out positionId, isJustCheck = false, isAsync = false)

Входные параметры:

Параметр
Тип
Описание
symbolName          
string
Название символа
positionType
PositionType
BuyилиSell
volume
double
Объем позиции в лотах
takeProfit
double
Тейк профит – уровень рыночной цены, при достижении которой следует закрыть позицию для фиксации прибыли. Указывается в котируемой валюте.
stopLoss
double
Стоп лосс - уровень рыночной цены, при достижении которой следует закрыть позицию для фиксирования убытков. Указывается в котируемой валюте.
takeProfitByPips
Int
Тейк профит. Уровень цены в пунктах для фиксации прибыли.
stopLossByPips
Int
Стоп лосс. Уровень цены в пунктах для фиксации убытков.
positionId
outint
В параметре можно задать переменную, в которую после успешного открытия позиции будет записан уникальный идентификатор открытой позиции. Параметр работает только для синхронного режима.
isJustCheck
bool
Режим проверки (включен или выключен). При включенном режиме запрос на открытие позиции не отправляется, а только проверяется возможность открытия с такими параметрами.
По умолчанию выключен
= false
isAsync
bool
Асинхронный режим (включен или выключен).
По умолчанию выключен
= false


int Positions.Open(ref position, isJustCheck = false, isAsync = false)

Входные параметры:

Параметр
Тип
Описание
position
Объект, который содержит все параметры операции для открытия позиции
isJustCheck
bool
Режим проверки (включен или выключен). При включенном режиме запрос на открытие позиции не отправляется, а только проверяется возможность открытия с такими параметрами.
По умолчанию выключен
= false
isAsync
bool
Асинхронный режим (включен или выключен).
По умолчанию выключен
= false


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

При isJustCheck= true

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

0
Проверка на возможность открытия прошла успешно. Проверка происходит на стороне клиента
-1
Проверка не прошла


При isAsync= false (синхронный режим по умолчанию), возвращает код результата выполнения операции: 

0
Позиция успешно открыта
В случае, если произошла ошибка возвращает код ошибки сервера

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


При isAsync= true (асинхронный режим)

0
Запрос на открытие позиции успешно отправлен на сервер. Не означает, что эта позиция уже исполнена или обязательно будет исполнена.
В случае, если произошла ошибка возвращает код ошибки, полученный на клиенте. Коды совпадают с кодами ошибки сервера.

Использование out параметра positionId при асинхронном режиме не имеет смысла. Всегда будет возвращать -1


Пример:

/*
Открываем позицию на покупку,по основному символу робота, объемом 0.1 лота,
без установки TP/SL, с установленной значением метки позиции MyLabel.
*/
string MyLabel="MyPosition";
int PositionId;
int err = -1;
err = Positions.Open(Symbol.SymbolName, PositionType.Sell, Lot, 0, 0, 0, 0, MyLabel, out positionId);
if (err != 0) {
msg= DateTime.Now.ToString("dd.MM.yyyy HH:mm:ss:fff") + " Failed, ServerErrorCode = " + err.ToString();
}


Подпишитесь на нашу рассылку и будьте в курсе всех новостей!