Signatur
Beschreibung
Die Funktion trader_cdlmatchinglow ist Teil der PECL-Erweiterung Trader, die technische Analysefunktionen auf Basis der TA-Lib-Bibliothek bereitstellt. Sie analysiert Candlestick-Daten (Open, High, Low, Close) und erkennt darin das sogenannte Matching Low-Muster.
Das Matching Low ist ein bullisches Umkehrmuster, das aus zwei aufeinanderfolgenden Kerzen besteht. Beide Kerzen schließen auf demselben (oder nahezu demselben) Tiefstniveau. Das Muster signalisiert, dass der Markt auf einem Unterstützungsniveau Halt findet und eine mögliche Trendumkehr nach oben bevorsteht. Es tritt typischerweise nach einem Abwärtstrend auf.
Der Rückgabewert ist ein numerisches Array derselben Länge wie die Eingabearrays. Ein Wert von 100 an einer bestimmten Position zeigt ein bullisches Matching-Low-Muster an, während 0 bedeutet, dass an dieser Position kein Muster erkannt wurde. Negative Werte wären bärisch, kommen bei diesem Muster jedoch typischerweise nicht vor.
Die Funktion eignet sich für den Einsatz in automatisierten Trading-Systemen und Backtesting-Frameworks, in denen Candlestick-Muster programmatisch ausgewertet werden sollen.
Parameter
| Name | Typ | Default | Beschreibung |
|---|---|---|---|
| $open Pflicht | array | Array mit den Eröffnungskursen (Open) der Kerzen in chronologischer Reihenfolge. | |
| $high Pflicht | array | Array mit den Höchstkursen (High) der Kerzen in chronologischer Reihenfolge. | |
| $low Pflicht | array | Array mit den Tiefstkursen (Low) der Kerzen in chronologischer Reihenfolge. | |
| $close Pflicht | array | Array mit den Schlusskursen (Close) der Kerzen in chronologischer Reihenfolge. |
Rückgabewert
100 bedeutet, dass ein bullisches Matching-Low-Muster erkannt wurde; 0 bedeutet, dass kein Muster vorliegt. Bei einem Fehler (z. B. ungleich lange Eingabearrays oder nicht geladene Trader-Erweiterung) wird false zurückgegeben.Beispiele
Grundlegende Mustererkennung mit historischen Kursdaten
<?php
// Beispielhafte OHLC-Daten (z. B. Tageskerzen)
$open = [10.0, 9.5, 8.8, 8.2, 8.0];
$high = [10.5, 9.8, 9.1, 8.5, 8.4];
$low = [9.4, 8.9, 8.2, 7.8, 7.8];
$close = [9.6, 9.0, 8.4, 7.8, 7.8]; // Letzte zwei Kerzen schließen auf gleichem Tief
$result = trader_cdlmatchinglow($open, $high, $low, $close);
if ($result === false) {
echo "Fehler bei der Mustererkennung.\n";
} else {
foreach ($result as $index => $signal) {
if ($signal !== 0) {
echo "Matching Low erkannt an Position {$index}: Signalwert = {$signal}\n";
}
}
if (max($result) === 0) {
echo "Kein Matching-Low-Muster in den Daten gefunden.\n";
}
}Integration in ein einfaches Trading-Signal-System
<?php
// Simulierte Kursdaten über 10 Perioden
$open = [20.0, 19.5, 18.8, 18.0, 17.5, 17.0, 16.5, 16.0, 15.5, 15.5];
$high = [20.5, 19.8, 19.1, 18.5, 17.9, 17.4, 16.9, 16.4, 15.9, 15.9];
$low = [19.4, 18.9, 18.2, 17.6, 17.0, 16.5, 16.0, 15.5, 15.0, 15.0];
$close = [19.6, 19.0, 18.4, 17.8, 17.2, 16.6, 16.1, 15.5, 15.0, 15.0]; // Matching Low am Ende
$signals = trader_cdlmatchinglow($open, $high, $low, $close);
if (is_array($signals)) {
$lastIndex = count($signals) - 1;
if ($signals[$lastIndex] === 100) {
echo "Kaufsignal: Matching Low auf der letzten Kerze erkannt!\n";
echo "Schlusskurs: " . $close[$lastIndex] . "\n";
} else {
echo "Kein aktuelles Matching-Low-Signal.\n";
}
}// Wichtig · Fallstricke
Voraussetzung: Die PECL-Erweiterung trader muss installiert und in der php.ini aktiviert sein (extension=trader). Sie ist nicht Teil der Standard-PHP-Distribution.
Array-Längen: Alle vier Eingabearrays müssen dieselbe Anzahl an Elementen besitzen. Unterschiedliche Längen führen zu false als Rückgabewert.
Indexversatz: TA-Lib-Funktionen können einen sogenannten Lookback-Versatz erzeugen, d. h. die ersten Elemente des Rückgabe-Arrays können 0 sein, weil für die Berechnung nicht genügend vorangegangene Kerzen vorhanden sind. Beim Matching Low sind mindestens 2 Kerzen erforderlich.
Signalwerte: Typischerweise steht 100 für ein bullisches und -100 für ein bärisches Muster. Das Matching Low ist grundsätzlich ein bullisches Muster.