Market Interpretation Service – Overview

Ziel

Der Market Interpretation Service übersetzt die im Trend Analysis Service berechneten Indikatoren in verständliche, textuelle Aussagen. Ziel ist es, dem Nutzer auch ohne tiefes Fachwissen über technische Analyse eine nachvollziehbare Einschätzung der aktuellen Marktlage zu liefern – pro Indikator sowie als gewichtete Gesamtaussage.

Der Service liefert keine Kursprognose und keine Handelsempfehlung, sondern eine strukturierte Einschätzung der aktuellen Signallage basierend auf nachlaufenden technischen Indikatoren.

Kernfunktionen

Textuelle Interpretation jedes einzelnen Indikators (z.B. "RSI bei 78 → überkauft")
Klassifizierung jedes Indikators in eine Kategorie (stark bullish bis stark bearish)
Gewichtete Gesamtaussage basierend auf Indikator-Typ (Trend > Momentum > Volatilität)
Kombinierter Score (-100 bis +100) und Kategorie als Gesamtaussage
Transparente Darstellung wie die Gesamtaussage zustande kommt

Plattform-Integration

Komponente	Beschreibung
Trend Analysis Service	Liefert berechnete Indikatorwerte als Datengrundlage
Frontend	Stellt Interpretationen und Gesamtaussage visuell dar
Cloudflare Tunnel	Erreichbar über matus-toolbox.com (hinter Cloudflare Access)

Zielbild

Der Nutzer sieht zusätzlich zum Chart eine klar strukturierte Einschätzung:

Pro Indikator eine kurze, verständliche Aussage mit Kategorie
Eine gewichtete Gesamtaussage mit Score und Kategorie
Eine nachvollziehbare Begründung wie sich die Gesamtaussage zusammensetzt

Beispiel:

RSI (78): Überkauft – Korrektur möglich [bearish, Gewicht: Momentum]
EMA Trend: Aufwärtstrend bestätigt (20 > 50 > 200) [bullish, Gewicht: Trend]
MACD: Bullish Crossover [bullish, Gewicht: Momentum]
Bollinger Bands: Enge Bänder, geringe Volatilität [neutral, Gewicht: Volatilität]

Gesamteinschätzung: Leicht Bullish (Score: +35)
Begründung: Trendindikatoren überwiegen positiv, Momentum gemischt, 
Volatilität neutral.

Architektur

Datenbank (market_data.forex_ohlcv)
        ↓
Trend Analysis Service
  ├── Indikatorberechnung (indicators.py)
  ├── Interpretation Engine (interpretation.py)  ← integriert, kein eigener Container
  └── GET /api/v1/interpretation
        ↓
Frontend (TrendAnalysis.jsx – Gauge, Indikatorliste, Breakdown)

Architekturentscheidung: Der Market Interpretation Service wurde direkt in den Trend Analysis Service integriert (kein eigener Docker-Container). Da die Interpretation ausschließlich auf bereits berechneten Indikatorwerten basiert und keine eigene Datenbank benötigt, vermeidet die Integration einen zusätzlichen HTTP-Hop, einen weiteren Container und unnötige Infrastrukturkomplexität auf dem Raspberry Pi.

Technischer Stack

Schicht	Technologie	Begründung
Datenquelle	market_data.forex_ohlcv (direkt)	Indikatorberechnungen laufen im selben Prozess
Interpretation	Python (Regelwerk-basiert, `interpretation.py`)	deterministisch, nachvollziehbar, ressourcenschonend
API	FastAPI (im trend-analysis Container)	kein eigener Container nötig
Frontend	React (TrendAnalysis.jsx)	integriert in bestehende Chart-Seite

Fachlicher Fokus

Indikator-Gewichtung

Kategorie	Indikatoren	Gewicht
Trend	EMA 20/50/200, Supertrend	hoch (Faktor 3)
Momentum	RSI, MACD, Force Index	mittel (Faktor 2)
Volatilität	Bollinger Bands, Bollinger-Keltner Squeeze	niedrig (Faktor 1)

Kategorien (pro Indikator und gesamt)

Stark Bullish
Bullish
Neutral
Bearish
Stark Bearish

Score-Skala

-100 (stark bearish) bis +100 (stark bullish)
0 = neutral

Abgrenzung

In Scope	Out of Scope
Textuelle Interpretation einzelner Indikatoren	Kursprognose oder Preisvorhersage
Gewichtete Gesamtaussage (Score + Kategorie)	Zeitliche Vorhersage ("wann")
Transparente Begründung der Gesamtaussage	Automatische Handelsempfehlung
Regelwerk-basierte, deterministische Logik	Machine-Learning-basierte Prognosemodelle
Aktuelle Momentaufnahme	Backtesting oder historische Erfolgsquote

Changelog

Version	Datum	Änderungen
1.0	2026-06-25	Initiale Version