Zum Inhalt

Chartshot-Methode

Dieser Leitfaden erklärt, wie Sie die Methode TakeChartshot() beim Erstellen von cTrader-Algos verwenden. Wenn Sie gleich loslegen möchten, lesen Sie einfach unsere einminütige Zusammenfassung unten.

Chartshot-Methoden in einer Minute!

  • Die Methode TakeChartshot() ermöglicht es cTrader-Algos, Chartshots der Charts zu erstellen, auf denen sie laufen, aber nur, wenn dieser Chart sichtbar ist.
  • Chartshots sind ein großartiges Tool, um mit anderen Händlern zu kommunizieren und technische Analysen zu teilen. Mit der Methode TakeChartshot() wird dieser Prozess viel einfacher.
  • Die Methode TakeChartshot() gibt ein Byte-Array zurück, was bedeutet, dass Sie Chartshots problemlos als .PNG-Dateien teilen können. Sie können den Chartshot auch im Internet teilen, indem Sie die Netzwerkzugriffsfunktion verwenden.
  • Die Methode TakeChartshot() ist unerlässlich, wenn Sie Chartshots erstellen möchten, wann immer Ihre Algos etwas tun (z. B. wenn ein cBot eine Order platziert). Diese Funktion bietet eine großartige visuelle Hilfe für jeden, der bewerten möchte, wie seine Lösungen funktionieren, ohne den Chart rund um die Uhr im Auge zu behalten.

Verwendung der Methode TakeChartshot()

Chartshots bieten eine Möglichkeit, schnell Screenshots von Handels-Charts zu erstellen. Wenn Sie einen Chartshot manuell über die cTrader-Symbolleiste erstellen, wird der Screenshot auf Ihrem lokalen Rechner gespeichert und zusätzlich automatisch auf ein spezielles Portal hochgeladen, das mehrere Möglichkeiten zum Teilen bietet (z. B. über einbettbaren HTML-Code).

Unsere API ermöglicht wiederum das automatische Erstellen von Chartshots. Im Gegensatz zu regulären Chartshots werden Chartshots, die von cTrader-Algos erstellt werden, standardmäßig nirgendwo gespeichert. Stattdessen werden solche Chartshots als Byte-Arrays zurückgegeben, die Sie frei speichern können, wo Sie möchten, indem Sie eine zusätzliche Aktion im Code angeben.

Die Methode byte[] TakeChartshot() funktioniert wie folgt:

  • byte[] TakeChartshot(). Erstellt einen Chartshot des Charts, auf dem der Algorithmus läuft, und gibt ihn als Byte-Array zurück.

Beachten Sie, dass die Methode nur funktioniert, wenn ein Chart sichtbar ist. Um die Chartsichtbarkeit einfach überprüfen zu können, enthält die Schnittstelle Chart die Eigenschaft IsVisible. Sie ist gleich true für einen sichtbaren Chart und false für einen unsichtbaren.

Chartshots beim Backtesting und bei der Optimierung

  • Bei der Optimierung und beim nicht-visuellen Backtesting gibt die Methode TakeChartshot() immer null zurück und ruft den Handler OnException() auf, falls Sie ihn angegeben haben.
  • Beim Backtesting im visuellen Modus funktioniert die Methode wie vorgesehen.

Beispiel-cBot erstellen

Um zu demonstrieren, wie das Erstellen von Chartshots funktioniert, erstellen wir einen einfachen cBot, der einen Chartshot des aktuellen Charts erstellt und ihn im Dateisystem Ihres lokalen Rechners speichert.

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
using System;
using System.IO;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using cAlgo.API;
using cAlgo.API.Collections;
using cAlgo.API.Indicators;
using cAlgo.API.Internals;

namespace cAlgo.Robots
{
    [Robot(AccessRights = AccessRights.FullAccess)]
    public class ChartshotTest : Robot
    {
        protected override void OnStart()
        {
            if (Chart.IsActive)
            {
                var chartshot = Chart.TakeChartshot();

                File.WriteAllBytes(@"D://examplePath/chartshot.png", chartshot);

            }
        }
    }
}

Beim Start wird die .PNG-Datei, die den Chartshot des Charts enthält, an den wir die cBot-Instanz angehängt haben, zu D://examplePath/ hinzugefügt.

Zusammenfassung

Die Methode TakeChartshot() ermöglicht es cTrader-Algos, einfach teilbare Chartshots zu erstellen, was sie für jeden unerlässlich macht, der Informationen mit anderen Händlern teilen oder verfolgen möchte, wie ihre automatisierten Lösungen auf bestimmte Bedingungen reagieren. Diese Methode ist auch beim visuellen Backtesting verwendbar und ermöglicht es Ihnen, die Aktionen Ihrer cBots einfach mit Ereignissen auf Charts abzugleichen.