Signatur
Beschreibung
trader_cdlshortline ist Teil der TRADER-Erweiterung für PHP, die auf der TA-Lib-Bibliothek basiert. Die Funktion analysiert OHLC-Kursdaten (Open, High, Low, Close) und erkennt das Candlestick-Muster Short-Line-Kerze (Short Line Candle).
Eine Short-Line-Kerze ist eine Kerze mit einem kleinen Körper und kurzen oder gar keinen Dochten. Sie deutet auf ein kurzes Kursintervall in einer bestimmten Periode hin und kann je nach Marktkontext als neutrales Signal oder als Teil eines größeren Musters gewertet werden. Im Unterschied zur Long-Line-Kerze ist ihr Körper verhältnismäßig klein.
Die Rückgabewerte im Ergebnis-Array können folgende Werte annehmen: 100 (bullisches Muster erkannt), -100 (bearisches Muster erkannt) oder 0 (kein Muster erkannt). Das Array wird am Anfang mit 0-Werten aufgefüllt, um die Länge der Eingabearrays zu entsprechen.
Diese Funktion ist nützlich in der technischen Finanzanalyse, wenn man automatisiert Muster in historischen Kursdaten erkennen und daraus Handelssignale ableiten möchte.
Parameter
| Name | Typ | Default | Beschreibung |
|---|---|---|---|
| $open Pflicht | array | Array mit den Eröffnungskursen (Open) der einzelnen Zeitperioden als numerische Werte. | |
| $high Pflicht | array | Array mit den Höchstkursen (High) der einzelnen Zeitperioden als numerische Werte. | |
| $low Pflicht | array | Array mit den Tiefstkursen (Low) der einzelnen Zeitperioden als numerische Werte. | |
| $close Pflicht | array | Array mit den Schlusskursen (Close) der einzelnen Zeitperioden als numerische Werte. |
Rückgabewert
100 für ein bullisches Muster, -100 für ein bearisches Muster und 0 für kein erkanntes Muster. Im Fehlerfall (z. B. ungültige Eingaben oder fehlende TRADER-Erweiterung) wird false zurückgegeben.Beispiele
Einfache Erkennung von Short-Line-Kerzen
<?php
// Beispiel-OHLC-Daten (z. B. Tageskerzen)
$open = [44.50, 44.80, 45.10, 44.90, 45.00];
$high = [44.70, 44.95, 45.25, 45.05, 45.10];
$low = [44.40, 44.75, 45.00, 44.85, 44.95];
$close = [44.60, 44.85, 45.15, 44.95, 45.05];
$result = trader_cdlshortline($open, $high, $low, $close);
if ($result === false) {
echo 'Fehler bei der Berechnung oder TRADER-Erweiterung nicht geladen.';
} else {
foreach ($result as $index => $value) {
if ($value !== 0) {
$typ = $value > 0 ? 'Bullisch' : 'Bearisch';
echo "Periode $index: Short-Line-Kerze erkannt ($typ, Wert: $value)\n";
} else {
echo "Periode $index: Kein Muster\n";
}
}
}Kombination mit weiteren Candlestick-Mustern
<?php
// OHLC-Daten aus einer Datenbank oder API
$open = [100.0, 101.5, 101.8, 102.0, 101.9];
$high = [101.0, 102.0, 102.1, 102.3, 102.0];
$low = [99.5, 101.2, 101.6, 101.8, 101.8];
$close = [100.8, 101.7, 101.9, 102.1, 101.95];
$shortLine = trader_cdlshortline($open, $high, $low, $close);
$doji = trader_cdldoji($open, $high, $low, $close);
echo "Short-Line-Ergebnisse: ";
print_r($shortLine);
echo "Doji-Ergebnisse: ";
print_r($doji);// Wichtig · Fallstricke
Voraussetzung: Die TRADER-Erweiterung (php_trader) muss in PHP installiert und aktiviert sein. Sie ist nicht standardmäßig in PHP enthalten und muss über PECL installiert werden (pecl install trader).
Alle vier Eingabe-Arrays ($open, $high, $low, $close) müssen die gleiche Länge haben und numerische Werte enthalten. Andernfalls gibt die Funktion false zurück.
Das Ergebnis-Array hat dieselbe Länge wie die Eingabearrays. Die ersten Elemente können bedingt durch den Berechnungszeitraum den Wert 0 aufweisen (Lookback-Periode). Über trader_cdlshortline_lookback() lässt sich die Mindestanzahl benötigter Datenpunkte ermitteln.