Signatur
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
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";
}
}
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.