English EN
View on GitHub

Hammer Hanging Stochastic

This strategy ports the MetaTrader expert "Expert_AH_HM_Stoch" to the StockSharp high-level API. It combines hammer and hanging man candlestick patterns with stochastic oscillator confirmation to capture reversal setups after extended moves.

The strategy waits for a completed candle before acting, uses the stochastic signal line for filtering, and closes positions when momentum exits the extreme zones.

Details

  • Entry Criteria:
    • Long: Bullish hammer candle and stochastic %D (previous bar) below the oversold level.
    • Short: Bearish hanging man candle and stochastic %D (previous bar) above the overbought level.
  • Long/Short: Both.
  • Exit Criteria: Close positions when stochastic %D crosses above/below configurable recovery and extreme levels.
  • Stops: Enabled through the built-in StartProtection() hook (defaults to account-level protection).
  • Default Values:
    • CandleType = TimeSpan.FromHours(1)
    • StochPeriodK = 15
    • StochPeriodD = 49
    • StochPeriodSlow = 25
    • OversoldLevel = 30
    • OverboughtLevel = 70
    • ExitLowerLevel = 20
    • ExitUpperLevel = 80
    • MaxBodyRatio = 0.35
    • LowerShadowMultiplier = 2.5
    • UpperShadowMultiplier = 0.3
  • Filters:
    • Category: Pattern + Oscillator confirmation
    • Direction: Both
    • Indicators: Candlestick, Stochastic
    • Stops: Optional risk controls via StartProtection
    • Complexity: Intermediate
    • Timeframe: Swing / Intraday (1h default)
    • Seasonality: No
    • Neural Networks: No
    • Divergence: No
    • Risk Level: Moderate

How It Works

  1. Subscribes to the configured candle series and stochastic oscillator using the high-level BindEx API.
  2. Detects hammer and hanging man formations based on body and shadow ratios.
  3. Confirms entries with the stochastic %D line using the previous closed bar value.
  4. Manages exits when the stochastic exits the oversold/overbought zones, mirroring the logic of the original MQL expert.
  5. Provides chart visualization for candles, stochastic, and own trades when a chart area is available.
namespace StockSharp.Samples.Strategies;

using System;
using Ecng.Common;
using StockSharp.Algo.Indicators;
using StockSharp.Algo.Strategies;
using StockSharp.Messages;

/// <summary>
/// Hammer/Hanging Man + Stochastic strategy.
/// Buys on hammer in oversold, sells on hanging man in overbought.
/// </summary>
public class HammerHangingStochasticStrategy : Strategy
{
	private readonly StrategyParam<DataType> _candleType;
	private readonly StrategyParam<int> _stochPeriod;
	private readonly StrategyParam<decimal> _oversold;
	private readonly StrategyParam<decimal> _overbought;

	public DataType CandleType { get => _candleType.Value; set => _candleType.Value = value; }
	public int StochPeriod { get => _stochPeriod.Value; set => _stochPeriod.Value = value; }
	public decimal Oversold { get => _oversold.Value; set => _oversold.Value = value; }
	public decimal Overbought { get => _overbought.Value; set => _overbought.Value = value; }

	public HammerHangingStochasticStrategy()
	{
		_candleType = Param(nameof(CandleType), TimeSpan.FromMinutes(5).TimeFrame())
			.SetDisplay("Candle Type", "Candle timeframe", "General");
		_stochPeriod = Param(nameof(StochPeriod), 14)
			.SetGreaterThanZero()
			.SetDisplay("Stoch Period", "Stochastic K period", "Indicators");
		_oversold = Param(nameof(Oversold), 30m)
			.SetDisplay("Oversold", "Stochastic oversold level", "Signals");
		_overbought = Param(nameof(Overbought), 70m)
			.SetDisplay("Overbought", "Stochastic overbought level", "Signals");
	}

	protected override void OnStarted2(DateTime time)
	{
		base.OnStarted2(time);
		var stoch = new StochasticOscillator { K = { Length = StochPeriod }, D = { Length = 3 } };
		var subscription = SubscribeCandles(CandleType);
		subscription.BindEx(stoch, ProcessCandle).Start();
	}

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

		var stochTyped = stochValue as StochasticOscillatorValue;
		if (stochTyped?.K is not decimal kValue) return;

		var body = Math.Abs(candle.ClosePrice - candle.OpenPrice);
		var range = candle.HighPrice - candle.LowPrice;
		if (range <= 0 || body <= 0) return;

		var upperShadow = candle.HighPrice - Math.Max(candle.OpenPrice, candle.ClosePrice);
		var lowerShadow = Math.Min(candle.OpenPrice, candle.ClosePrice) - candle.LowPrice;

		// Hammer: small body at top, long lower shadow
		var isHammer = lowerShadow > body * 2 && upperShadow < body;

		// Hanging Man: small body at bottom, long upper shadow
		var isHangingMan = upperShadow > body * 2 && lowerShadow < body;

		if (isHammer && kValue < Oversold && Position <= 0)
			BuyMarket();
		else if (isHangingMan && kValue > Overbought && Position >= 0)
			SellMarket();
	}
}