Signatur
Beschreibung
Die Funktion trader_cdlidentical3crows() ist Teil der TRADER-Erweiterung für PHP, die auf der TA-Lib (Technical Analysis Library) basiert. Sie analysiert Candlestick-Kursdaten (Open, High, Low, Close) und erkennt das bearishe Muster Identical Three Crows (Drei identische Krähen).
Das Muster besteht aus drei aufeinanderfolgenden langen schwarzen (fallenden) Kerzen, bei denen jede Kerze ungefähr auf dem Schlusskurs der vorherigen Kerze eröffnet. Dies gilt als starkes bearishes Umkehrsignal, das am Ende eines Aufwärtstrends auftritt und auf einen bevorstehenden Kursrückgang hindeutet.
Der Rückgabewert pro Element beträgt -100 wenn das Muster erkannt wurde (bearishes Signal), oder 0 wenn kein Muster vorliegt. Die ersten Einträge des Ergebnis-Arrays können leer bzw. mit 0 befüllt sein (Lookback-Periode), da für die Mustererkennung eine Mindestanzahl an vorherigen Kerzen benötigt wird.
Diese Funktion eignet sich besonders für die automatisierte technische Analyse von Börsen-, Devisen- oder Kryptowährungskursen, um potenzielle Trendumkehrsignale algorithmisch zu identifizieren.
Parameter
| Name | Typ | Default | Beschreibung |
|---|---|---|---|
| $open Pflicht | array | Array mit den Eröffnungskursen (Open) der Kerzen als numerische Werte, indiziert von alt nach neu. | |
| $high Pflicht | array | Array mit den Höchstkursen (High) der Kerzen als numerische Werte, indiziert von alt nach neu. | |
| $low Pflicht | array | Array mit den Tiefstkursen (Low) der Kerzen als numerische Werte, indiziert von alt nach neu. | |
| $close Pflicht | array | Array mit den Schlusskursen (Close) der Kerzen als numerische Werte, indiziert von alt nach neu. |
Rückgabewert
-100 wenn das Identical-Three-Crows-Muster erkannt wurde, 0 wenn kein Muster vorliegt. Bei einem Fehler (z. B. ungültige oder leere Eingabe-Arrays) wird false zurückgegeben.Beispiele
Grundlegende Mustererkennung auf simulierten Kursdaten
<?php
// Beispielhafte OHLC-Kursdaten (8 Kerzen)
$open = [100, 102, 101, 99, 97, 95, 93, 91];
$high = [105, 106, 104, 102, 100, 98, 96, 94];
$low = [ 99, 100, 98, 96, 94, 92, 90, 88];
$close = [102, 101, 99, 97, 95, 93, 91, 89];
$result = trader_cdlidentical3crows($open, $high, $low, $close);
if ($result === false) {
echo "Fehler bei der Berechnung.\n";
} else {
foreach ($result as $index => $signal) {
if ($signal !== 0) {
echo "Muster erkannt bei Index $index: Signal = $signal\n";
}
}
if (array_sum(array_map('abs', $result)) === 0) {
echo "Kein Identical-Three-Crows-Muster in den Daten gefunden.\n";
}
}Analyse realer Kursdaten mit Ausgabe aller Signale
<?php
// Simulierte Kursdaten mit potenziellem Identical-Three-Crows-Muster
$open = [110, 115, 113, 113, 110, 107];
$high = [116, 117, 114, 114, 111, 108];
$low = [108, 110, 108, 107, 105, 102];
$close = [115, 113, 110, 110, 107, 104];
$result = trader_cdlidentical3crows($open, $high, $low, $close);
if (is_array($result)) {
echo "Signale (Index => Wert):\n";
foreach ($result as $i => $val) {
$label = match($val) {
-100 => 'Bearishes Signal (Identical Three Crows)',
100 => 'Bullisches Signal',
0 => 'Kein Muster',
default => "Unbekannter Wert: $val"
};
echo " [$i] $label\n";
}
} else {
echo "Fehler: Ungültige Eingabedaten.\n";
}// Wichtig · Fallstricke
Voraussetzung: Die PHP-Erweiterung trader muss installiert und aktiviert sein (pecl install trader). Ohne diese Erweiterung ist die Funktion nicht verfügbar.
Array-Längen: Alle vier Eingabe-Arrays ($open, $high, $low, $close) müssen dieselbe Länge haben. Unterschiedliche Längen können zu false oder unerwarteten Ergebnissen führen.
Lookback-Periode: Die TA-Lib benötigt für dieses Muster eine Mindestanzahl an vorherigen Kerzen (Lookback). Die ersten Elemente des Rückgabe-Arrays sind daher immer 0 und sollten bei der Auswertung berücksichtigt werden.
Interpretation: Ein Signal von -100 ist ein bearishes Warnsignal. Es sollte nie alleine als Handelsentscheidung verwendet werden, sondern stets in Kombination mit anderen Indikatoren und Volumenanalysen.