trader_cdl3starsinsouth — Funktion · PHP-Referenz

Signatur

trader_cdl3starsinsouth(array $open, array $high, array $low, array $close): array|false

Beschreibung

trader_cdl3starsinsouth ist Teil der TRADER-Erweiterung (TA-Lib-Bindings für PHP) und analysiert Kerzendiagramm-Daten auf das Three Stars in the South-Muster. Dieses seltene bullische Umkehrmuster besteht aus drei aufeinanderfolgenden schwarzen (bearischen) Kerzen, deren Körper und Schatten sukzessive kleiner werden, was auf nachlassenden Verkaufsdruck und eine potenzielle Trendwende nach oben hindeutet.

Die Funktion akzeptiert vier Arrays mit den OHLC-Werten (Open, High, Low, Close) und gibt ein Array zurück, dessen Werte für jede Kerzenposition entweder 100 (bullisches Muster erkannt), -100 (bearisches Muster erkannt) oder 0 (kein Muster) enthalten. Die Ausgabe ist auf denselben Index-Bereich wie die Eingabedaten abgestimmt.

Das Muster wird typischerweise in der technischen Analyse eingesetzt, um am Ende eines Abwärtstrends frühzeitig Einstiegssignale zu identifizieren. Es sollte jedoch stets in Kombination mit weiteren Indikatoren und Volumenanalysen verwendet werden, da es in der Praxis sehr selten auftritt und gelegentlich zu Fehlsignalen führen kann.

Voraussetzung ist die installierte PECL trader-Erweiterung, die TA-Lib intern nutzt.

Parameter

Name	Typ	Beschreibung
$open Pflicht	array	Numerisches Array mit den Eröffnungskursen (Open) der Kerzen in chronologischer Reihenfolge.
$high Pflicht	array	Numerisches Array mit den Höchstkursen (High) der Kerzen in chronologischer Reihenfolge.
$low Pflicht	array	Numerisches Array mit den Tiefstkursen (Low) der Kerzen in chronologischer Reihenfolge.
$close Pflicht	array	Numerisches Array mit den Schlusskursen (Close) der Kerzen in chronologischer Reihenfolge.

Rückgabewert

Typ

array|false

Beschreibung

Gibt ein numerisches Array zurück, das für jede Kerzenposition den Musterstatus enthält: 100 für ein bullisches Three-Stars-in-the-South-Muster, 0 für kein erkanntes Muster. Bei einem Fehler (z. B. unterschiedlich lange Eingabe-Arrays oder fehlenden Daten) wird false zurückgegeben.

Beispiele

Einfache Mustererkennung auf historischen Kursdaten

<?php
// Beispielhafte OHLC-Daten (z. B. Tageskerzen eines Abwärtstrends)
$open  = [50.0, 48.5, 46.0, 44.0, 43.0, 42.5, 41.0];
$high  = [51.0, 49.5, 47.0, 45.0, 44.0, 43.0, 42.0];
$low   = [47.0, 46.0, 44.5, 42.0, 41.5, 41.0, 40.8];
$close = [48.0, 47.0, 45.0, 43.0, 42.0, 41.5, 41.0];

$result = trader_cdl3starsinsouth($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 an Position $index: Signalwert = $signal\n";
        }
    }
    if (empty(array_filter($result))) {
        echo "Kein Three-Stars-in-the-South-Muster in den Daten gefunden.\n";
    }
}

Kein Three-Stars-in-the-South-Muster in den Daten gefunden.

Integration in eine Kursanalyse-Pipeline

<?php
// Kursdaten aus einer Datenbank oder API laden (hier exemplarisch)
$candles = [
    ['o' => 100.0, 'h' => 102.0, 'l' => 96.0,  'c' => 97.0],
    ['o' => 97.0,  'h' => 98.5,  'l' => 93.0,  'c' => 94.0],
    ['o' => 94.0,  'h' => 95.0,  'l' => 91.5,  'c' => 92.0],
    ['o' => 92.0,  'h' => 93.0,  'l' => 90.0,  'c' => 90.5],
    ['o' => 90.5,  'h' => 91.0,  'l' => 89.5,  'c' => 90.0],
];

$open  = array_column($candles, 'o');
$high  = array_column($candles, 'h');
$low   = array_column($candles, 'l');
$close = array_column($candles, 'c');

$signals = trader_cdl3starsinsouth($open, $high, $low, $close);

if (is_array($signals)) {
    $lastSignal = end($signals);
    if ($lastSignal === 100) {
        echo "Letztes Signal: Bullische Umkehr (Three Stars in the South) erkannt!\n";
    } else {
        echo "Kein aktuelles Muster erkannt. Letzter Signalwert: $lastSignal\n";
    }
}

Kein aktuelles Muster erkannt. Letzter Signalwert: 0

// Wichtig · Fallstricke

Seltenheit des Musters: Three Stars in the South ist eines der seltensten Candlestick-Muster. In realen Datensätzen wird es kaum auftreten, weshalb Fehlsignale bei kurzen Datensätzen wahrscheinlicher sind.

Array-Längen: Alle vier Eingabe-Arrays müssen dieselbe Länge haben. Unterschiedliche Längen führen zur Rückgabe von false.

Lookback-Periode: TA-Lib benötigt eine Mindestanzahl an Datenpunkten (Lookback), bevor das erste Ergebnis berechnet werden kann. Die ersten Elemente des Ergebnis-Arrays können daher 0 sein, auch wenn keine Musterbedingung geprüft wurde.

Kein Ersatz für vollständige Analyse: Candlestick-Muster allein sind kein verlässliches Handelssignal. Kombination mit Volumen, Trendfiltern und weiteren Indikatoren wird dringend empfohlen.

Siehe auch

trader_cdl3blackcrows trader_cdlmorningstar trader_cdlhammer trader_cdl3outside trader_cdl3inside