GitHub で見る
XCCI ヒストグラム Vol 戦略
概要
この戦略は、MetaTrader エキスパートアドバイザー Exp_XCCI_Histogram_Vol のStockSharpポートです。カスタム「XCCI Histogram Vol」インジケーターの色分けされたロジックを再現します:Commodity Channel Index(CCI)にボリュームを掛けて選択可能な移動平均で平滑化し、動的なしきい値と比較します。実装は高レベルAPIガイドラインに従い、クローズドキャンドルのみを処理し、プライマリおよびセカンダリエントリー用に別々のボリュームを公開することで元のデュアルポジション構造を維持します。
インジケーターワークフロー
- 設定可能な期間でCCI値を計算する。
- CCI値をキャンドルボリュームで乗算する。
- 選択した移動平均(
Simple、Exponential、Smoothed、Weighted、Hull、またはVolumeWeighted)で CCI×Volume系列と生ボリュームの両方を平滑化する。
- 4つのユーザー定義のしきい値乗数(HighLevel2/1とLowLevel1/2)を平滑化されたボリュームでスケールする。
- 平滑化されたCCI×Volume値を5つのゾーンのいずれかに分類する:
0極端に強気、1強気、2中立、3弱気、4極端に弱気。
戦略はすべての終了したキャンドルのゾーンを保存します。SignalBarOffsetパラメーターは、ゾーンを取引決定に使用する前に何個の完全にクローズしたキャンドルを待つかを制御します(元のSignalBar入力を反映)。
取引ルール
- ロングエグジット: 評価されたゾーンが
3または4の場合、すべてのオープンなロングポジションがクローズされます。
- ショートエグジット: 評価されたゾーンが
1または0の場合、すべてのオープンなショートポジションがクローズされます。
- プライマリロングエントリー: 現在のゾーンが
1になり、前のゾーン(古いキャンドル)が1より上だったときにトリガーされます。これは中立/弱気ゾーンから強気バンドへの移行を反映します。注文ボリュームはPrimaryEntryVolumeで、フリップ前に既存のショートエクスポージャーをクローズします。
- セカンダリロングエントリー: 現在のゾーンが
0になり、前のゾーンが0より上だったときにトリガーされます。これは極端に強気な領域へのサージを表し、SecondaryEntryVolumeを使用します。
- プライマリショートエントリー: 現在のゾーンが
3になり、前のゾーンが3より下だったときにトリガーされ、弱気なゾーンへの新しい動きを示します。PrimaryEntryVolumeを使用し、必要に応じて最初にロングをクローズします。
- セカンダリショートエントリー: 現在のゾーンが
4になり、前のゾーンが4より下だったときにトリガーされ、極端な弱気の加速を示します。SecondaryEntryVolumeを使用します。
エントリーフラグはネットポジションがゼロを超えるたびにリセットされ、動作がMetaTraderの「2つのマジックナンバー」設計に一致するようにします—反対のシグナルまたはリスクモジュールがトレードをクローズするまで、1ティアにつき1つの注文のみが許可されます。
リスク管理
UseStopLoss / UseTakeProfit は組み込みのStartProtectionヘルパーを通じて絶対的な保護距離(価格ポイントで表現)を有効にします。ストップは元のコードと同様にオプションです。
- 戦略はすべてのアクションに成行注文を使用するため、StockSharpに設定されたプラットフォーム全体のスリッページ処理を尊重します。
- ロギング呼び出しはすべてのエントリーとエグジットを説明し、取引が実行された理由を監査しやすくします。
パラメーター
- CciPeriod – Commodity Channel Indexの長さ。
- MaLength – 両方の平滑化移動平均に適用される長さ。
- HighLevel2 / HighLevel1 / LowLevel1 / LowLevel2 – 適応型しきい値を作成するために平滑化されたボリュームに適用される乗数。
- SignalBarOffset – ゾーンに基づいて行動する前に待つ閉じたキャンドルの数(0 = 最後の閉じたキャンドル、1 = 前のキャンドルなど)。
- Smoothing – 平滑化に使用される移動平均タイプ(元のオプションのサブセット:SMA、EMA、SMMA、WMA、Hull MA、VWMA)。
- AllowLongEntries / AllowShortEntries / AllowLongExits / AllowShortExits – 各サイドを独立して有効または無効にする。
- PrimaryEntryVolume / SecondaryEntryVolume – 2つのエントリーティアのボリューム(ロングとショートの両トレードに使用)。
- UseStopLoss / StopLossPoints – オプションの絶対ストップロス。
- UseTakeProfit / TakeProfitPoints – オプションの絶対テイクプロフィット。
- CandleType – コネクターから要求された時間軸(または他のキャンドルデータタイプ)。
- StockSharpに存在する平滑化メソッドのみが公開されます;JJMA、JurX、Parabolic MA、VIDYA、AMAのようなエキゾチックフィルターは含まれていません。類似の動作が必要な場合は最も近い利用可能な代替を選んでください。
- キャンドルボリュームは
ICandleMessage.TotalVolumeから取得されます。ティックボリュームはエミュレートされません。基礎となるコネクターがトランザクション数のみを提供する場合、結果は元のターミナルと異なります。
- 注文管理は2つの独立したマジックナンバーの代わりにネット(単一ポジション)です。別々のプライマリ/セカンダリエントリーフラグはStockSharp実行モデルと互換性を保ちながら同じ意図をエミュレートします。
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>
/// XCCI Histogram Vol strategy. Uses CCI zero-line crossover.
/// </summary>
public class XcciHistogramVolStrategy : Strategy
{
private readonly StrategyParam<DataType> _candleType;
private readonly StrategyParam<int> _cciPeriod;
private decimal? _prevCci;
public DataType CandleType
{
get => _candleType.Value;
set => _candleType.Value = value;
}
public int CciPeriod
{
get => _cciPeriod.Value;
set => _cciPeriod.Value = value;
}
public XcciHistogramVolStrategy()
{
_candleType = Param(nameof(CandleType), TimeSpan.FromHours(1).TimeFrame())
.SetDisplay("Candle Type", "Timeframe", "General");
_cciPeriod = Param(nameof(CciPeriod), 14)
.SetGreaterThanZero()
.SetDisplay("CCI Period", "CCI lookback", "Indicators");
}
public override IEnumerable<(Security sec, DataType dt)> GetWorkingSecurities()
{
return [(Security, CandleType)];
}
/// <inheritdoc />
protected override void OnReseted()
{
base.OnReseted();
_prevCci = null;
}
protected override void OnStarted2(DateTime time)
{
base.OnStarted2(time);
_prevCci = null;
var cci = new CommodityChannelIndex { Length = CciPeriod };
var subscription = SubscribeCandles(CandleType);
subscription.Bind(cci, ProcessCandle).Start();
var area = CreateChartArea();
if (area != null) { DrawCandles(area, subscription); var cciArea = CreateChartArea(); if (cciArea != null) DrawIndicator(cciArea, cci); DrawOwnTrades(area); }
}
private void ProcessCandle(ICandleMessage candle, decimal cciVal)
{
if (candle.State != CandleStates.Finished) return;
if (!IsFormedAndOnlineAndAllowTrading()) { _prevCci = cciVal; return; }
if (_prevCci == null) { _prevCci = cciVal; return; }
if (_prevCci.Value < 0m && cciVal >= 0m && Position <= 0) { if (Position < 0) BuyMarket(); BuyMarket(); }
else if (_prevCci.Value > 0m && cciVal <= 0m && Position >= 0) { if (Position > 0) SellMarket(); SellMarket(); }
_prevCci = cciVal;
}
}
import clr
clr.AddReference("StockSharp.Messages")
clr.AddReference("StockSharp.Algo")
clr.AddReference("StockSharp.Algo.Indicators")
clr.AddReference("StockSharp.Algo.Strategies")
from System import TimeSpan
from StockSharp.Messages import DataType, CandleStates
from StockSharp.Algo.Indicators import CommodityChannelIndex
from StockSharp.Algo.Strategies import Strategy
class xcci_histogram_vol_strategy(Strategy):
def __init__(self):
super(xcci_histogram_vol_strategy, self).__init__()
self._candle_type = self.Param("CandleType", DataType.TimeFrame(TimeSpan.FromHours(1))) \
.SetDisplay("Candle Type", "Timeframe", "General")
self._cci_period = self.Param("CciPeriod", 14) \
.SetDisplay("CCI Period", "CCI lookback", "Indicators")
self._prev_cci = None
@property
def CandleType(self):
return self._candle_type.Value
@property
def CciPeriod(self):
return self._cci_period.Value
def OnReseted(self):
super(xcci_histogram_vol_strategy, self).OnReseted()
self._prev_cci = None
def OnStarted2(self, time):
super(xcci_histogram_vol_strategy, self).OnStarted2(time)
self._prev_cci = None
cci = CommodityChannelIndex()
cci.Length = self.CciPeriod
subscription = self.SubscribeCandles(self.CandleType)
subscription.Bind(cci, self._on_process).Start()
area = self.CreateChartArea()
if area is not None:
self.DrawCandles(area, subscription)
self.DrawOwnTrades(area)
ind_area = self.CreateChartArea()
if ind_area is not None:
self.DrawIndicator(ind_area, cci)
def _on_process(self, candle, cci_value):
if candle.State != CandleStates.Finished:
return
cv = float(cci_value)
if not self.IsFormedAndOnlineAndAllowTrading():
self._prev_cci = cv
return
if self._prev_cci is None:
self._prev_cci = cv
return
# CCI crosses above zero
if self._prev_cci < 0.0 and cv >= 0.0 and self.Position <= 0:
if self.Position < 0:
self.BuyMarket()
self.BuyMarket()
# CCI crosses below zero
elif self._prev_cci > 0.0 and cv <= 0.0 and self.Position >= 0:
if self.Position > 0:
self.SellMarket()
self.SellMarket()
self._prev_cci = cv
def CreateClone(self):
return xcci_histogram_vol_strategy()