Signatur
Beschreibung
trader_cdlgravestonedoji ist Teil der PECL-Erweiterung Trader, die auf der TA-Lib (Technical Analysis Library) basiert. Die Funktion analysiert OHLC-Kursdaten (Open, High, Low, Close) und erkennt das sogenannte Gravestone-Doji-Muster, ein einzelnes Candlestick-Muster aus der japanischen Candlestick-Analyse.
Ein Gravestone Doji entsteht, wenn Eröffnungs- und Schlusskurs nahezu identisch und sehr nah am Tagestief liegen, während der Kurs zwischenzeitlich deutlich nach oben ausgebrochen ist. Dieser lange obere Schatten mit nahezu keinem unteren Schatten signalisiert, dass Käufer zunächst die Kontrolle hatten, die Verkäufer am Ende jedoch die Oberhand gewannen – ein potenzielles Umkehrsignal nach oben.
Das Muster wird typischerweise als bärisches Umkehrsignal am Ende eines Aufwärtstrends interpretiert. Die Rückgabewerte sind 100 (bärisches Signal erkannt), -100 (bullisches Signal erkannt) oder 0 (kein Muster erkannt). In der Praxis liefert der Gravestone Doji fast ausschließlich 100.
Die Funktion eignet sich hervorragend zur Automatisierung technischer Analyse in Trading-Algorithmen, Backtesting-Systemen oder Charting-Anwendungen, die in PHP implementiert sind.
Parameter
| Name | Typ | Default | Beschreibung |
|---|---|---|---|
| $open Pflicht | array | Array mit Eröffnungskursen (numerisch indiziert, chronologisch aufsteigend). | |
| $high Pflicht | array | Array mit Tageshöchstkursen (numerisch indiziert, chronologisch aufsteigend). | |
| $low Pflicht | array | Array mit Tagestiefstkursen (numerisch indiziert, chronologisch aufsteigend). | |
| $close Pflicht | array | Array mit Schlusskursen (numerisch indiziert, chronologisch aufsteigend). |
Rückgabewert
100 (Muster erkannt, bärisch), -100 (bullisch) oder 0 (kein Muster) enthalten. Bei einem Fehler wird false zurückgegeben. Das Ausgabe-Array kann weniger Einträge enthalten als die Eingabe-Arrays, da TA-Lib einen sogenannten Lookback-Zeitraum benötigt.Beispiele
Gravestone-Doji-Muster in Kursdaten erkennen
<?php
// Beispiel-OHLC-Daten (z. B. Tageskerzen)
$open = [100.0, 102.0, 105.0, 105.5, 106.0];
$high = [103.0, 105.0, 110.0, 110.5, 112.0];
$low = [99.5, 101.0, 104.5, 105.0, 105.8];
$close = [102.0, 104.5, 105.1, 105.6, 106.0];
$result = trader_cdlgravestonedoji($open, $high, $low, $close);
if ($result === false) {
echo "Fehler bei der Berechnung.";
} else {
foreach ($result as $index => $value) {
if ($value !== 0) {
echo "Gravestone Doji erkannt an Index $index: Signal = $value\n";
}
}
if (array_sum(array_map('abs', $result)) === 0) {
echo "Kein Gravestone-Doji-Muster in den Daten gefunden.\n";
}
}Typisches Gravestone-Doji-Muster konstruieren und erkennen
<?php
// Konstruiertes Beispiel: Eröffnung ≈ Schluss ≈ Tief, langer oberer Schatten
// Letzte Kerze ist ein klassischer Gravestone Doji
$open = [100.0, 101.0, 102.0, 103.0, 105.00];
$high = [101.5, 102.5, 103.5, 104.5, 110.00];
$low = [99.5, 100.5, 101.5, 102.5, 104.98];
$close = [101.0, 102.0, 103.0, 104.0, 105.01];
$result = trader_cdlgravestonedoji($open, $high, $low, $close);
if (is_array($result)) {
echo "Ergebnisse:\n";
foreach ($result as $i => $signal) {
echo "Index $i: $signal\n";
}
} else {
echo "Berechnung fehlgeschlagen.\n";
}// Wichtig · Fallstricke
Voraussetzung: Die PECL-Erweiterung trader muss installiert und in der php.ini aktiviert sein (extension=trader). Sie ist nicht Teil des PHP-Kerns.
Array-Längen: Alle vier Eingabe-Arrays müssen dieselbe Länge haben, andernfalls gibt die Funktion false zurück.
Lookback: TA-Lib überspringt intern eine bestimmte Anzahl von Anfangswerten (Lookback). Das Ausgabe-Array kann daher kürzer sein als die Eingabe-Arrays; die Index-Zuordnung bleibt jedoch erhalten (Lücken am Anfang).
Interpretation: Das Gravestone-Doji-Muster ist allein kein zuverlässiges Handelssignal. Es sollte immer im Kontext des übergeordneten Trends und weiterer Indikatoren betrachtet werden, bevor Handelsentscheidungen getroffen werden.