Signatur
Beschreibung
trader_cdlrisefall3methods ist Teil der PECL trader-Erweiterung und nutzt die TA-Lib, um das Rising Three Methods- bzw. Falling Three Methods-Muster in Candlestick-Kursdaten zu erkennen. Es handelt sich um ein fünfkerziges Fortsetzungsmuster: Eine lange Kerze in Trendrichtung, gefolgt von drei kleinen Gegenläuferkerzen innerhalb der ersten Kerze, abgeschlossen durch eine weitere große Kerze in der ursprünglichen Trendrichtung.
Das Rising Three Methods-Muster signalisiert eine bullische Fortsetzung: Die erste Kerze ist eine lange weiße (bullische) Kerze, die mittleren drei Kerzen sind klein und bearisch (aber innerhalb der Range der ersten Kerze), und die letzte Kerze schließt über dem Hoch der ersten Kerze. Das Falling Three Methods-Muster ist das spiegelbildliche bearische Pendant.
Die Funktion gibt für jeden Datenpunkt einen Integer zurück: 100 für ein bullisches Signal (Rising Three Methods), -100 für ein bearisches Signal (Falling Three Methods) oder 0, wenn kein Muster erkannt wurde. Die Ausgabe ist ein Array, das in seiner Länge dem Eingabe-Array entspricht, wobei die ersten Elemente aufgrund der Berechnungsperiode 0 sind.
Diese Funktion ist besonders nützlich für die automatisierte technische Analyse und kann in Handelssystemen eingesetzt werden, um Trendfortsetzungssignale zu identifizieren.
Parameter
| Name | Typ | Default | Beschreibung |
|---|---|---|---|
| $open Pflicht | array | Array der Eröffnungskurse (numerisch indiziert, chronologisch aufsteigend). | |
| $high Pflicht | array | Array der Tageshöchstkurse (numerisch indiziert, gleiche Länge wie open). |
|
| $low Pflicht | array | Array der Tagestiefstkurse (numerisch indiziert, gleiche Länge wie open). |
|
| $close Pflicht | array | Array der Schlusskurse (numerisch indiziert, gleiche Länge wie open). |
Rückgabewert
100 für ein erkanntes bullisches Rising Three Methods-Muster, -100 für ein bearisches Falling Three Methods-Muster und 0 für keine Erkennung. Bei einem Fehler (z. B. ungültige Eingabedaten) wird false zurückgegeben.Beispiele
Einfache Mustererkennung mit OHLC-Kursdaten
<?php
// Voraussetzung: PECL trader-Erweiterung ist installiert
// Beispiel-OHLC-Daten (typischerweise aus einer Datenbank oder API)
$open = [44.0, 43.5, 43.8, 43.6, 43.7, 45.0];
$high = [45.5, 44.2, 44.5, 44.3, 44.6, 47.0];
$low = [43.8, 43.2, 43.5, 43.1, 43.4, 44.8];
$close = [45.2, 43.8, 44.0, 43.9, 44.1, 46.8];
$result = trader_cdlrisefall3methods($open, $high, $low, $close);
if ($result === false) {
echo 'Fehler bei der Berechnung.' . PHP_EOL;
} else {
foreach ($result as $index => $value) {
if ($value === 100) {
echo "Index {$index}: Rising Three Methods (bullisch) erkannt" . PHP_EOL;
} elseif ($value === -100) {
echo "Index {$index}: Falling Three Methods (bearisch) erkannt" . PHP_EOL;
}
}
echo 'Keine Muster in den Beispieldaten erkannt (zu wenig/falsche Daten).' . PHP_EOL;
}Integration in eine Handelsstrategie mit größerem Datensatz
<?php
// Realistischeres Szenario: Kursdaten aus einer Datenquelle
function fetchOHLC(): array {
// Simulierte Kursdaten (in Produktion: aus DB oder API)
return [
'open' => [10, 10.5, 11, 10.8, 10.9, 11.1, 9.5, 9.3, 9.4, 9.2],
'high' => [11, 11.2, 11.3, 11.0, 11.1, 12.5, 9.8, 9.6, 9.7, 8.5],
'low' => [9.8, 10.3, 10.8, 10.5, 10.6, 11.0, 9.0, 9.0, 9.1, 8.2],
'close' => [10.5, 11.0, 10.9, 10.8, 11.0, 12.3, 9.3, 9.4, 9.2, 8.3],
];
}
$data = fetchOHLC();
$result = trader_cdlrisefall3methods(
$data['open'],
$data['high'],
$data['low'],
$data['close']
);
if ($result !== false) {
$signals = array_filter($result, fn($v) => $v !== 0);
if (empty($signals)) {
echo 'Kein Rising/Falling Three Methods-Muster gefunden.' . PHP_EOL;
} else {
foreach ($signals as $idx => $sig) {
$type = $sig > 0 ? 'Bullisch (Rising Three Methods)' : 'Bearisch (Falling Three Methods)';
echo "Signal bei Kerze #{$idx}: {$type}" . PHP_EOL;
}
}
}// Wichtig · Fallstricke
Voraussetzung: Die PECL trader-Erweiterung muss installiert und aktiviert sein (pecl install trader + extension=trader.so in der php.ini). Die Funktion ist nicht im PHP-Kern enthalten.
Datenmenge: Für eine sinnvolle Erkennung werden mindestens 5 Datenpunkte benötigt (das Muster besteht aus 5 Kerzen). Bei sehr kurzen Arrays wird das Ergebnis-Array überwiegend aus 0-Werten bestehen.
Array-Indizes: Die Eingabe-Arrays sollten numerisch und lückenlos indiziert sein. Lücken oder nicht-numerische Schlüssel können zu unerwarteten Ergebnissen führen.
Kein Finanzrat: Die Funktion liefert rein technische Signale. In realen Handelssystemen sollten diese stets mit weiteren Indikatoren und Risikomanagement kombiniert werden.