Signatur
Beschreibung
Die Funktion trader_cdl2crows ist Teil der TRADER-Extension (basierend auf TA-Lib) und dient der technischen Analyse von Finanzkursen. Sie durchsucht die übergebenen OHLC-Daten (Open, High, Low, Close) nach dem sogenannten Two Crows-Muster, einem bearishen Umkehrmuster der japanischen Candlestick-Analyse.
Das Two Crows-Muster besteht aus drei Kerzen: Zuerst eine lange weiße (bullishe) Kerze, gefolgt von einer schwarzen Kerze, die über dem Schlusskurs der ersten Kerze eröffnet und dann von einer weiteren schwarzen Kerze, die innerhalb des Körpers der ersten Kerze schließt. Dieses Muster signalisiert eine mögliche Trendumkehr von einem Aufwärts- in einen Abwärtstrend.
Der Rückgabewert ist ein Array, das für jeden Datenpunkt entweder -100 (bearishes Muster erkannt), 100 (bullishes Muster, selten), oder 0 (kein Muster) enthält. Die ersten Elemente des Rückgabe-Arrays sind in der Regel 0, da für das Muster mehrere Vorgänger-Kerzen benötigt werden (Lookback-Periode).
Diese Funktion wird typischerweise in Kombination mit anderen Indikatoren eingesetzt, um Kauf- oder Verkaufssignale in automatisierten Handelssystemen oder Analyse-Dashboards zu erzeugen. Sie setzt die PHP-Erweiterung trader voraus, die separat installiert werden muss.
Parameter
| Name | Typ | Default | Beschreibung |
|---|---|---|---|
| $open Pflicht | array | Array mit den Eröffnungskursen (Open) der Kerzen, indiziert von 0 an aufsteigend. | |
| $high Pflicht | array | Array mit den Höchstkursen (High) der Kerzen, gleiche Länge und Indexierung wie open. |
|
| $low Pflicht | array | Array mit den Tiefstkursen (Low) der Kerzen, gleiche Länge und Indexierung wie open. |
|
| $close Pflicht | array | Array mit den Schlusskursen (Close) der Kerzen, gleiche Länge und Indexierung wie open. |
Rückgabewert
-100 bedeutet ein bearishes Two-Crows-Muster wurde erkannt, 0 bedeutet kein Muster. Bei einem Fehler (z. B. Arrays unterschiedlicher Länge oder fehlende Extension) wird false zurückgegeben. Die ersten Elemente des Arrays sind durch die benötigte Lookback-Periode bedingt 0.Beispiele
Einfache Mustererkennung auf synthetischen Kursdaten
<?php
// Beispiel-OHLC-Daten (Open, High, Low, Close)
$open = [44.0, 45.5, 46.0, 45.0, 44.5];
$high = [45.0, 47.0, 47.5, 46.5, 45.5];
$low = [43.5, 44.5, 45.0, 44.0, 43.8];
$close = [44.8, 46.5, 45.5, 44.2, 44.0];
$result = trader_cdl2crows($open, $high, $low, $close);
if ($result === false) {
echo "Fehler: Muster konnte nicht berechnet werden.\n";
} else {
foreach ($result as $index => $value) {
if ($value !== 0) {
echo "Two-Crows-Muster bei Index $index erkannt: $value\n";
} else {
echo "Index $index: Kein Muster ($value)\n";
}
}
}Integration mit realen Kursdaten aus einer Datenbank
<?php
// Annahme: $rows enthält OHLC-Daten aus einer Datenbank-Abfrage
$rows = [
['open' => 100.0, 'high' => 105.0, 'low' => 99.0, 'close' => 104.0],
['open' => 105.0, 'high' => 108.0, 'low' => 104.5, 'close' => 107.5],
['open' => 109.0, 'high' => 110.0, 'low' => 106.0, 'close' => 106.5],
['open' => 108.0, 'high' => 109.5, 'low' => 105.0, 'close' => 105.5],
];
$open = array_column($rows, 'open');
$high = array_column($rows, 'high');
$low = array_column($rows, 'low');
$close = array_column($rows, 'close');
$signals = trader_cdl2crows($open, $high, $low, $close);
if ($signals === false) {
echo "Fehler bei der Mustererkennung.\n";
} else {
foreach ($signals as $i => $signal) {
if ($signal === -100) {
echo "Bearishes Two-Crows-Signal bei Kerze $i – mögliche Trendumkehr!\n";
}
}
echo "Analyse abgeschlossen. " . count($signals) . " Kerzen geprüft.\n";
}// Wichtig · Fallstricke
Voraussetzung: Die PHP-Erweiterung trader muss installiert und in der php.ini aktiviert sein (extension=trader). Sie basiert auf der Open-Source-Bibliothek TA-Lib.
Array-Längen: Alle vier Eingabe-Arrays (open, high, low, close) müssen exakt die gleiche Anzahl von Elementen aufweisen, andernfalls gibt die Funktion false zurück.
Lookback-Periode: Das Two-Crows-Muster benötigt mindestens 3 Kerzen. Die ersten Elemente des Ergebnis-Arrays sind daher immer 0. Mit trader_cdl2crows_lookback() lässt sich die genaue Lookback-Periode ermitteln.
Interpretation: Ein Wert von -100 ist ein bearishes Signal und sollte stets in Kombination mit weiteren Indikatoren (z. B. Volumen, RSI, MACD) bewertet werden, bevor Handelsentscheidungen getroffen werden.