Signatur
Beschreibung
Die Funktion trader_cdlinvertedhammer() ist Teil der PECL-Erweiterung Trader (Technical Analysis for Traders) und wertet Kerzenchart-Daten (OHLC: Open, High, Low, Close) aus, um das Inverted Hammer-Muster zu identifizieren. Ein Inverted Hammer ist ein bullisches Umkehrmuster, das nach einem Abwärtstrend auftritt und auf eine mögliche Trendwende nach oben hindeutet.
Das Muster zeichnet sich durch eine kleine Kerze mit einem langen oberen Docht und sehr wenig oder keinem unteren Docht aus. Der Körper der Kerze befindet sich am unteren Ende der Handelsspanne. Visuell ähnelt es einem umgedrehten Hammer, daher der Name.
Die Funktion gibt ein Array zurück, in dem jeder Eintrag den Wert 100 (bullisches Muster erkannt), -100 (bearisches Muster erkannt) oder 0 (kein Muster erkannt) enthält. Da für die Berechnung Lookback-Perioden benötigt werden, sind die ersten Elemente des Ergebnis-Arrays mit 0 gefüllt.
Diese Funktion eignet sich besonders für die automatisierte technische Analyse in Handelssystemen, Backtesting-Anwendungen oder zur Signalgenerierung in Kombination mit anderen Indikatoren.
Parameter
| Name | Typ | Default | Beschreibung |
|---|---|---|---|
| $open Pflicht | array | Array der Eröffnungskurse (Open) als numerisch indiziertes Float-Array. Alle vier Arrays müssen dieselbe Länge haben. | |
| $high Pflicht | array | Array der Tageshöchstkurse (High) als numerisch indiziertes Float-Array. | |
| $low Pflicht | array | Array der Tagestiefstkurse (Low) als numerisch indiziertes Float-Array. | |
| $close Pflicht | array | Array der Schlusskurse (Close) als numerisch indiziertes Float-Array. |
Rückgabewert
100 bedeutet, dass ein bullisches Inverted-Hammer-Muster erkannt wurde, 0 bedeutet, kein Muster wurde erkannt. Bei einem Fehler (z. B. Arrays unterschiedlicher Länge oder leere Eingaben) wird false zurückgegeben.Beispiele
Einfache Erkennung des Inverted-Hammer-Musters
<?php
// Beispiel-OHLC-Daten (z. B. Tageskerzen)
$open = [44.34, 44.09, 44.15, 43.61, 44.33, 44.83, 45.10, 45.15];
$high = [44.84, 44.34, 44.34, 44.33, 44.83, 45.10, 45.15, 45.50];
$low = [44.09, 43.61, 43.61, 43.02, 43.61, 44.33, 44.83, 44.98];
$close = [44.09, 44.15, 43.61, 44.33, 44.83, 45.10, 45.15, 45.30];
$result = trader_cdlinvertedhammer($open, $high, $low, $close);
if ($result === false) {
echo 'Fehler bei der Berechnung.';
} else {
foreach ($result as $index => $value) {
if ($value !== 0) {
echo "Index $index: Inverted Hammer erkannt (Wert: $value)\n";
}
}
if (array_sum(array_map('abs', $result)) === 0) {
echo 'Kein Inverted-Hammer-Muster in den Daten gefunden.';
}
}
?>Integration in eine technische Analyse-Pipeline
<?php
// Simulierte OHLC-Daten für mehrere Handelstage
$open = [50.00, 49.50, 48.80, 48.00, 47.50, 47.00, 47.20];
$high = [50.50, 49.80, 49.60, 48.20, 48.80, 48.50, 47.50];
$low = [49.40, 48.70, 48.00, 47.40, 47.00, 46.80, 47.00];
$close = [49.50, 48.80, 48.10, 47.50, 47.10, 47.20, 47.40];
$hammer = trader_cdlinvertedhammer($open, $high, $low, $close);
if ($hammer !== false) {
$dates = ['Mo', 'Di', 'Mi', 'Do', 'Fr', 'Sa', 'So'];
foreach ($hammer as $i => $signal) {
$tag = $dates[$i] ?? "Tag $i";
if ($signal === 100) {
echo "$tag: Bullisches Inverted-Hammer-Signal – potenzielle Kaufchance!\n";
} elseif ($signal === -100) {
echo "$tag: Bearisches Signal erkannt.\n";
}
}
} else {
echo 'Ungültige Eingabedaten.';
}
?>// Wichtig · Fallstricke
Voraussetzung: Die PECL-Erweiterung trader muss installiert und aktiviert sein (pecl install trader). Sie ist nicht Teil der Standard-PHP-Distribution.
Array-Längen: Alle vier Eingabe-Arrays (open, high, low, close) müssen exakt dieselbe Anzahl von Elementen aufweisen. Unterschiedliche Längen führen zu false als Rückgabewert.
Lookback-Periode: Die TA-Lib-Bibliothek, auf der trader basiert, benötigt eine bestimmte Mindestanzahl von Datenpunkten für die Mustererkennung. Die ersten Elemente des Ergebnis-Arrays werden daher immer 0 sein.
Interpretation: Ein Inverted-Hammer-Muster allein sollte nicht als alleiniges Handelssignal verwendet werden. Es empfiehlt sich, es mit Volumenanalyse, Trendbestätigung oder weiteren Indikatoren zu kombinieren.