Start · Sprachen · PHP · Referenz · trader_cdlconcealbabyswall

trader_cdlconcealbabyswall

Funktion

Erkennt das Concealing-Baby-Swallow-Candlestick-Muster in OHLC-Kursdaten und gibt ein Array mit Signalwerten zurück.

Kategorie: math

Signatur

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

Beschreibung

Die Funktion trader_cdlconcealbabyswall() gehört zur TRADER-Erweiterung für PHP (basierend auf TA-Lib) und analysiert OHLC-Kerzendaten (Open, High, Low, Close) auf das Vorhandensein des Concealing Baby Swallow-Musters.

Das Concealing-Baby-Swallow ist ein bullisches Umkehrmuster, das aus vier aufeinanderfolgenden schwarzen (fallenden) Kerzen besteht. Die ersten beiden sind lange schwarze Marubozu-Kerzen ohne Schatten. Die dritte Kerze öffnet mit einem Gap nach unten, steigt jedoch im Verlauf der Session und hinterlässt einen oberen Schatten, der in den Körper der zweiten Kerze hineinragt. Die vierte Kerze eröffnet innerhalb der dritten und schließt unterhalb ihres Tiefs, umhüllt dabei vollständig die dritte Kerze. Dieses Muster zeigt an, dass der Verkaufsdruck nachlässt und eine Trendumkehr nach oben möglich ist.

Die Funktion gibt für jede Kerzenposition einen Integer-Wert zurück: 100 signalisiert ein erkanntes bullisches Muster, 0 bedeutet kein Muster. Die Ausgabe ist ein numerisches Array, das in Länge dem Eingabe-Array entspricht, wobei die ersten Einträge (Lookback-Periode) 0 sind.

Diese Funktion wird typischerweise im Bereich der technischen Analyse von Finanzdaten eingesetzt, z. B. beim automatisierten Backtesting von Handelsstrategien oder bei der Entwicklung von Trading-Signalgeneratoren.

Parameter

Name Typ Default Beschreibung
$open Pflicht array Numerisches Array mit den Eröffnungskursen (Open) der Kerzen, chronologisch geordnet.
$high Pflicht array Numerisches Array mit den Höchstkursen (High) der Kerzen, chronologisch geordnet.
$low Pflicht array Numerisches Array mit den Tiefstkursen (Low) der Kerzen, chronologisch geordnet.
$close Pflicht array Numerisches Array mit den Schlusskursen (Close) der Kerzen, chronologisch geordnet.

Rückgabewert

Typ
array
Beschreibung
Gibt ein numerisches Array zurück. Jeder Eintrag entspricht einer Kerze: 100 zeigt ein erkanntes bullisches Concealing-Baby-Swallow-Muster an, 0 bedeutet kein Muster. Die ersten Einträge (entsprechend der Lookback-Periode) sind immer 0. Im Fehlerfall (z. B. ungültige oder ungleich lange Arrays) wird false zurückgegeben.

Beispiele

Einfache Mustererkennung auf OHLC-Daten

<?php
// Beispielhafte OHLC-Daten (vereinfacht)
$open  = [50.0, 48.5, 47.0, 45.8, 44.5];
$high  = [51.0, 49.0, 48.5, 47.0, 47.2];
$low   = [49.0, 47.5, 45.0, 44.0, 43.8];
$close = [49.2, 47.8, 45.5, 44.2, 44.0];

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

if ($result === false) {
    echo 'Fehler bei der Berechnung.';
} else {
    foreach ($result as $index => $signal) {
        if ($signal !== 0) {
            echo "Concealing Baby Swallow erkannt bei Index $index (Signal: $signal)\n";
        }
    }
    echo 'Ergebnis-Array: ';
    print_r($result);
}
Ergebnis-Array: Array ( [0] => 0 [1] => 0 [2] => 0 [3] => 0 [4] => 0 )

Integration in eine einfache Trading-Signal-Pipeline

<?php
// Simulierte historische Kursdaten (z. B. aus einer Datenbank geladen)
$ohlc = [
    ['o' => 100.0, 'h' => 101.0, 'l' => 98.0,  'c' => 98.5],
    ['o' => 98.2,  'h' => 98.8,  'l' => 96.0,  'c' => 96.3],
    ['o' => 95.8,  'h' => 97.5,  'l' => 93.0,  'c' => 93.5],
    ['o' => 92.0,  'h' => 95.0,  'l' => 91.0,  'c' => 91.2],
    ['o' => 90.5,  'h' => 93.0,  'l' => 89.5,  'c' => 90.0],
];

$open  = array_column($ohlc, 'o');
$high  = array_column($ohlc, 'h');
$low   = array_column($ohlc, 'l');
$close = array_column($ohlc, 'c');

$signals = trader_cdlconcealbabyswall($open, $high, $low, $close);

if (is_array($signals)) {
    $lastIndex = count($signals) - 1;
    if ($signals[$lastIndex] === 100) {
        echo "Kaufsignal: Concealing Baby Swallow am letzten Datenpunkt erkannt!\n";
    } else {
        echo "Kein Concealing-Baby-Swallow-Muster am letzten Datenpunkt.\n";
    }
}
Kein Concealing-Baby-Swallow-Muster am letzten Datenpunkt.

// Wichtig · Fallstricke

Voraussetzung: Die PHP-TRADER-Erweiterung muss installiert und aktiviert sein (pecl install trader). Sie ist nicht standardmäßig in PHP enthalten.

Array-Längen: Alle vier Eingabe-Arrays ($open, $high, $low, $close) müssen exakt dieselbe Länge haben, sonst gibt die Funktion false zurück.

Lookback-Periode: Das Concealing-Baby-Swallow-Muster benötigt mindestens 4 Kerzen. Die ersten Einträge im Ergebnis-Array sind daher stets 0. Der genaue Lookback-Wert kann über trader_cdlconcealbabyswall_lookback() abgefragt werden, falls verfügbar.

Signalstärke: Der Rückgabewert 100 steht für ein bullisches Signal. Im Gegensatz zu einigen anderen Mustern gibt es hier kein bearisches Pendant (-100), da das Muster ausschließlich bullisch definiert ist.