Start · Sprachen · PHP · Referenz · trader_cdlladderbottom

trader_cdlladderbottom

Funktion

Erkennt das Ladder-Bottom-Candlestick-Muster in OHLC-Kursdaten und gibt ein Array mit Signalwerten zurück.

Kategorie: math

Signatur

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

Beschreibung

trader_cdlladderbottom ist Teil der TRADER-Erweiterung für PHP (basierend auf TA-Lib) und analysiert Kerzendiagramm-Daten (Open, High, Low, Close) auf das sogenannte Ladder Bottom-Muster. Dieses Muster ist ein bullisches Umkehrsignal, das aus fünf Kerzen besteht: drei fallende schwarze Kerzen mit aufeinanderfolgend niedrigeren Eröffnungs- und Schlusskursen, gefolgt von einer schwarzen Kerze mit einem aufwärts zeigenden Schatten (Upper Shadow) und schließlich einer weißen Kerze, die über dem Bereich der vorherigen Kerzen öffnet und schließt.

Die Funktion gibt für jeden berechneten Datenpunkt einen Integer-Wert zurück: 100 signalisiert eine bullische Erkennung des Musters, 0 bedeutet kein Muster erkannt. Aufgrund des Look-back-Zeitraums von TA-Lib enthält das Ergebnis-Array am Anfang möglicherweise weniger Elemente als die Eingabe-Arrays.

Das Ladder-Bottom-Muster wird in der technischen Analyse typischerweise als Hinweis auf eine bevorstehende Trendumkehr von abwärts nach aufwärts gewertet. Es eignet sich besonders für die Analyse von Tages- oder Wochencharts in Aktien-, Forex- oder Kryptomärkten.

Alle vier Eingabe-Arrays müssen dieselbe Länge haben und numerisch indiziert sein. Es empfiehlt sich, die Kursdaten chronologisch sortiert (älteste zuerst) zu übergeben, wie es TA-Lib erwartet.

Parameter

Name Typ Default Beschreibung
$open Pflicht array Array mit den Eröffnungskursen (Open) der Kerzen, chronologisch sortiert.
$high Pflicht array Array mit den Höchstkursen (High) der Kerzen, muss dieselbe Länge wie open haben.
$low Pflicht array Array mit den Tiefstkursen (Low) der Kerzen, muss dieselbe Länge wie open haben.
$close Pflicht array Array mit den Schlusskursen (Close) der Kerzen, muss dieselbe Länge wie open haben.

Rückgabewert

Typ
array|false
Beschreibung
Gibt ein Array mit Integer-Werten zurück, wobei 100 das Erkennen des Ladder-Bottom-Musters an der jeweiligen Position anzeigt und 0 kein Muster bedeutet. Bei einem Fehler (z. B. ungültige Eingabe-Arrays) wird false zurückgegeben. Das Ergebnis-Array kann kürzer sein als die Eingabe-Arrays, da TA-Lib einen Look-back-Zeitraum benötigt.

Beispiele

Einfaches Erkennen des Ladder-Bottom-Musters

<?php
// OHLC-Kursdaten (z. B. Tageskerzen)
$open  = [100, 98, 96, 94, 94, 97];
$high  = [101, 99, 97, 95, 96, 100];
$low   = [ 97, 95, 93, 91, 92,  96];
$close = [ 98, 96, 94, 92, 95,  99];

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

if ($result === false) {
    echo "Fehler bei der Berechnung.";
} else {
    foreach ($result as $index => $signal) {
        if ($signal !== 0) {
            echo "Ladder-Bottom erkannt an Index $index (Signal: $signal)\n";
        }
    }
    if (array_sum(array_map('abs', $result)) === 0) {
        echo "Kein Ladder-Bottom-Muster in den Daten erkannt.\n";
    }
}
Kein Ladder-Bottom-Muster in den Daten erkannt.

Integration in eine Marktanalyse mit realistischeren Daten

<?php
// Simulierte Kursdaten für eine Analyse
$open  = [50, 49, 48, 47, 47.5, 49.5];
$high  = [51, 50, 49, 48,   49,   52];
$low   = [48, 47, 46, 45, 45.5,   49];
$close = [49, 48, 47, 46,   49,   51];

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

if ($signals !== false) {
    $dates = ['2024-01-01','2024-01-02','2024-01-03','2024-01-04','2024-01-05','2024-01-06'];
    // TA-Lib gibt das Array mit Look-back-Offset zurück
    $offset = count($open) - count($signals);
    foreach ($signals as $i => $val) {
        $datum = $dates[$i + $offset] ?? 'unbekannt';
        if ($val !== 0) {
            echo "[$datum] Bullisches Umkehrsignal (Ladder Bottom) erkannt!\n";
        }
    }
} else {
    echo "Fehler: Ungültige Eingabedaten.\n";
}

// Wichtig · Fallstricke

Voraussetzung: Die PHP-Erweiterung trader muss installiert und in der php.ini aktiviert sein (extension=trader). Sie ist nicht standardmäßig in PHP enthalten und basiert auf der C-Bibliothek TA-Lib.

Look-back-Zeitraum: Das Ladder-Bottom-Muster benötigt mindestens 5 Kerzen. Das Ergebnis-Array kann daher weniger Einträge als die Eingabe-Arrays enthalten. Der Offset zwischen Eingabe und Ausgabe sollte beim Zuordnen der Signale zu Datumsangaben berücksichtigt werden.

Signalwerte: TA-Lib gibt für bullische Muster 100 und für bärische -100 zurück; bei diesem rein bullischen Muster erscheint nur 100 oder 0.