# GENITUS // Signal-Logik & Strategie-Doku

**Version:** v4  
**Scope:** Wie aus dem EOD-Preis und vier gleitenden Durchschnitten (SMA) ein Long- oder Short-Signal entsteht.

---

## 1. Grundidee

Das Dashboard soll **keine neutralen Zustände** produzieren, sondern für jeden Coin eine klare Richtung: **Long** (bullish) oder **Short** (bearish). Die Entscheidung basiert ausschließlich auf der Position des aktuellen Preises zu vier SMAs und der relativen Lage der SMAs zueinander.

> **Disclaimer:** Das ist ein technisches Momentum-Modell, keine Anlageberatung. Es mischt kurz-, mittel- und langfristige Trends.

---

## 2. Verwendete SMAs

| SMA | Zeitraum | Bedeutung |
|---|---|---|
| SMA 3 | 3 Tage | Akutes Momentum / Noise-Filter |
| SMA 20 | 20 Tage | Kurzfristiger Trend (ca. 4 Wochen) |
| SMA 50 | 50 Tage | Mittelfristiger Trend (ca. 2,5 Monate) |
| SMA 100 | 100 Tage | Langfristiger Trend (ca. 5 Monate) |

Alle SMAs werden auf Tagesbasis (`period=d`) aus den historischen EOD-Closing-Preisen berechnet.

---

## 3. Scoring-Regeln

Für jeden Coin wird ein Score aus sechs Punkten gebildet. Jede Bedingung zählt **+1** (bullish) oder **-1** (bearish).

### 3.1 Preis vs. SMA (4 Punkte)

| Bedingung | Score | Interpretation |
|---|---|---|
| Preis > SMA 3 | +1 | Akutes Momentum bullisch |
| Preis < SMA 3 | -1 | Akutes Momentum bärisch |
| Preis > SMA 20 | +1 | Kurzfristig bullisch |
| Preis < SMA 20 | -1 | Kurzfristig bärisch |
| Preis > SMA 50 | +1 | Mittelfristig bullisch |
| Preis < SMA 50 | -1 | Mittelfristig bärisch |
| Preis > SMA 100 | +1 | Langfristig bullisch |
| Preis < SMA 100 | -1 | Langfristig bärisch |

### 3.2 SMA-Struktur (2 Punkte)

| Bedingung | Score | Interpretation |
|---|---|---|
| SMA 3 > SMA 20 | +1 | Kurzfristiges Momentum dreht nach oben |
| SMA 3 < SMA 20 | -1 | Kurzfristiges Momentum dreht nach unten |
| SMA 20 > SMA 50 | +1 | Golden-Cross-Struktur (bullish) |
| SMA 20 < SMA 50 | -1 | Death-Cross-Struktur (bearish) |

### 3.3 Signal-Entscheidung

```
if (Score > 0) → Long  (bullish)
if (Score <= 0) → Short (bearish)
```

Es gibt **kein Neutral** mehr, solange mindestens ein SMA verfügbar ist. Fehlen alle SMAs (z.B. Coin frisch gelistet oder keine Historie), fällt das Feld auf „—“ aus.

> **Ab v5+:** Ein Score von 0 wird als Short gewertet. Nur ein echt positives Momentum (Score > 0) kommt als Long durch.

---

## 4. Warum Score > 0 = Long?

Das Modell ist **momentum-geladen**: Ein Gleichstand (Score = 0) reicht nicht mehr als Long. Nur wenn mehr bullische als bärische Bedingungen zutreffen, wird ein Long-Signal generiert. Das filtert Schwäche aus der Long-Seite heraus und passt besser zu einer Handelsrealität, in der „flache“ Coins keine Kapitalbindung rechtfertigen.

Wer das aggressiver will, kann die Grenze auf `Score >= 2` anheben und nur die Crème de la Crème longen.

---

## 5. Dynamischer Crypto-Fund

Das Dashboard erzeugt aus allen aktuellen Long-Signalen ein live-rebalancingfähiges Musterportfolio:

- **Reiner Long-Fund:** Kein Cash-Puffer, 100% des Modellkapitals (10.000 $) sind investiert.
- **Crème-de-la-Crème-Filter:** Nur Coins mit `Score > 0` kommen in den Fund.
- **Liquiditätsgewichtung:** Majors erhalten mehr Gewicht als Core-Coins, Core-Coins mehr als Gems. Moonshots sind ausgeschlossen, weil sie illiquide, spread-empfindlich und oft nicht auf allen Börsen handelbar sind.

| Tier | Liquiditätsgewicht | Begründung |
|---|---|---|
| MAJORS | 4.0x | Höchste Liquidität, beste Börsenverfügbarkeit, geringster Slippage |
| CORE | 2.5x | Etablierte DeFi/L2-Coins, solide Liquidität |
| GEMS | 1.0x | Mittlere Liquidität, höhere Volatilität, kleinere Positionen |
| MOONSHOTS | ausgeschlossen | Illiquide Micro-Caps, unzuverlässige Spreads, kein Fund-Material |

Die Allokation eines einzelnen Long-Coins berechnet sich als:

```
Allokation = (Liquiditätsgewicht / Summe aller Long-Gewichte) × 10.000 $
```

---

## 6. Sortierung der Markt-Übersicht

Standard-Sortierung: **Signal-Stärke** (Long vor Short), dann alphabetisch. Klick auf einen Header toggled zwischen aufsteigend und absteigend.

| Sortierbar nach | Spalte |
|---|---|
| Name | Coin |
| Aktueller Preis | Preis |
| 24h-Change | 24h |
| SMA 3 / 20 / 50 / 100 | jeweilige SMA-Spalte |
| Signal | Signal |

---

## 7. Chart-Zeiträume im Detail-Modal

| Button | Daten | Verwendung |
|---|---|---|
| 7T | Letzte 7 Tage | Mikro-Setup / Intraday-Kontext |
| 30T | Letzte 30 Tage | Standard-Momentum-Ansicht |
| 90T | Letzte 90 Tage | Quartals-Trend |
| 180T | Letzte 180 Tage | Halbjahres-Trend |
| 1J | Letzte 365 Tage | Jahrestrend |
| 5J | Letzte 5 Jahre | Struktur-Cycle / Langfrist-Range |
| MAX | Seit 2010-01-01 | Maximale verfügbare Historie des EOD-Proxys |

Bei MAX und 5J wechselt die Chart-Achse auf **Monats-Einheiten**, um Überfrachtung zu vermeiden.

---

## 8. Bekannte Grenzen

- **Lagged Signal:** SMAs sind rückwirkend. Ein plötzlicher Crash zeigt sich erst mit Verzögerung.
- **Kein Volumen / Keine Orderbook-Daten:** Das Modell sieht nur Preis und Zeit.
- **Moonshot-Noise:** Coins unter $0.001 (z.B. LUNC, XEN, GST) können 0$ anzeigen, weil die Float-Preise unter der EOD-Auflösung liegen. Das Signal ist dann mathematisch korrekt, aber ökonomisch fragwürdig.
- **EOD-Symbol-Mapping:** Viele Coins brauchen numerische Suffixe (z.B. `ARB11841`, `APE18876`, `IMX10603`). Siehe `cc-liste.csv` und Memory-Eintrag.

---

## 9. Tuning-Ideen für Folge-Versionen

- EMA statt SMA für mehr Gewichtung auf aktuelle Tage.
- RSI- oder MACD-Filter als zweite Säule.
- Volatilitäts-Filter: Bei sehr kleinen Coins (Moonshots) Signal nur anzeigen, wenn Volumen/Spread plausibel.
- Benutzerdefinierbare SMA-Zeiträume.