Открыть на GitHub

Хеджинговая стратегия Frank Ud

Обзор

Frank Ud Hedging Grid Strategy — это порт советника MetaTrader «Frank Ud» на высокоуровневый API StockSharp. Робот одновременно удерживает длинную и короткую корзины по одному инструменту и наращивает позицию по принципу мартингейла, когда цена уходит против активной корзины. Все сигналы обрабатываются по обновлениям лучшего бид/аск (Level 1), поэтому стратегия подходит для низколатентного исполнения и тикового тестирования.

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

  1. Стартовое хеджирование. При отсутствии позиций стратегия мгновенно открывает рыночные покупки и продажи одинакового объёма. Каждая заявка получает стоп-лосс и тейк-профит в пунктах.
  2. Контроль стопов и тейков. Пока существуют обе корзины, соблюдаются их защитные уровни. Попадание цены в стоп или тейк закрывает соответствующую корзину.
  3. Управление одной стороной. Когда остаются только покупки или только продажи, стратегия:
    • вычисляет средневзвешенную цену входа активной корзины;
    • переносит общий тейк-профит на среднюю цену ± заданное расстояние;
    • удаляет стоп-лосс (как и оригинальный советник, далее стратегия полагается только на тейк-профит).
  4. Шаг мартингейла. При движении цены против корзины больше, чем на заданный шаг, множитель объёма удваивается и создаётся новая рыночная заявка. Метод AdjustVolume повторяет MQL5-функцию LotCheck, подгоняя объёмы под минимальный, максимальный и шаг инструмента.
  5. Сброс цикла. После закрытия всех позиций множитель возвращается к 1, и цикл хеджирования запускается заново.

Параметры

  • TakeProfitPips — расстояние между средней ценой корзины и общим тейк-профитом (по умолчанию 12 пунктов).
  • StopLossPips — защитный стоп, применяемый только к стартовой паре заявок (по умолчанию 12 пунктов).
  • StepPips — обратное движение цены, необходимое для добора следующей заявки (по умолчанию 16 пунктов).
  • AutoLot — если true, используется параметр LotSize; иначе берётся минимально допустимый объём инструмента.
  • LotSize — базовый объём для расчёта мартингейла при активном AutoLot.

Особенности реализации

  • Используется высокоуровневый класс Strategy: логика работает по подписке на Level 1, заявки отправляются через BuyMarket/SellMarket.
  • Состояние корзин хранится внутри стратегии, что позволяет повторить алгоритм усреднения оригинального эксперта.
  • Поле _multiplier копирует переменную Coefficient из MQL-версии и удваивается после каждого добора, а при полном закрытии позиций сбрасывается в 1.
  • Метод AdjustVolume ограничивает объёмы в соответствии с шагом, минимальным и максимальным контрактом инструмента.
  • Для корректной работы нужен счёт с поддержкой хеджирования, потому что стратегия одновременно держит длинные и короткие позиции.

Файлы

  • CS/FrankUdStrategy.cs — реализация стратегии с подробными комментариями на английском языке.
  • README.md — описание на английском.
  • README_ru.md — текущий документ на русском.
  • README_zh.md — описание на китайском.
using System;
using System.Linq;
using System.Collections.Generic;

using Ecng.Common;
using Ecng.Collections;
using Ecng.Serialization;

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

namespace StockSharp.Samples.Strategies;

/// <summary>
/// Hedging grid strategy converted from the Frank Ud MetaTrader expert.
/// Opens a position and adds martingale entries when price moves against the trade.
/// Closes all on take profit from average price.
/// </summary>
public class FrankUdStrategy : Strategy
{
	private readonly StrategyParam<decimal> _takeProfit;
	private readonly StrategyParam<decimal> _stopLoss;
	private readonly StrategyParam<decimal> _stepDistance;
	private readonly StrategyParam<int> _maxEntries;
	private readonly StrategyParam<DataType> _candleType;

	private int _lastSignal;

	public decimal TakeProfit { get => _takeProfit.Value; set => _takeProfit.Value = value; }
	public decimal StopLoss { get => _stopLoss.Value; set => _stopLoss.Value = value; }
	public decimal StepDistance { get => _stepDistance.Value; set => _stepDistance.Value = value; }
	public int MaxEntries { get => _maxEntries.Value; set => _maxEntries.Value = value; }
	public DataType CandleType { get => _candleType.Value; set => _candleType.Value = value; }

	public FrankUdStrategy()
	{
		_takeProfit = Param(nameof(TakeProfit), 5000m)
			.SetGreaterThanZero()
			.SetDisplay("Take Profit", "Take profit distance from avg price", "Risk");

		_stopLoss = Param(nameof(StopLoss), 5000m)
			.SetGreaterThanZero()
			.SetDisplay("Stop Loss", "Stop loss distance from avg price", "Risk");

		_stepDistance = Param(nameof(StepDistance), 300m)
			.SetGreaterThanZero()
			.SetDisplay("Step Distance", "Price distance for adding martingale entries", "Grid");

		_maxEntries = Param(nameof(MaxEntries), 1)
			.SetGreaterThanZero()
			.SetDisplay("Max Entries", "Maximum martingale entries", "Grid");

		_candleType = Param(nameof(CandleType), TimeSpan.FromHours(1).TimeFrame())
			.SetDisplay("Candle Type", "Candle type for calculations", "General");
	}

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

	/// <inheritdoc />
	protected override void OnReseted()
	{
		base.OnReseted();
		_lastSignal = 0;
	}

	/// <inheritdoc />
	protected override void OnStarted2(DateTime time)
	{
		base.OnStarted2(time);

		SubscribeCandles(CandleType)
			.Bind(ProcessCandle)
			.Start();

		StartProtection(
			new Unit(TakeProfit, UnitTypes.Absolute),
			new Unit(StopLoss, UnitTypes.Absolute));
	}

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

		var bodySize = (candle.ClosePrice - candle.OpenPrice).Abs();
		if (bodySize < StepDistance)
			return;

		var direction = candle.ClosePrice > candle.OpenPrice ? 1 : -1;
		if (direction == _lastSignal)
			return;

		if (direction > 0 && Position <= 0)
		{
			BuyMarket();
			_lastSignal = 1;
		}
		else if (direction < 0 && Position >= 0)
		{
			SellMarket();
			_lastSignal = -1;
		}
	}
}