Signatur
Beschreibung
trader_cdlkicking ist Teil der TRADER-Erweiterung für PHP (basierend auf der TA-Lib) und analysiert Candlestick-Kursdaten auf das sogenannte Kicking-Muster. Dieses Muster besteht aus zwei aufeinanderfolgenden Marubozu-Kerzen (vollständig gefüllte Kerzen ohne Dochte), bei denen die zweite Kerze mit einem Gap (Kurslücke) in entgegengesetzter Richtung öffnet. Es gilt als starkes Trendumkehrsignal.
Das Kicking-Muster kann bullisch oder bärisch sein: Ein bullisches Kicking liegt vor, wenn auf eine schwarze Marubozu eine weiße Marubozu mit Aufwärts-Gap folgt; ein bärisches Kicking ist das genaue Gegenteil. Die Funktion gibt für jeden Datenpunkt einen Integer-Wert zurück: 100 für bullisches Kicking, -100 für bärisches Kicking und 0 wenn kein Muster erkannt wurde.
Die Eingabe-Arrays open, high, low und close müssen dieselbe Länge haben und chronologisch sortierte OHLC-Daten enthalten. Die zurückgegebenen Array-Indizes entsprechen den Indizes der Eingabedaten, wobei die ersten Elemente möglicherweise nicht berechnet werden können (Lookback-Periode).
Diese Funktion eignet sich für die technische Analyse von Finanzkursen, z. B. im Bereich algorithmischen Handels oder bei der Auswertung von Marktdaten in PHP-Anwendungen.
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 für ein erkanntes bullisches Kicking-Muster, -100 für ein bärisches Kicking-Muster und 0 wenn kein Muster vorliegt. Im Fehlerfall (z. B. ungültige Eingaben oder die TRADER-Erweiterung ist nicht verfügbar) wird false zurückgegeben.Beispiele
Einfache Mustererkennung auf OHLC-Daten
<?php
// Beispiel-OHLC-Daten (z. B. Tageskerzen einer Aktie)
$open = [100.0, 98.0, 90.0, 92.0, 85.0];
$high = [100.0, 98.0, 90.0, 92.0, 92.0];
$low = [94.0, 90.0, 84.0, 85.0, 85.0];
$close = [94.0, 90.0, 84.0, 92.0, 92.0];
$result = trader_cdlkicking($open, $high, $low, $close);
if ($result === false) {
echo 'Fehler bei der Mustererkennung oder TRADER-Erweiterung nicht geladen.';
} else {
foreach ($result as $index => $value) {
if ($value === 100) {
echo "Index $index: Bullisches Kicking-Muster erkannt!\n";
} elseif ($value === -100) {
echo "Index $index: Bärisches Kicking-Muster erkannt!\n";
} else {
echo "Index $index: Kein Muster.\n";
}
}
}Integration in eine Kursanalyse mit echten Börsendaten
<?php
// Simulierte OHLC-Daten für 5 Handelstage
$open = [200.0, 195.0, 195.0, 180.0, 181.0];
$high = [200.0, 195.0, 195.0, 181.0, 195.0];
$low = [190.0, 185.0, 185.0, 180.0, 181.0];
$close = [190.0, 185.0, 185.0, 181.0, 195.0];
$patterns = trader_cdlkicking($open, $high, $low, $close);
if (is_array($patterns)) {
$bullish = array_keys(array_filter($patterns, fn($v) => $v === 100));
$bearish = array_keys(array_filter($patterns, fn($v) => $v === -100));
echo 'Bullische Kicking-Muster bei Index: ' . implode(', ', $bullish ?: ['keiner']) . "\n";
echo 'Bärische Kicking-Muster bei Index: ' . implode(', ', $bearish ?: ['keiner']) . "\n";
} else {
echo 'Fehler: Keine Ergebnisse verfügbar.';
}// Wichtig · Fallstricke
Voraussetzung: Die trader-Erweiterung muss in PHP installiert und aktiviert sein (pecl install trader). Ohne diese Erweiterung ist die Funktion nicht verfügbar.
Alle vier Eingabe-Arrays müssen exakt dieselbe Anzahl an Elementen aufweisen. Unterschiedliche Array-Längen führen zu false als Rückgabewert.
Das Kicking-Muster ist eines der selteneren Candlestick-Muster, da es echte Marubozu-Kerzen (ohne jegliche Schatten) in Kombination mit einem Gap erfordert. In der Praxis können leicht abweichende Implementierungen tolerantere Schwellenwerte verwenden.
Die zurückgegebenen Array-Indizes beginnen bei einem Offset, der durch die sogenannte Lookback-Periode der Funktion bestimmt wird. Indizes unterhalb dieses Offsets enthalten den Wert 0.