Signatur
Beschreibung
trader_cdlxsidegap3methods ist Teil der TRADER-Erweiterung (TA-Lib-Bindung für PHP) und analysiert eine Zeitreihe aus Eröffnungs-, Hoch-, Tief- und Schlusskursen auf das Upside/Downside-Gap Three Methods-Muster. Dieses dreiteilige Candlestick-Muster signalisiert eine Fortsetzung des bestehenden Trends.
Das Muster besteht aus zwei langen Kerzen in Trendrichtung, die eine Lücke (Gap) bilden, sowie einer dritten Kerze, die das Gap schließt, ohne den Trend umzukehren. Ein positiver Wert im Rückgabe-Array deutet auf ein bullisches (Upside) Muster hin, ein negativer Wert auf ein bärisches (Downside) Muster. Der Wert 0 bedeutet, dass an diesem Datenpunkt kein Muster erkannt wurde.
Diese Funktion eignet sich für technische Analysen im Finanzbereich, etwa bei der automatisierten Auswertung von Kerzencharts für Aktien, Forex oder Krypto-Assets. In Kombination mit anderen Indikatoren kann das erkannte Muster als Signal für Handelsentscheidungen genutzt werden.
Voraussetzung ist die aktivierte PECL-trader-Erweiterung. Alle vier Eingabe-Arrays müssen dieselbe Länge und identisch indexierte Zeitreihendaten enthalten.
Parameter
| Name | Typ | Default | Beschreibung |
|---|---|---|---|
| $open Pflicht | array | Array der Eröffnungskurse als numerisch indizierte float-Werte. |
|
| $high Pflicht | array | Array der Tageshöchstkurse als numerisch indizierte float-Werte. |
|
| $low Pflicht | array | Array der Tagestiefstkurse als numerisch indizierte float-Werte. |
|
| $close Pflicht | array | Array der Schlusskurse als numerisch indizierte float-Werte. |
Rückgabewert
100 zeigt ein bullisches Upside-Gap-Three-Methods-Muster an, -100 ein bärisches Downside-Muster, und 0 bedeutet kein erkanntes Muster. Die ersten Elemente können je nach Lookback-Periode wegfallen. Im Fehlerfall wird false zurückgegeben.Beispiele
Grundlegende Erkennung des Musters
<?php
// Beispielhafte OHLC-Daten (z. B. Tageskurse einer Aktie)
$open = [100.0, 105.0, 115.0, 112.0, 108.0, 120.0];
$high = [106.0, 110.0, 118.0, 116.0, 113.0, 125.0];
$low = [ 99.0, 104.0, 113.0, 110.0, 107.0, 119.0];
$close = [105.0, 109.0, 117.0, 111.0, 109.5, 124.0];
$result = trader_cdlxsidegap3methods($open, $high, $low, $close);
if ($result === false) {
echo "Fehler bei der Berechnung.\n";
} else {
foreach ($result as $index => $value) {
if ($value > 0) {
echo "Index $index: Bullisches Upside-Gap-Three-Methods-Muster erkannt.\n";
} elseif ($value < 0) {
echo "Index $index: Bärisches Downside-Gap-Three-Methods-Muster erkannt.\n";
}
}
}
?>Auswertung mit Kursdaten aus einer Datenbank
<?php
// Annahme: $rows enthält OHLC-Daten aus einer Datenbank-Abfrage
$rows = [
['open' => 50.0, 'high' => 52.0, 'low' => 49.5, 'close' => 51.5],
['open' => 51.5, 'high' => 54.0, 'low' => 51.0, 'close' => 53.5],
['open' => 56.0, 'high' => 58.0, 'low' => 55.5, 'close' => 57.5],
['open' => 55.0, 'high' => 57.0, 'low' => 54.0, 'close' => 56.0],
['open' => 54.0, 'high' => 56.5, 'low' => 53.5, 'close' => 55.5],
['open' => 58.0, 'high' => 60.0, 'low' => 57.5, 'close' => 59.5],
];
$open = array_column($rows, 'open');
$high = array_column($rows, 'high');
$low = array_column($rows, 'low');
$close = array_column($rows, 'close');
$signals = trader_cdlxsidegap3methods($open, $high, $low, $close);
if (is_array($signals)) {
foreach ($signals as $i => $signal) {
$richtung = match(true) {
$signal > 0 => 'Bullisch (Upside)',
$signal < 0 => 'Bärisch (Downside)',
default => 'Kein Muster',
};
echo "Kerze $i: $richtung\n";
}
}
?>// Wichtig · Fallstricke
Voraussetzung: Die PECL-trader-Erweiterung muss installiert und aktiviert sein. Ohne diese Erweiterung ist die Funktion nicht verfügbar.
Array-Länge: Alle vier Eingabe-Arrays müssen die gleiche Anzahl von Elementen besitzen. Unterschiedliche Längen führen zu einem Fehler (false als Rückgabewert).
Lookback-Periode: Für dieses Muster werden mindestens 3 Kerzen benötigt. Die ersten Einträge im Rückgabe-Array können fehlen oder als 0 ausgegeben werden, da nicht genügend Vorläuferdaten vorhanden sind.
Interpretationshinweis: Das Muster allein sollte nicht als alleiniges Handelssignal verwendet werden. Kombiniere es mit anderen Indikatoren (z. B. Volumen, RSI, gleitende Durchschnitte) für fundierte Entscheidungen.