Start · Sprachen · PHP · Referenz · trader_cdltakuri

trader_cdltakuri

Funktion

Erkennt das Takuri-Candlestick-Muster (Dragonfly Doji mit sehr langem unteren Schatten) in OHLC-Kursdaten.

Kategorie: math

Signatur

trader_cdltakuri(array $open, array $high, array $low, array $close): array

Beschreibung

Die Funktion trader_cdltakuri() ist Teil der PECL-Erweiterung Trader, die technische Analysefunktionen auf Basis der TA-Lib-Bibliothek bereitstellt. Sie analysiert Open-High-Low-Close-Kursdaten (OHLC) und erkennt das sogenannte Takuri-Muster – einen speziellen Candlestick, der auch als Dragonfly Doji mit besonders langem unterem Schatten bekannt ist.

Das Takuri-Muster entsteht, wenn Eröffnungs- und Schlusskurs annähernd gleich sind (Doji-Körper), der untere Schatten sehr lang ist und nahezu kein oberer Schatten vorhanden ist. Es tritt typischerweise am Ende eines Abwärtstrends auf und wird als potenzielles Umkehrsignal (bullish) interpretiert.

Der Rückgabewert ist ein Array mit Integer-Werten: 100 signalisiert das Auftreten des Musters an der entsprechenden Position, 0 bedeutet, dass das Muster nicht erkannt wurde. Negative Werte sind bei manchen Candlestick-Funktionen möglich, beim Takuri-Muster jedoch typischerweise nicht.

Die Funktion eignet sich besonders in Kombination mit Trendanalyse-Funktionen, um potenzielle Kaufsignale in Abwärtstrends zu identifizieren.

Parameter

Name Typ Default Beschreibung
$open Pflicht array Array der Eröffnungskurse als numerisch indiziertes Float-Array.
$high Pflicht array Array der Tageshöchstkurse als numerisch indiziertes Float-Array.
$low Pflicht array Array der Tagestiefstkurse als numerisch indiziertes Float-Array.
$close Pflicht array Array der Schlusskurse als numerisch indiziertes Float-Array.

Rückgabewert

Typ
array
Beschreibung
Gibt ein numerisch indiziertes Integer-Array zurück. Jeder Eintrag entspricht einer Kerze aus den Eingabedaten. 100 bedeutet, dass das Takuri-Muster an dieser Position erkannt wurde; 0 bedeutet, dass kein Muster vorliegt. Die ersten Einträge des Arrays können fehlen (Lookback-Periode), da die Mustererkennung eine Mindestanzahl vorheriger Datenpunkte benötigt.

Beispiele

Takuri-Muster in historischen Kursdaten erkennen

<?php
// Beispiel-OHLC-Daten (z. B. Tageskerzen)
$open  = [10.00, 10.50, 10.20, 10.10, 10.05];
$high  = [10.10, 10.60, 10.25, 10.15, 10.10];
$low   = [9.00,  10.00, 9.50,  9.00,  7.50];
$close = [10.05, 10.55, 10.22, 10.12, 10.08];

$result = trader_cdltakuri($open, $high, $low, $close);

foreach ($result as $index => $signal) {
    if ($signal !== 0) {
        echo "Takuri-Muster erkannt an Position {$index}: Signal = {$signal}\n";
    }
}
?>
Takuri-Muster erkannt an Position 4: Signal = 100

Kombination mit Trend-Überprüfung als Kaufsignal

<?php
// Simulierte OHLC-Kursdaten im Abwärtstrend
$open  = [15.00, 14.50, 14.00, 13.50, 13.20, 13.10, 13.05];
$high  = [15.10, 14.60, 14.10, 13.60, 13.25, 13.15, 13.08];
$low   = [14.80, 14.20, 13.70, 13.10, 12.00, 11.00, 10.50];
$close = [14.90, 14.45, 13.95, 13.45, 13.22, 13.12, 13.06];

$takuri = trader_cdltakuri($open, $high, $low, $close);

foreach ($takuri as $i => $signal) {
    if ($signal === 100) {
        echo "Mögliches bullishes Umkehrsignal (Takuri) an Kerze #{$i} erkannt.\n";
        echo "Close-Kurs: {$close[$i]}\n";
    }
}
?>
Mögliches bullishes Umkehrsignal (Takuri) an Kerze #6 erkannt. Close-Kurs: 13.06

// Wichtig · Fallstricke

Voraussetzung: Die PECL-Erweiterung trader muss installiert und aktiviert sein (pecl install trader sowie extension=trader.so in der php.ini).

Alle vier Eingabe-Arrays müssen dieselbe Länge haben und numerisch indiziert sein, andernfalls kann die Funktion fehlerhafte Ergebnisse liefern oder false zurückgeben.

Das Takuri-Muster gilt als bullishes Umkehrmuster; allein sollte es jedoch nicht als Handelssignal genutzt werden. Eine Bestätigung durch weitere technische Indikatoren (z. B. Volumenanalyse, RSI, gleitende Durchschnitte) wird dringend empfohlen.

Die Ergebnisse entsprechen den Berechnungen der TA-Lib-Bibliothek und können durch trader_set_unstable_period() beeinflusst werden, sofern ein Lookback-Zeitraum relevant ist.