Signatur
Beschreibung
Die Funktion trader_cdltasukigap() gehört zur PECL-Erweiterung Trader, die technische Indikatoren und Candlestick-Muster aus der TA-Lib-Bibliothek für PHP verfügbar macht. Das Tasuki-Gap-Muster ist ein japanisches Candlestick-Muster, das aus drei Kerzen besteht und als Trendfortsetzungssignal interpretiert wird.
Das Muster entsteht, wenn auf zwei aufeinanderfolgende Kerzen in Trendrichtung (beide bullisch oder beide bärisch) mit einer Lücke (Gap) zwischen ihnen eine dritte Kerze folgt, die in die Gegenrichtung zeigt, aber die Gap nicht vollständig schließt. Dadurch wird signalisiert, dass der bestehende Trend wahrscheinlich weiterläuft. Ein Upside Tasuki Gap tritt in einem Aufwärtstrend auf (positiver Rückgabewert), ein Downside Tasuki Gap in einem Abwärtstrend (negativer Rückgabewert).
Die Funktion erwartet vier gleichlange Arrays mit den OHLC-Kursdaten (Open, High, Low, Close) und gibt ein Array mit numerischen Signalwerten zurück. Typische Rückgabewerte sind 100 (bullisches Muster erkannt), -100 (bärisches Muster erkannt) oder 0 (kein Muster an diesem Punkt). Die ersten Elemente des Rückgabe-Arrays können leer oder auf null gesetzt sein, da für die Mustererkennung mindestens drei Kerzen benötigt werden.
Diese Funktion ist besonders nützlich im algorithmischen Handel, um Trendfortsetzungssignale automatisch zu erkennen und in Handelssysteme zu integrieren.
Parameter
| Name | Typ | Default | Beschreibung |
|---|---|---|---|
| $open Pflicht | array | Array mit den Eröffnungskursen (Open) der Kerzen in chronologischer Reihenfolge. | |
| $high Pflicht | array | Array mit den Höchstkursen (High) der Kerzen in chronologischer Reihenfolge. | |
| $low Pflicht | array | Array mit den Tiefstkursen (Low) der Kerzen in chronologischer Reihenfolge. | |
| $close Pflicht | array | Array mit den Schlusskursen (Close) der Kerzen in chronologischer Reihenfolge. |
Rückgabewert
100 steht für ein erkanntes bullisches Upside-Tasuki-Gap-Muster, -100 für ein bärisches Downside-Tasuki-Gap-Muster und 0 für kein erkanntes Muster am jeweiligen Index. Die Länge des Arrays entspricht der Eingabelänge; die ersten Elemente können 0 sein, da mindestens drei Kerzen für die Erkennung benötigt werden.Beispiele
Einfache Mustererkennung auf historischen Kursdaten
<?php
// OHLC-Kursdaten (z. B. Tageskerzen einer Aktie)
$open = [44.0, 45.0, 46.5, 45.8, 47.0];
$high = [45.5, 46.2, 47.5, 46.5, 48.0];
$low = [43.5, 44.8, 46.0, 45.5, 46.5];
$close = [45.0, 46.0, 47.2, 46.0, 47.5];
$result = trader_cdltasukigap($open, $high, $low, $close);
foreach ($result as $index => $signal) {
if ($signal !== 0) {
$typ = $signal > 0 ? 'Bullisch (Upside Tasuki Gap)' : 'Bärisch (Downside Tasuki Gap)';
echo "Kerze #{$index}: {$typ} (Signal: {$signal})\n";
}
}
if (empty(array_filter($result))) {
echo "Kein Tasuki-Gap-Muster in den vorliegenden Daten gefunden.\n";
}Integration in eine Handelsstrategie mit mehreren Kerzen
<?php
// Simulierte Kursdaten mit potenziell erkennbarem Tasuki-Gap
$open = [10.0, 10.5, 11.5, 11.0, 12.0, 12.5, 13.5, 13.0];
$high = [10.8, 11.2, 12.0, 11.8, 12.8, 13.2, 14.0, 13.8];
$low = [ 9.8, 10.3, 11.2, 10.8, 11.8, 12.2, 13.2, 12.8];
$close = [10.5, 11.0, 11.8, 11.5, 12.5, 13.0, 13.8, 13.5];
$signals = trader_cdltasukigap($open, $high, $low, $close);
echo "Index | Signal | Interpretation\n";
echo str_repeat('-', 40) . "\n";
foreach ($signals as $i => $val) {
$label = match(true) {
$val > 0 => 'Kaufsignal (Upside Tasuki Gap)',
$val < 0 => 'Verkaufssignal (Downside Tasuki Gap)',
default => 'Kein Muster'
};
printf("%5d | %6d | %s\n", $i, $val, $label);
}// Wichtig · Fallstricke
Voraussetzung: Die PECL-Erweiterung trader muss installiert und aktiviert sein (pecl install trader, anschließend extension=trader.so in der php.ini). Die Erweiterung ist nicht standardmäßig in PHP enthalten.
Datenqualität: Alle vier Eingabe-Arrays müssen dieselbe Länge und konsistente, gültige OHLC-Daten enthalten (d. h. low <= open, close <= high). Inkonsistente Daten können zu falschen oder ausbleibenden Signalergebnissen führen.
Lookahead-Hinweis: Das Tasuki-Gap-Muster benötigt mindestens 3 Kerzen für die Erkennung. Die ersten Einträge im Rückgabe-Array sind daher immer 0. Dieses Verhalten ist das gleiche bei allen TA-Lib-basierten Candlestick-Funktionen der Trader-Erweiterung.
Kein Handelssignal allein: Wie alle technischen Indikatoren sollte das Tasuki-Gap-Muster stets in Kombination mit anderen Methoden der technischen Analyse eingesetzt werden und niemals als alleinige Grundlage für Handelsentscheidungen dienen.