Signatur
Beschreibung
Die Funktion trader_cdlunique3river() ist Teil der PECL-Erweiterung Trader und analysiert Kerzenchart-Daten (Open, High, Low, Close) auf das sogenannte Unique 3 River-Muster. Dieses ist ein seltenes bullisches Umkehrmuster, das aus drei Kerzen besteht und typischerweise am Ende eines Abwärtstrends auftritt.
Das Muster setzt sich wie folgt zusammen: Die erste Kerze ist eine lange schwarze (bearische) Kerze, die zweite ist ebenfalls bearisch aber kleiner mit einem neuen Tiefstkurs, und die dritte ist eine kleine weißte (bullische) Kerze, die innerhalb des Körpers der zweiten Kerze schließt. Dieses Zusammenspiel signalisiert eine mögliche Trendwende nach oben.
Der Rückgabewert ist ein Array mit den gleichen Indizes wie die Eingabe-Arrays. Erkannte Muster werden mit 100 (bullisch) kodiert; Werte von 0 bedeuten, dass an dieser Position kein Muster gefunden wurde.
Typische Anwendungsfälle sind die technische Analyse von Aktien-, Forex- oder Kryptowährungsdaten, bei denen Einstiegssignale für Long-Positionen gesucht werden.
Parameter
| Name | Typ | Default | Beschreibung |
|---|---|---|---|
| $open Pflicht | array | Array mit den Eröffnungskursen (Open) der Kerzen, indiziert von 0 bis n-1. |
|
| $high Pflicht | array | Array mit den Höchstkursen (High) der Kerzen. | |
| $low Pflicht | array | Array mit den Tiefstkursen (Low) der Kerzen. | |
| $close Pflicht | array | Array mit den Schlusskursen (Close) der Kerzen. |
Rückgabewert
100 signalisiert ein erkanntes bullisches Unique-3-River-Muster, 0 bedeutet kein Muster an dieser Position. Bei einem Fehler (z. B. ungültige Eingabedaten oder unterschiedliche Array-Längen) wird false zurückgegeben.Beispiele
Grundlegende Mustererkennung auf OHLC-Daten
<?php
// Beispiel-OHLC-Daten (z. B. Tageskerzen einer Aktie)
$open = [110.0, 108.0, 105.0, 106.0, 107.0];
$high = [112.0, 109.0, 107.0, 107.5, 109.0];
$low = [107.0, 103.0, 100.0, 104.0, 106.0];
$close = [108.0, 104.0, 101.0, 105.0, 108.5];
$result = trader_cdlunique3river($open, $high, $low, $close);
if ($result === false) {
echo 'Fehler bei der Berechnung.' . PHP_EOL;
} else {
foreach ($result as $index => $value) {
if ($value !== 0) {
echo "Unique-3-River-Muster erkannt bei Index $index (Wert: $value)" . PHP_EOL;
}
}
if (max($result) === 0) {
echo 'Kein Unique-3-River-Muster in den Daten gefunden.' . PHP_EOL;
}
}Integration in eine einfache Handelsanalyse
<?php
// Simulierte historische OHLC-Daten (z. B. aus einer Datenbank)
$open = [120.0, 115.0, 110.0, 112.0, 113.5, 118.0];
$high = [122.0, 116.0, 113.0, 114.0, 115.0, 120.0];
$low = [114.0, 108.0, 104.0, 110.0, 112.0, 117.0];
$close = [115.0, 109.0, 105.0, 113.0, 114.5, 119.0];
$pattern = trader_cdlunique3river($open, $high, $low, $close);
if (is_array($pattern)) {
$lastIndex = array_key_last($pattern);
if ($pattern[$lastIndex] === 100) {
echo 'Signal: Mögliche bullische Umkehr erkannt – Kaufsignal prüfen!' . PHP_EOL;
} else {
echo 'Kein Unique-3-River-Muster im letzten Datenpunkt.' . PHP_EOL;
}
} else {
echo 'Fehler bei der Mustererkennung.' . PHP_EOL;
}// Wichtig · Fallstricke
Voraussetzung: Die PECL-Erweiterung trader muss installiert und aktiviert sein (pecl install trader). Ohne diese Erweiterung steht die Funktion nicht zur Verfügung.
Array-Längen: Alle vier Eingabe-Arrays (open, high, low, close) müssen exakt die gleiche Anzahl an Elementen besitzen, andernfalls gibt die Funktion false zurück.
Seltenheit des Musters: Das Unique-3-River-Muster ist in realen Marktdaten sehr selten. Es sollte stets in Kombination mit anderen Indikatoren und Analysen verwendet werden und niemals als alleiniges Handelssignal dienen.
Keine Anlageberatung: Die Verwendung dieser Funktion in einem Handelssystem ersetzt keine professionelle Finanzberatung. Testergebnisse auf historischen Daten garantieren keine zukünftigen Gewinne.