Start · Sprachen · PHP · Referenz · trader_cdlhikkakemod

trader_cdlhikkakemod

Funktion

Erkennt das modifizierte Hikkake-Candlestick-Muster in OHLC-Kursdaten und gibt ein Array mit Signal-Werten zurück.

Kategorie: math

Signatur

trader_cdlhikkakemod(array $open, array $high, array $low, array $close): array

Beschreibung

Die Funktion trader_cdlhikkakemod() ist Teil der PHP-Erweiterung Trader (Technical Analysis for Traders) und identifiziert das Modified Hikkake Pattern in historischen Kursdaten. Dieses Muster ist eine Weiterentwicklung des klassischen Hikkake-Musters und wird in der technischen Analyse verwendet, um potenzielle Trendumkehrungen oder Falschausbrüche (Fake-Breakouts) zu erkennen.

Das modifizierte Hikkake-Muster besteht typischerweise aus mehreren Kerzen: einer Inside-Bar-Formation gefolgt von einem scheinbaren Ausbruch in eine Richtung, der jedoch durch eine anschließende Kerze als Fakeout entlarvt wird. Dabei deutet ein positiver Signal-Wert (100) auf eine bullische Umkehr und ein negativer Wert (-100) auf eine bärische Umkehr hin. Der Wert 0 zeigt an, dass kein Muster erkannt wurde.

Die Eingabe-Arrays müssen dieselbe Länge haben und chronologisch geordnete OHLC-Werte (Open, High, Low, Close) eines Finanzinstruments enthalten. Das Rückgabe-Array hat dieselbe Länge wie die Eingabe, wobei die ersten Elemente aufgrund des Lookback-Zeitraums mit 0 belegt sein können.

Die Funktion eignet sich besonders für algorithmisches Trading und die automatisierte Mustererkennung in Candlestick-Charts, etwa zur Signalgenerierung in Trading-Strategien oder zur Rückwärtsanalyse historischer Kursdaten.

Parameter

Name Typ Default Beschreibung
$open Pflicht array Array der Eröffnungskurse (Open) in chronologischer Reihenfolge. Muss dieselbe Länge wie high, low und close haben.
$high Pflicht array Array der Tageshöchstkurse (High) in chronologischer Reihenfolge. Muss dieselbe Länge wie open, low und close haben.
$low Pflicht array Array der Tagestiefkurse (Low) in chronologischer Reihenfolge. Muss dieselbe Länge wie open, high und close haben.
$close Pflicht array Array der Schlusskurse (Close) in chronologischer Reihenfolge. Muss dieselbe Länge wie open, high und low haben.

Rückgabewert

Typ
array
Beschreibung
Gibt ein Array mit ganzzahligen Signal-Werten zurück. 100 steht für ein erkanntes bullisches modifiziertes Hikkake-Muster, -100 für ein bärisches Muster und 0 bedeutet, dass an dieser Stelle kein Muster erkannt wurde. Die ersten Elemente des Arrays können aufgrund des benötigten Lookback-Zeitraums den Wert 0 tragen.

Beispiele

Einfache Mustererkennung auf simulierten OHLC-Daten

<?php
// Voraussetzung: PHP Trader-Erweiterung ist installiert und aktiviert

$open  = [10.0, 10.5, 10.2, 10.3, 10.1, 10.4, 10.6, 10.5, 10.7, 10.8];
$high  = [10.8, 11.0, 10.6, 10.7, 10.5, 10.9, 11.1, 11.0, 11.2, 11.3];
$low   = [ 9.9, 10.3, 10.0, 10.1,  9.9, 10.2, 10.4, 10.3, 10.5, 10.6];
$close = [10.5, 10.8, 10.4, 10.5, 10.3, 10.7, 10.9, 10.8, 11.0, 11.1];

$result = trader_cdlhikkakemod($open, $high, $low, $close);

foreach ($result as $index => $signal) {
    if ($signal !== 0) {
        $richtung = $signal > 0 ? 'Bullisch' : 'Bärisch';
        echo "Index {$index}: Modifiziertes Hikkake-Muster erkannt ({$richtung}, Signal: {$signal})\n";
    }
}

if (empty(array_filter($result))) {
    echo "Kein modifiziertes Hikkake-Muster in den Eingabedaten gefunden.\n";
}
Kein modifiziertes Hikkake-Muster in den Eingabedaten gefunden.

Integration in eine Handelsstrategie mit Signal-Auswertung

<?php
// Historische OHLC-Daten (z. B. aus einer Datenbank oder API geladen)
$open  = [100, 102, 101, 101, 100, 99, 100, 98, 97, 99, 101, 102];
$high  = [103, 104, 103, 102, 101, 101, 102, 100, 99, 101, 103, 104];
$low   = [ 99, 101, 100, 100,  99,  98,  99,  97,  96,  98, 100, 101];
$close = [102, 103, 101, 100,  99, 100,  99,  98,  98, 100, 102, 103];

$signale = trader_cdlhikkakemod($open, $high, $low, $close);

echo "Ergebnis der Mustererkennung (Modified Hikkake Pattern):\n";
foreach ($signale as $i => $signal) {
    $status = match(true) {
        $signal > 0 => '✅ Bullisches Signal',
        $signal < 0 => '❌ Bärisches Signal',
        default     => '– Kein Muster',
    };
    echo "Kerze [{$i}]: {$status} (Wert: {$signal})\n";
}
Ergebnis der Mustererkennung (Modified Hikkake Pattern): Kerze [0]: – Kein Muster (Wert: 0) Kerze [1]: – Kein Muster (Wert: 0) Kerze [2]: – Kein Muster (Wert: 0) Kerze [3]: – Kein Muster (Wert: 0) Kerze [4]: – Kein Muster (Wert: 0) Kerze [5]: – Kein Muster (Wert: 0) Kerze [6]: – Kein Muster (Wert: 0) Kerze [7]: – Kein Muster (Wert: 0) Kerze [8]: – Kein Muster (Wert: 0) Kerze [9]: – Kein Muster (Wert: 0) Kerze [10]: – Kein Muster (Wert: 0) Kerze [11]: – Kein Muster (Wert: 0)

// Wichtig · Fallstricke

Voraussetzung: Die Funktion steht nur zur Verfügung, wenn die PHP-Erweiterung trader installiert und in der php.ini mit extension=trader aktiviert ist. Auf manchen Systemen muss sie erst über PECL installiert werden: pecl install trader.

Datenmenge: Das modifizierte Hikkake-Muster benötigt einen Lookback-Zeitraum von mehreren Kerzen. Bei zu wenigen Eingabedaten können alle Rückgabewerte 0 sein. Empfohlen wird eine ausreichende Datenmenge (mindestens 10–20 Kerzen).

Array-Indizes: Die Eingabe-Arrays sollten numerisch indiziert und gleichlang sein. Unterschiedliche Längen oder nicht-numerische Schlüssel können zu unerwarteten Ergebnissen oder Fehlern führen.

Kein Ersatz für Fachberatung: Candlestick-Muster wie das modifizierte Hikkake-Muster sind technische Indikatoren und kein zuverlässiger Garant für Kursentwicklungen. Stets in Kombination mit anderen Analysemethoden verwenden.