Открыть на GitHub

Стратегия ExpICustomV1

Краткое описание

ExpICustomV1 — порт советника MetaTrader exp_iCustom_v1 на платформу StockSharp. Стратегия получает торговые сигналы из настраиваемого индикатора и открывает позиции при появлении ненулевых значений в выбранных буферах: ненулевой buy-буфер запускает длинную позицию, sell-буфер — короткую. Стоп-лосс, тейк-профит, трейлинг и перевод в безубыток повторяют логику оригинального эксперта.

Важно: реализована только C# версия. Python-вариант пока отсутствует.

Логика торговли

  1. Подписываемся на основной таймфрейм из параметра Тип свечей и работаем только с закрытыми свечами.
  2. Создаём индикатор, указанный в Имя индикатора, применяем параметры из строки Параметры индикатора (поддерживаются записи Имя=Значение и упорядоченные числа).
  3. Сохраняем финальные значения индикатора в истории, чтобы обращаться к ним с нужным сдвигом.
  4. Если значение buy-буфера со сдвигом Сдвиг индикатора отлично от нуля — открываем/удерживаем длинную позицию; если ненулевой sell-буфер — открываем/удерживаем короткую позицию.
  5. При одновременном появлении buy и sell сигналов они взаимно отменяются, исключая неопределённость.
  6. Опция Закрывать при развороте закрывает текущую позицию до обработки обратного сигнала.
  7. Механизм «сна» ограничивает частоту входов в одном направлении, а параметр Сбрасывать сон позволяет обнулить таймер при противоположном сигнале.
  8. Управление риском осуществляется через стоп-лосс, тейк-профит, трейлинг-стоп и перевод в безубыток (все расстояния задаются в пунктах).

Настройка индикатора

  • Имя индикатора — полное имя типа или сокращённое название индикатора StockSharp (SMA, MACD, BollingerBands и т.д.).
  • Параметры индикатора — строка с параметрами, разделёнными слешем. Поддерживаются варианты Length=14/Width=2 и просто 14/2/0.7.
  • Блоки переопределения — до пяти замен параметров по индексу, аналог входных параметров Opt_X в исходном советнике. Индексация начинается с нуля.

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

  • Базовый объём — объём каждой рыночной заявки.
  • Стоп-лосс / Тейк-профит — расстояние от цены входа в пунктах.
  • Трейлинг-стоп — активируется при достижении прибыли и удерживает заданный разрыв.
  • Перевод в безубыток — переносит стоп ближе к цене входа после фиксированного профита и может дополнительно фиксировать пункты.

Параметры

Параметр Назначение
Тип свечей Таймфрейм, используемый для расчёта индикатора и сигналов.
Имя индикатора Тип создаваемого индикатора.
Параметры индикатора Список параметров, разделённых слешем.
Буфер Buy / Sell Индексы буферов с сигналами на покупку/продажу.
Сдвиг индикатора Глубина истории при чтении буфера.
Блоки переопределения Замена значений в списке параметров по индексу.
Свечей сна Минимальное число свечей между повторными входами в одном направлении.
Сбрасывать сон Сбрасывать таймер сна при обратном сигнале.
Закрывать при развороте Закрывать текущую позицию перед разворотом.
Макс. ордеров / Макс. Buy / Макс. Sell Ограничения на количество одновременно открытых позиций.
Стоп-лосс / Тейк-профит Дистанция в пунктах для защитных уровней.
Настройки трейлинга Управление активацией и шагом трейлинг-стопа.
Настройки безубытка Управление активацией и фиксацией прибыли при переводе в безубыток.
Базовый объём Объём одной заявки.

Как использовать

  1. Добавьте стратегию в контейнер, назначьте Инструмент и Портфель.
  2. Настройте Имя индикатора и Параметры индикатора в соответствии с нужным пользовательским индикатором.
  3. Подберите параметры управления рисками (стоп, тейк, трейлинг, безубыток) и базовый объём.
  4. Запустите стратегию. Она подпишется на выбранный таймфрейм, вычислит буферы индикатора и отправит рыночные заявки при выполнении условий.

Ограничения

  • Использовать можно только индикаторы, реализованные в StockSharp. Загружать бинарные индикаторы MetaTrader невозможно.
  • Сложные режимы мани-менеджмента, зависящие от свободной маржи, упрощены до фиксированного объёма сделки.
using System;
using System.Collections.Generic;

using StockSharp.Algo.Indicators;
using StockSharp.Algo.Strategies;
using StockSharp.BusinessEntities;
using StockSharp.Messages;

namespace StockSharp.Samples.Strategies;

/// <summary>
/// ExpICustomV1 - custom indicator signal strategy.
/// Uses fast/slow EMA crossover to generate entry/exit signals.
/// Reverses position on opposite crossover.
/// </summary>
public class ExpICustomV1Strategy : Strategy
{
	private readonly StrategyParam<int> _fastPeriod;
	private readonly StrategyParam<int> _slowPeriod;
	private readonly StrategyParam<DataType> _candleType;

	private decimal _prevFast;
	private decimal _prevSlow;
	private bool _hasPrev;

	public int FastPeriod { get => _fastPeriod.Value; set => _fastPeriod.Value = value; }
	public int SlowPeriod { get => _slowPeriod.Value; set => _slowPeriod.Value = value; }
	public DataType CandleType { get => _candleType.Value; set => _candleType.Value = value; }

	public ExpICustomV1Strategy()
	{
		_fastPeriod = Param(nameof(FastPeriod), 10)
			.SetDisplay("Fast EMA", "Fast EMA period", "Indicators");

		_slowPeriod = Param(nameof(SlowPeriod), 21)
			.SetDisplay("Slow EMA", "Slow EMA period", "Indicators");

		_candleType = Param(nameof(CandleType), TimeSpan.FromHours(4).TimeFrame())
			.SetDisplay("Candle Type", "Candle timeframe", "General");
	}

	/// <inheritdoc />
	public override IEnumerable<(Security sec, DataType dt)> GetWorkingSecurities()
	{
		return [(Security, CandleType)];
	}

	/// <inheritdoc />
	protected override void OnReseted()
	{
		base.OnReseted();
		_prevFast = 0m;
		_prevSlow = 0m;
		_hasPrev = false;
	}

	protected override void OnStarted2(DateTime time)
	{
		base.OnStarted2(time);

		_hasPrev = false;

		var fast = new ExponentialMovingAverage { Length = FastPeriod };
		var slow = new ExponentialMovingAverage { Length = SlowPeriod };

		var subscription = SubscribeCandles(CandleType);
		subscription
			.Bind(fast, slow, ProcessCandle)
			.Start();
	}

	private void ProcessCandle(ICandleMessage candle, decimal fast, decimal slow)
	{
		if (candle.State != CandleStates.Finished)
			return;

		if (!_hasPrev)
		{
			_prevFast = fast;
			_prevSlow = slow;
			_hasPrev = true;
			return;
		}

		var bullCross = _prevFast <= _prevSlow && fast > slow;
		var bearCross = _prevFast >= _prevSlow && fast < slow;

		if (bullCross && Position <= 0)
		{
			if (Position < 0)
				BuyMarket();
			BuyMarket();
		}
		else if (bearCross && Position >= 0)
		{
			if (Position > 0)
				SellMarket();
			SellMarket();
		}

		_prevFast = fast;
		_prevSlow = slow;
	}
}