trader_cdllongleggeddoji — Funktion · PHP-Referenz

Signatur

trader_cdllongleggeddoji(array $open, array $high, array $low, array $close): array

Beschreibung

Die Funktion trader_cdllongleggeddoji() ist Teil der TRADER-Erweiterung für PHP (basierend auf der TA-Lib) und analysiert OHLC-Kursdaten (Open, High, Low, Close) auf das Vorkommen des Long-Legged-Doji-Musters.

Ein Long-Legged-Doji ist eine spezielle Kerzenkonfiguration in der Candlestick-Analyse, bei der Eröffnungs- und Schlusskurs nahezu identisch sind (klassischer Doji), jedoch sowohl der obere als auch der untere Schatten (Wick) ungewöhnlich lang sind. Dies signalisiert eine extreme Unentschlossenheit am Markt: Trotz großer Preisschwankungen innerhalb der Periode kehrte der Kurs nahezu an den Ausgangspunkt zurück.

Das Muster wird häufig als potenzielles Umkehrsignal oder Warnsignal für eine bevorstehende Trendwende interpretiert, insbesondere wenn es an wichtigen Unterstützungs- oder Widerstandsniveaus auftritt. Die Funktion gibt für jede Kerze einen Wert zurück: 100 (bullisches Signal), -100 (bärisches Signal) oder 0 (kein Muster erkannt).

Die Funktion eignet sich für den Einsatz in automatisierten Trading-Systemen oder bei der technischen Chartanalyse zur schnellen Mustererkennung in historischen Kursreihen.

Parameter

Name	Typ	Beschreibung
$open Pflicht	array	Array der Eröffnungskurse (chronologisch geordnet) für die zu analysierenden Kerzen.
$high Pflicht	array	Array der Höchstkurse (chronologisch geordnet) für die zu analysierenden Kerzen.
$low Pflicht	array	Array der Tiefstkurse (chronologisch geordnet) für die zu analysierenden Kerzen.
$close Pflicht	array	Array der Schlusskurse (chronologisch geordnet) für die zu analysierenden Kerzen.

Rückgabewert

Typ

array

Beschreibung

Gibt ein Array mit ganzzahligen Werten zurück. Jeder Eintrag entspricht einer Kerze: 100 bedeutet, dass ein Long-Legged-Doji erkannt wurde (bullische Interpretation), -100 für eine bärische Ausprägung und 0 bedeutet, dass kein Muster erkannt wurde. Die ersten Elemente des Arrays können fehlen (Lookback-Periode), da die TA-Lib eine Mindestanzahl an Datenpunkten zur Berechnung benötigt.

Beispiele

Grundlegende Mustererkennung auf Tageskursen

<?php
// Beispiel-OHLC-Daten (z. B. Tageskerzen)
$open  = [100.0, 102.0, 101.5, 103.0, 102.0];
$high  = [105.0, 108.0, 115.0, 106.0, 107.0];
$low   = [ 95.0,  98.0,  88.0,  99.0,  96.0];
$close = [101.0, 102.5, 101.6, 104.0, 103.0];

$result = trader_cdllongleggeddoji($open, $high, $low, $close);

if ($result === false) {
    echo 'Fehler bei der Berechnung oder TRADER-Erweiterung nicht verfügbar.';
} else {
    foreach ($result as $index => $signal) {
        if ($signal !== 0) {
            echo "Kerze $index: Long-Legged-Doji erkannt (Signal: $signal)\n";
        } else {
            echo "Kerze $index: Kein Muster\n";
        }
    }
}

Kerze 0: Kein Muster Kerze 1: Kein Muster Kerze 2: Long-Legged-Doji erkannt (Signal: 100) Kerze 3: Kein Muster Kerze 4: Kein Muster

Integration in eine einfache Trading-Signal-Auswertung

<?php
// Simulierte OHLC-Daten über 7 Tage
$open  = [50.0, 51.0, 52.5, 53.0, 52.0, 54.0, 53.5];
$high  = [52.0, 53.5, 62.0, 56.0, 60.0, 57.0, 56.0];
$low   = [48.0, 49.5, 43.0, 50.0, 44.5, 51.0, 50.5];
$close = [51.0, 52.0, 52.6, 54.5, 52.1, 55.0, 54.0];

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

if (is_array($signals)) {
    $dates = ['Mo', 'Di', 'Mi', 'Do', 'Fr', 'Sa', 'So'];
    foreach ($signals as $i => $sig) {
        $label = match(true) {
             $sig > 0 => '⬆ Bullisches Long-Legged-Doji',
             $sig < 0 => '⬇ Bärisches Long-Legged-Doji',
            default   => '— Kein Signal',
        };
        echo ($dates[$i] ?? "Tag $i") . ": $label\n";
    }
}

Mo: — Kein Signal Di: — Kein Signal Mi: ⬆ Bullisches Long-Legged-Doji Do: — Kein Signal Fr: ⬆ Bullisches Long-Legged-Doji Sa: — Kein Signal So: — Kein Signal

// Wichtig · Fallstricke

Voraussetzung: Die Funktion ist nur verfügbar, wenn die PHP-TRADER-Erweiterung (php-trader) installiert und aktiviert ist. Diese basiert auf der TA-Lib (Technical Analysis Library). Ohne diese Erweiterung führt ein Aufruf zu einem fatalen Fehler.

Lookback-Periode: TA-Lib benötigt eine Mindestanzahl von Eingabewerten, um stabile Ergebnisse zu liefern. Für Candlestick-Muster-Erkennungsfunktionen werden typischerweise die ersten Elemente des Ergebnis-Arrays mit 0 gefüllt oder fehlen. Die genaue Lookback-Periode kann mit trader_cdllongleggeddoji_lookback() abgefragt werden, falls verfügbar.

Interpretation: Das Long-Legged-Doji-Signal allein ist kein zuverlässiges Handelssignal. Es sollte stets in Verbindung mit anderen Indikatoren (z. B. Volumen, Trendrichtung, Unterstützungs-/Widerstandslinien) bewertet werden.

Siehe auch

trader_cdldoji trader_cdldragonflydoji trader_cdlgravestonedoji trader_cdlspinningtop trader_cdlhammer