Einführung

Willkommen bei Spaike – dem professionellen Options-Backtesting-Tool für ambitionierte Trader. Diese Dokumentation erklärt dir alle Funktionen der Plattform im Detail.

Was ist Spaike?

Spaike ist eine webbasierte Plattform zum Backtesten von Options-Strategien. Die Plattform ermöglicht es dir, komplexe Multi-Leg-Strukturen zu definieren und gegen historische Marktdaten zu testen.

Kernkonzepte

Bevor du mit Spaike arbeitest, solltest du die grundlegenden Konzepte verstehen:

Strategie

Eine Strategie ist der oberste Container in Spaike. Sie definiert das Underlying-Symbol (z.B. SPXW für SPX Weekly Options), den Backtest-Zeitraum und globale Einstellungen wie Handelsgebühren. Eine Strategie enthält eine oder mehrere Leg Groups.

Leg Group

Eine Leg Group ist ein Container für zusammengehörige Options-Positionen. Zum Beispiel bildet ein Put Credit Spread eine Leg Group mit zwei Legs (Short Put + Long Put). Leg Groups haben eigene Exit-Regeln wie Stop Loss und Take Profit, die für alle enthaltenen Legs gelten.

Leg

Ein Leg repräsentiert eine einzelne Options-Position innerhalb einer Leg Group. Jedes Leg definiert:

• Execution Type: Sell (Short) oder Buy (Long)
• Option Type: Put (P) oder Call (C)
• Strike-Auswahl: Nach Delta, Prämie oder Offset

Indikator

Indikatoren steuern, wann Trades eröffnet werden. Sie können zeitbasiert sein (z.B. "Jeden Tag um 10:00 Uhr") oder auf Marktdaten basieren (z.B. "Wenn VIX unter 20"). Indikatoren können auch per KI generiert werden.

Backtest Run

Ein Run ist die Ausführung eines Backtests. Dabei wird die Strategie gegen historische Daten getestet. Nach Abschluss stehen detaillierte Statistiken und Charts zur Verfügung.

Unterstützte Underlyings

Spaike unterstützt aktuell folgende Options-Symbole:

Dashboard Übersicht

Nach dem Login landest du auf dem Dashboard. Hier siehst du alle deine Strategien als Karten (Cards) angeordnet und kannst direkt auf alle wichtigen Funktionen zugreifen.

Header-Leiste

Die Header-Leiste am oberen Bildschirmrand ist immer sichtbar und enthält:

• Logo und Titel: Klick darauf kehrt zum Dashboard zurück
• Theme Toggle: Schaltet zwischen Light und Dark Mode um (wird im Browser gespeichert)
• Avatar: Zeigt die ersten 2 Buchstaben deines Benutzernamens. Klick öffnet das Dropdown mit Logout-Option

Strategie-Grid

Die Hauptansicht zeigt alle deine Strategien als responsive Karten-Grid. Wenn du noch keine Strategien hast, siehst du einen Empty State mit der Aufforderung, deine erste Strategie zu erstellen.

Strategie-Karte

Jede Strategie wird als Karte dargestellt mit folgenden Elementen:

Quick-Action Buttons

Oben rechts auf jeder Karte befinden sich Icon-Buttons für schnelle Aktionen:

Portfolios-Bereich

Unterhalb des Strategie-Grids befindet sich der Portfolios-Bereich. Hier kannst du:

• Portfolios erstellen, um mehrere Runs zu kombinieren
• Aggregierte Statistiken über mehrere Strategien sehen
• Portfolio-Details und Charts aufrufen

KI-Agent Button

In der unteren rechten Ecke befindet sich ein schwebender Button für den KI-Agenten. Klicke darauf, um den Agenten zu öffnen. Der KI-Agent hat vollen Zugriff auf das gesamte Backtest-System und kann Strategien erstellen, bearbeiten, Backtests starten und Ergebnisse analysieren.

Dark Mode

Der Theme Toggle in der Header-Leiste schaltet zwischen Light Mode und Dark Mode um. Die Einstellung wird im Browser (localStorage) unter dem Schlüssel bbt.ui.theme gespeichert und beim nächsten Besuch automatisch wiederhergestellt.

Strategien – Übersicht

Eine Strategie ist der oberste Container für deine Options-Trades. Sie definiert das Underlying, den Backtest-Zeitraum und enthält eine oder mehrere Leg Groups.

Neue Strategie anlegen

Im Dashboard-Header findest du den Button "Neue Strategie". Klicke darauf, um das Modal zum Erstellen einer neuen Strategie zu öffnen.

Pflichtfelder im Erstellungs-Modal

1. 1

   Modal öffnen

   Klicke auf "Neue Strategie" im Dashboard-Header.

2. 2

   Name eingeben

   Gib einen Namen ein, z.B. "Iron Condor Strategy" oder "Put Credit Spread Daily".

3. 3

   Underlying wählen

   Wähle das Underlying aus dem Dropdown. Standard ist SPXW.

4. 4

   Speichern

   Klicke auf "Speichern". Die neue Strategie erscheint als Karte im Dashboard.

Strategie-Detailansicht

Klicke auf eine Strategie-Karte im Dashboard, um die Detailansicht zu öffnen. Diese ist in zwei Bereiche unterteilt:

Linker Bereich: Dynamische Panels

Hier werden die Legs-Panels und Trigger-Panels angezeigt. Diese erscheinen erst, wenn du eine Leg Group auswählst (Legs) oder einen Indikator hast (Triggers).

Rechter Bereich: Accordions

Der rechte Bereich enthält aufklappbare Accordion-Sektionen:

• Strategy Settings: Globale Einstellungen für die Strategie
• Leg Groups: Verwaltung der Options-Strukturen
• Indicators: Verwaltung der Entry-Indikatoren
• Runs: Übersicht aller Backtest-Runs dieser Strategie

Strategien – Einstellungen

Die Strategy Settings definieren alle globalen Parameter für den Backtest. Öffne das "Strategy Settings" Accordion in der Strategie-Detailansicht, um die Einstellungen zu bearbeiten.

Symbol

Das Symbol legt fest, auf welches Underlying der Backtest läuft. Es kann beim Erstellen der Strategie oder nachträglich über den Edit-Button (Stift-Icon) auf der Strategie-Karte geändert werden.

Backtest-Zeitraum

Der Zeitraum legt fest, über welchen historischen Bereich der Backtest läuft. Es müssen Options-Daten für den gewählten Zeitraum und das gewählte Symbol vorhanden sein.

Trade Fee per Leg ($)

Die Handelsgebühr wird pro Leg und pro Trade-Seite (Entry und Exit) berechnet. Sie simuliert reale Broker-Kosten und wird vom P&L abgezogen.

Use Margin

Aktiviert die Margin-Berechnung für den Backtest. Wenn aktiv, prüft Spaike vor jedem Trade-Einstieg, ob genügend freies Margin für die neue Position vorhanden ist. Ist kein ausreichendes Margin verfügbar, wird kein Trade eröffnet.

Wenn "Use Margin" aktiviert ist, werden folgende Unter-Einstellungen sichtbar:

Leg Groups – Übersicht

Eine Leg Group ist ein Container für zusammengehörige Options-Positionen. Alle Legs einer Leg Group werden gemeinsam eröffnet, teilen sich die gleiche Expiration und haben gemeinsame Exit-Regeln. Eine Strategie kann mehrere Leg Groups haben – z.B. eine für die Put-Seite und eine für die Call-Seite eines Iron Condors.

Leg Group erstellen

In der Strategie-Detailansicht, öffne das "Leg Groups" Accordion und klicke auf "Leg Group hinzufügen".

Typische Strukturen

Leg Groups – Einstellungen

Jede Leg Group hat eigene Parameter, die beim Erstellen oder Bearbeiten gesetzt werden.

Name

Ein beschreibender Name für die Leg Group, z.B. "Put Credit Spread" oder "Iron Condor Put Side".

Contracts

Die Anzahl der Kontrakte, die für alle Legs dieser Leg Group gehandelt werden.

Min DTE / Max DTE

Exit-Conditions

Exit-Conditions bestimmen, wann alle Legs der Leg Group gemeinsam geschlossen werden. Mehrere Exit-Conditions können gleichzeitig aktiv sein – die Position wird geschlossen, sobald eine der Bedingungen erfüllt ist.

Slippage

Wenn die Leg Group durch eine Exit-Condition (z.B. Stop Loss oder Early Exit) vorzeitig geschlossen wird, wird der hier angegebene Slippage-Betrag bei jedem Schließen vom Preis abgezogen. Dieser Wert simuliert die Abweichung zwischen dem theoretischen Schlusskurs und dem tatsächlich erzielten Preis in der Praxis.

Erweiterte Optionen

Entry Filter

Der Entry Filter ermöglicht es, Einstiege der Leg Group nach dem Gesamt-Premium (Credit) zu filtern. Wenn der erhaltene Credit beim Einstieg außerhalb des definierten Min/Max-Bereichs liegt, wird der Trade nicht eröffnet. So lassen sich schlechte Marktbedingungen herausfiltern.

Use High, Low and NBBO Extreme

Steuert, welche Preisdaten für die Überprüfung von Stop Loss und Take Profit herangezogen werden. Erklärung dieser Einstellungen folgt in Kürze.

Allow Stop Loss / Take Profit in Entry Minute

Legt fest, ob ein Stop Loss oder Take Profit in derselben Minute ausgelöst werden darf, in der der Trade eröffnet wurde. Wenn deaktiviert, wird die Exit-Prüfung in der Einstiegsminute übersprungen – der Trade bleibt mindestens bis zur nächsten Minute offen.

Legs – Übersicht

Ein Leg repräsentiert eine einzelne Options-Position innerhalb einer Leg Group. Alle Legs einer Leg Group werden gemeinsam eröffnet und teilen sich die gleiche Expiration. Jedes Leg definiert eigenständig seine Option (Call/Put, Strike, Buy/Sell) und optional eigene Exit-Regeln.

Leg erstellen

Klicke auf eine Leg Group in der Liste. Im linken Panel erscheint das Legs-Formular. Klicke auf "+ Leg hinzufügen", um ein neues Leg zu erstellen.

Legs – Einstellungen

Jedes Leg definiert eine konkrete Options-Position innerhalb einer Leg Group. Hier werden Richtung, Optionstyp, Strike-Auswahl-Kriterium, Exit-Conditions und erweiterte Optionen konfiguriert.

Execution

Bestimmt die Handelsrichtung des Legs.

Type

Bestimmt den Optionstyp des Legs.

Criterion

Das Criterion legt fest, nach welchem Kriterium der Strike für das Leg ausgewählt wird.

Exit-Conditions

Exit-Conditions auf Leg-Ebene funktionieren identisch zu den Exit-Conditions der Leg Group, wirken jedoch nur auf dieses einzelne Leg. Stop Loss, Take Profit, Early Exit, In the Money Protection, DSL-Exit und Value Based Exit stehen zur Verfügung.

Advanced Options

Entry Filter

Auf Leg-Ebene kann ein Entry Filter gesetzt werden, der den Einstieg auf Basis der Prämie des einzelnen Legs filtert. Die Leg Group wird nur eröffnet, wenn das Leg eine Prämie innerhalb des angegebenen Min/Max-Bereichs hat.

Use High, Low

Use NBBO Extreme

Indikatoren – Übersicht

Indikatoren steuern, wann eine Strategie einen Trade eröffnet. Jede Strategie benötigt mindestens einen Indikator mit mindestens einem Trigger, damit Trades ausgeführt werden. Ohne aktiven Indikator werden keine Trades geöffnet.

Indikator und Trigger

Ein Indikator allein öffnet noch keine Trades – dafür braucht jeder Indikator mindestens einen Trigger. Der Trigger definiert den genauen Zeitpunkt oder die genaue Bedingung, bei der ein Trade eröffnet wird. Erst das Zusammenspiel von Indikator und Trigger ergibt einen vollständigen Einstiegspunkt.

Indikator-Typen

Indicator

Der einfachste Indikator-Typ. Er enthält keine eigene Berechnungslogik und ist ideal für zeit- oder datumsbasierte Einstiege. Der Indikator dient als Container für Trigger – die eigentliche Einstiegslogik liegt vollständig im Trigger. Für die meisten 0DTE-Strategien mit festen Einstiegszeiten ist dieser Typ die erste Wahl.

DSL-Indikator

Der DSL-Indikator ist der leistungsstärkste Typ. Er berechnet anhand einer frei definierbaren Expression einen Wert pro Minute, auf den Trigger dann reagieren können. Die DSL (Domain Specific Language) wird als JSON-Objekt hinterlegt.

Data-Indikator

Der Data-Indikator greift auf vorberechnete Marktdaten-Reihen zu, wie gleitende Durchschnitte (EMA, SMA) oder Volatilitätskennzahlen. Trigger auf diesem Indikator können dann auf diese Datenpunkte reagieren – z.B. "Steige ein, wenn EMA20 über EMA40 liegt".

Presets

Im oberen Bereich der Indikatoren-Ansicht stehen fertige Einstiegs-Patterns als Presets zur Auswahl. Diese decken gängige Strategien wie feste Einstiegszeiten, Gap-Bedingungen oder Moving-Average-Crosses ab und können direkt übernommen und angepasst werden – ohne eigene DSL-Definition.

Indikatoren – Einstellungen

Beim Erstellen eines Indikators werden zuerst Name und Typ festgelegt. Abhängig vom gewählten Typ stehen dann zusätzliche Einstellungen zur Verfügung.

Basis-Parameter

DataIndicator – Verfügbare Datenquellen

Der DataIndicator greift auf vorberechnete Marktdaten-Reihen zu. Beim Erstellen wird die gewünschte Datenquelle ausgewählt.

Indicator – Manuelle Werte (Indicator Values)

Für den Indicator-Typ können manuelle Werte eingegeben werden. Diese Values definieren, zu welchen Zeitpunkten der Indikator welchen Wert hat. Klicke auf einen existierenden Indicator in der Liste. Im "Indicator Values" Panel kannst du:

• Neue Values mit Timestamp und Wert hinzufügen
• Existierende Values bearbeiten oder löschen
• Values per KI generieren lassen

DslIndicator – KI-Agent

Mit dem integrierten KI-Agenten kannst du DSL-Indikatoren automatisch generieren lassen. Der Agent versteht natürliche Sprache und kann komplexe Logik in Indikatoren umsetzen.

Nutze den KI-Agenten (Button unten rechts), beschreibe deine Anforderung in natürlicher Sprache und der Agent erstellt den Indikator inklusive Trigger automatisch.

Trigger – Übersicht

Trigger definieren die genauen Bedingungen, unter denen ein Indikator "feuert" und ein Trade eröffnet wird. Jeder Indikator kann mehrere Trigger haben – ein Trade wird eröffnet, sobald einer der Trigger seine Bedingung erfüllt.

Trigger erstellen

Klicke auf einen Indikator in der Liste. Im linken Bereich erscheint das Triggers-Panel. Klicke auf "Trigger hinzufügen", um einen neuen Trigger anzulegen.

Trigger – Einstellungen

Jeder Trigger hat folgende Parameter, die beim Erstellen oder Bearbeiten gesetzt werden.

Alle Einstellungen im Überblick

Trigger-Modi

Ein Trigger unterstützt verschiedene Modi, die bestimmen wann und unter welchen Bedingungen er feuert:

• Fixed Zeit: Feuert zu einer bestimmten Uhrzeit (z.B. 10:00:00)
• Zeitbereich: Feuert innerhalb eines Zeitfensters (z.B. 09:30 - 10:30)
• Wertbasiert: Feuert bei einem bestimmten Indikator-Wert

Trigger-Values – Übersicht

Trigger-Values legen fest, welche konkreten Werte ein Trigger verwendet, um Bedingungen zu prüfen. Sie werden einem Trigger zugeordnet und definieren z.B. Schwellwerte, Zeitpunkte oder Vergleichswerte.

Trigger-Values – Einstellungen

Die detaillierte Beschreibung aller Trigger-Value-Einstellungen wird hier in Kürze ergänzt.

Backtest starten

Um die Performance deiner Strategie zu testen, startest du einen Backtest-Run. Spaike verwendet eine Job-Queue, die Backtests nacheinander oder parallel verarbeitet.

Backtest starten

1. 1

   Play-Button klicken

   Klicke auf den Play-Button (►) auf der Strategie-Karte im Dashboard.

2. 2

   Bestätigung

   Ein Dialog fragt: "Möchtest du den Backtest für diese Strategie starten?" Bestätige mit OK.

3. 3

   Queue-Status

   Der Job wird in die Queue eingereiht. Du siehst die Position und geschätzte Wartezeit.

4. 4

   Run läuft

   Sobald der Run startet, siehst du den Fortschritt in Prozent auf der Karte.

Run-Status

Backtest abbrechen

Klicke auf den Stop-Button (■) auf der Strategie-Karte, um einen laufenden oder wartenden Run abzubrechen. Der Button ist nur aktiv, wenn ein Run läuft oder in der Queue ist.

Backtest-Ergebnisse

Nach Abschluss eines Runs kannst du detaillierte Statistiken einsehen.

Run-Analyse öffnen

In der Strategie-Detailansicht, öffne das "Runs" Accordion. Klicke auf einen abgeschlossenen Run, um die Analyse-Seite zu öffnen.

Verfügbare Statistiken

Filter & Zeiträume

Die Analyse-Ansicht bietet umfangreiche Filtermöglichkeiten, um die Performance unter verschiedenen Bedingungen zu analysieren.

Verfügbare Filter

Trade-Liste

Die Analyse-Ansicht zeigt eine detaillierte Liste aller Trades mit allen relevanten Informationen.

Trade-Details

Für jeden Trade werden folgende Informationen angezeigt:

• Entry/Exit Zeit: Wann der Trade geöffnet und geschlossen wurde
• Strike(s): Die gehandelten Strikes
• Entry/Exit Preis: Die Preise bei Entry und Exit
• P&L: Gewinn/Verlust des Trades
• Exit Reason: Warum der Trade geschlossen wurde (SL, TP, Expiry, etc.)
• DTE: Days to Expiration bei Entry

Trade-Chart

Klicke auf einen Trade in der Liste, um ein detailliertes P&L-Chart für diesen Trade zu sehen. Das Chart zeigt den Preisverlauf während der Haltedauer.

Portfolios

Portfolios ermöglichen es dir, mehrere Backtest-Runs zu kombinieren und aggregierte Statistiken zu sehen. Dies ist nützlich, um die Performance einer Kombination von Strategien zu analysieren.

Portfolio erstellen

1. 1

   Modal öffnen

   Im Portfolios-Bereich des Dashboards, klicke auf "Neues Portfolio".

2. 2

   Name und Beschreibung

   Gib einen Namen und optional eine Beschreibung ein.

3. 3

   Runs hinzufügen

   Klicke auf "Add Runs" und wähle die Backtest-Runs, die du kombinieren möchtest.

4. 4

   Speichern

   Klicke auf "Speichern". Das Portfolio erscheint als Karte im Portfolio-Bereich.

Portfolio-Analyse

Klicke auf eine Portfolio-Karte, um die aggregierte Analyse zu öffnen. Die Statistiken werden über alle enthaltenen Runs berechnet:

• Kombinierte Equity Curve
• Aggregierter Total P&L
• Kombinierter Max Drawdown
• Trade-Liste aller enthaltenen Runs

KI-Agent

Spaike verfügt über einen integrierten KI-Agenten, der weit über einen einfachen Chat-Assistenten hinausgeht. Der Agent arbeitet mit Function Calling – er kann eigenständig verschiedene Tools aufrufen und hat damit direkte, vollständige Kontrolle über das gesamte Backtest-System. Du beschreibst in natürlicher Sprache, was du brauchst, und der Agent führt die notwendigen Schritte selbst durch: Strategien erstellen, bearbeiten oder löschen, Leg Groups und Legs konfigurieren, Indikatoren und Trigger anlegen, Backtests starten und die Ergebnisse anschließend analysieren. Wenn eine Strategie nicht die gewünschten Ergebnisse liefert, kann der Agent die Daten auswerten, Schwachstellen identifizieren und konkrete Verbesserungsvorschläge machen – und diese auf Wunsch direkt umsetzen. Der Agent ist nicht auf vordefinierte Befehle beschränkt: Du kannst ihn frei nach allem fragen, was mit deiner Strategie oder dem System zusammenhängt.

Agent öffnen

Der KI-Agent ist über den schwebenden Button in der unteren rechten Ecke des Dashboards erreichbar. Ein Klick öffnet das Agenten-Fenster, in dem du direkt in natürlicher Sprache mit ihm interagieren kannst.

Beispiel-Anfragen

API – Übersicht

Spaike bietet eine REST-API für programmgesteuerten Zugriff auf alle Funktionen. Die API verwendet JSON für Requests und Responses.

Basis-URL

/api/

Request-Format

Alle POST/PUT-Requests senden JSON im Body mit Content-Type: application/json. GET-Requests verwenden Query-Parameter.

Authentifizierung

Die API verwendet PHP-Session-basierte Authentifizierung. Du musst dich zunächst über /api/auth/login einloggen.

Login-Endpoint

{
  "username": "dein_username",
  "password": "dein_passwort"
}

Session prüfen

// Response bei eingeloggtem User:
{
  "isLoggedIn": true,
  "username": "dein_username"
}

Wichtige Endpoints

Übersicht der wichtigsten API-Endpoints:

Strategien

Leg Groups

Legs

Indikatoren

Technische Hinweise

Wichtige technische Informationen zur API:

Response-Format

Erfolgreiche Responses haben oft die Form {"ok": true, ...}. Fehler haben die Form {"error": "Fehlermeldung"}.

Listen-Responses

Listen werden oft als {"items": [...]} zurückgegeben.

Credentials

Bei Fetch-Calls muss credentials: 'include' gesetzt werden, um die Session-Cookies mitzusenden.

const response = await fetch('/api/strategies', {
  method: 'GET',
  credentials: 'include',
  headers: {
    'Content-Type': 'application/json'
  }
});
const data = await response.json();
console.log(data.items); // Array von Strategien