NexusTrader — Autonomes Multi-Agenten Handelssystem

███╗   ██╗███████╗██╗  ██╗██╗   ██╗███████╗████████╗██████╗  █████╗ ██████╗ ███████╗██████╗
████╗  ██║██╔════╝╚██╗██╔╝██║   ██║██╔════╝╚══██╔══╝██╔══██╗██╔══██╗██╔══██╗██╔════╝██╔══██╗
██╔██╗ ██║█████╗   ╚███╔╝ ██║   ██║███████╗   ██║   ██████╔╝███████║██║  ██║█████╗  ██████╔╝
██║╚██╗██║██╔══╝   ██╔██╗ ██║   ██║╚════██║   ██║   ██╔══██╗██╔══██║██║  ██║██╔══╝  ██╔══██╗
██║ ╚████║███████╗██╔╝ ██╗╚██████╔╝███████║   ██║   ██║  ██║██║  ██║██████╔╝███████╗██║  ██║
╚═╝  ╚═══╝╚══════╝╚═╝  ╚═╝ ╚═════╝ ╚══════╝   ╚═╝   ╚═╝  ╚═╝╚═╝  ╚═╝╚═════╝ ╚══════╝╚═╝  ╚═╝

Autonomes Multi-Agenten Handelssystem der nächsten Generation

Erstellt von Francis Klein / StockPro-AI · März 2026 · Mit Unterstützung von Perplexity Pro

Über NexusTrader

Aktueller Implementierungsstand (April 2026)

Der aktuell lauffähige Kern im Repository umfasst:

FastAPI-Endpunkte für Analyse-Start (POST /api/analyze), Health/Readiness/Metrics, Marktdaten, Portfolio (Paper-Mock), Agent-Status und Trade-Approval.
Polling-Endpunkt für Analyse-Jobs (GET /api/analyze/{job_id}) zusätzlich zum WebSocket-Streaming.
Echtzeit-Streaming über WebSocket (/ws) für Pipeline-Events.
Sechsstufige Multi-Agenten-Pipeline im Orchestrator (Datenerfassung → Research → Debatte → Risiko → Strategie → optionale Ausführung).
Persistenz für Analyseergebnisse als PostgreSQL/TimescaleDB-Store über die analysis_reports-Tabelle. API-Zugriff erfolgt über GET /api/history/{ticker} und GET /api/signals für minimale Dashboard-Sichtbarkeit.
Frontend-Datenpfad im Dashboard: AnalysisPanel nutzt reale Analyse-API (POST /api/analyze + GET /api/analyze/{job_id}), TradeSignalFeed nutzt GET /api/signals für minimale Dashboard-Sichtbarkeit.
Enthält eine Smoke-Test-Suite (tests/smoke_tests.py) und einen Statusmonitor-CLI (status_monitor.py) für Laufzeitprüfung und Regressionstests.

Hinweis zur API-Basisroute im Frontend

Die aktuelle Backend-API nutzt /api/... (nicht /api/v1/...). Der Frontend-Client in ui/src/lib/api.ts ist darauf abgestimmt.

NexusTrader ist ein vollautomatisches, KI-gesteuertes Handelssystem, das die fortschrittlichsten Konzepte aus dem Bereich der Multi-Agenten-Forschung vereint und in ein produktionsreifes, lokal betreibbares System überführt. Es kombiniert:

Forschungsgestützte KI — Selbstoptimierende Agenten entdecken eigenständig Alpha-Faktoren und verfeinern Handelsmodelle in einem kontinuierlichen Lernzyklus (inspiriert von Microsoft RD-Agent / CoSTEER).
Debatt-Architektur — Bulle vs. Bär, sowie ein dreigeteiltes Risikodebatte-Team (aggressiv, neutral, konservativ) sorgen für ausgewogene, robuste Handelsentscheidungen.
Live-Handelsausführung — Direkte API-Anbindung an Alpaca (Aktien/ETFs) und Hyperliquid (Krypto) sowie browserbasierte Automatisierung für jede Plattform.
Windows One-Click-Start — Vollständiges Docker-Compose-Setup, das mit einem Doppelklick auf start.bat startet — keine manuelle Konfiguration erforderlich.
Echtzeit-Dashboard — Modernes Next.js-Interface mit Glassmorphism-Design, WebSocket-Streaming und menschlicher Genehmigungsfunktion für Trades.

NexusTrader schließt die Lücke zwischen akademischer KI-Forschung und realem Handel.

Funktionsübersicht

Kategorie	Funktionen
Multi-Agenten Architektur	15 spezialisierte Agenten · LangGraph-Orchestrierung · DAG-basierte Ausführungspläne · Hexagonale Architektur (Ports & Adapters) · A2A-Protokoll (Agent-zu-Agent)
KI-Integration	LLM-Router mit Failover · Ollama (lokal) · OpenAI GPT-4o · Google Gemini · Anthropic Claude · DeepSeek · LiteLLM-Backend · Deep-Think / Quick-Think Modi
Datenquellen	Yahoo Finance (yFinance) · Alpha Vantage · SEC EDGAR (Fundamentaldaten) · Reddit (Sentiment) · Nachrichten-APIs (Google News, NewsAPI) · Wirtschaftsindikatoren (FRED)
Handel	Paper Trading · Live Trading (Alpaca & Hyperliquid) · Browserbasierte Automatisierung (Playwright) · Menschliche Genehmigung (Human-in-the-Loop) · Backtest-Engine
Risikomanagement	3-Wege-Risikodebatte · Konfidenz-Scoring · Positions-Sizing · Stop-Loss / Take-Profit · Drawdown-Überwachung · Compliance-Monitor
UI / Dashboard	Next.js 15 + React · Glassmorphism Dark Theme · WebSocket-Echtzeit-Streaming · Interaktive Charts · Trade-Genehmigungsworkflow · Agent-Aktivitäts-Monitor
Infrastruktur	Docker Compose (Microservices) · Windows One-Click (`start.bat`) · PostgreSQL/TimescaleDB · Redis-Cache · (Message Bus) · ChromaDB (Vektorgedächtnis) · OpenTelemetry-Observabilität

Systemarchitektur

graph TB
    subgraph UI["🖥️ Benutzeroberfläche (Next.js 15)"]
        NextJS["Next.js Dashboard<br/>Glassmorphism UI"]
        WS_Client["WebSocket Client<br/>Echtzeit-Updates"]
        HitL["Human-in-the-Loop<br/>Trade-Genehmigung"]
    end

    subgraph Gateway["⚡ API-Schicht"]
        FastAPI["FastAPI Gateway<br/>:8000"]
        WS_Server["WebSocket Server<br/>Broadcast Hub"]
        Auth["Auth Middleware<br/>JWT / API Keys"]
    end

    subgraph Orchestrator["🧠 Agent Orchestrator (LangGraph)"]
        Graph["Trading Graph<br/>DAG Execution Engine"]
        StateManager["State Manager<br/>Shared Context"]
                EventBus["Event Bus / "]
    end

    subgraph ResearchTeam["🔬 Forschungs-Team"]
        MarketAnalyst["📈 Marktanalyst<br/>Technische Indikatoren"]
        NewsAnalyst["📰 Nachrichtenanalyst<br/>Makro-Events"]
        SentimentAnalyst["💬 Sentiment-Analyst<br/>Reddit & Social Media"]
        FundamentalsAnalyst["📊 Fundamentalanalyst<br/>SEC EDGAR & Earnings"]
        EconomicAgent["🌐 Wirtschaftsindikator-Agent<br/>GDP, Inflation, VIX"]
    end

    subgraph DebateTeam["⚔️ Debatt-Team"]
        BullResearcher["🐂 Bulle<br/>Bullische Argumente"]
        BearResearcher["🐻 Bär<br/>Bärische Argumente"]
    end

    subgraph StrategyTeam["🎯 Strategie-Team"]
        StrategyCoord["🧩 Strategie-Koordinator<br/>Trade-Synthese"]
        PortfolioOpt["⚖️ Portfolio-Optimierer<br/>Black-Litterman / Risk Parity"]
        RegimeDetector["📡 Marktregime-Detektor<br/>HMM-basiert"]
    end

    subgraph RiskTeam["🛡️ Risiko-Team"]
        AggressiveRisk["🔴 Aggressiver Debatter<br/>High-Risk Positionen"]
        NeutralRisk["🟡 Neutraler Debatter<br/>Ausgewogene Sichtweise"]
        ConservativeRisk["🟢 Konservativer Debatter<br/>Kapitalerhalt"]
        RiskManager["🔒 Risiko-Manager<br/>Finale Entscheidung"]
    end

    subgraph ExecutionTeam["⚙️ Ausführungs-Team"]
        PaperTrader["📝 Paper Trader<br/>Simulations-Modus"]
        LiveTrader["💹 Live Trader<br/>Alpaca & Hyperliquid API"]
        BrowserExec["🌐 Browser-Executor<br/>Playwright Automation"]
    end

    subgraph LearningTeam["🧬 Lern-Team"]
        FactorEvolution["🔭 Faktor-Evolutions-Agent<br/>Alpha-Faktor-Entdeckung"]
        ModelEvolution["🤖 Modell-Evolutions-Agent<br/>ML-Modell-Optimierung"]
        PerfEvaluator["📋 Performance-Evaluator<br/>Metriken & Backtesting"]
    end

    subgraph LLMRouter["🤖 LLM-Router"]
        Ollama["🏠 Ollama<br/>Lokal (Llama, Mistral)"]
        OpenAI["☁️ OpenAI<br/>GPT-4o / o3"]
        Gemini["🌟 Google Gemini<br/>2.0 Flash / Pro"]
        Anthropic["🔷 Anthropic<br/>Claude 3.5 Sonnet"]
        DeepSeek["⚡ DeepSeek<br/>R1 / V3"]
    end

    subgraph DataPipeline["📡 Daten-Pipeline"]
        yFinance["📈 yFinance<br/>OHLCV & Optionen"]
        AlphaVantage["🔑 Alpha Vantage<br/>Fundamentaldaten"]
        SECEDGAR["📑 SEC EDGAR<br/>10-K, 10-Q, 8-K"]
        Reddit["👥 Reddit API<br/>WallStreetBets & mehr"]
        NewsAPIs["📰 Nachrichten-APIs<br/>Google News / NewsAPI"]
        FRED["🏛️ FRED API<br/>Wirtschaftsindikatoren"]
    end

    subgraph Brokers["🏦 Broker-Connectors"]
        Alpaca["📊 Alpaca<br/>Aktien & ETFs"]
        Hyperliquid["₿ Hyperliquid<br/>Krypto-Perps"]
        BrowserBroker["🌐 Browser-Automation<br/>Universeller Zugang"]
    end

    subgraph Infrastructure["🏗️ Infrastruktur"]
        TimescaleDB["🗄️ PostgreSQL/TimescaleDB<br/>Zeitreihendaten"]
        Redis["⚡ Redis<br/>Cache (24h TTL)"]
                RedisPubSub["📨  / Message Broker"]
        ChromaDB["🧠 ChromaDB<br/>Vektorgedächtnis"]
    end

    %% UI <-> Gateway
    NextJS <--> FastAPI
    WS_Client <--> WS_Server
    HitL --> FastAPI

    %% Gateway <-> Orchestrator
    FastAPI <--> Graph
    WS_Server <--> StateManager
    Graph --> EventBus

    %% Orchestrator <-> Teams
    Graph --> ResearchTeam
    Graph --> DebateTeam
    Graph --> StrategyTeam
    Graph --> RiskTeam
    Graph --> ExecutionTeam
    Graph --> LearningTeam

    %% Research flows into Debate
    ResearchTeam --> BullResearcher
    ResearchTeam --> BearResearcher

    %% Debate flows into Strategy
    DebateTeam --> StrategyCoord
    RegimeDetector --> StrategyCoord
    StrategyCoord --> PortfolioOpt

    %% Strategy flows into Risk
    PortfolioOpt --> RiskManager
    AggressiveRisk --> RiskManager
    NeutralRisk --> RiskManager
    ConservativeRisk --> RiskManager

    %% Risk flows into Execution
    RiskManager --> PaperTrader
    RiskManager --> LiveTrader
    RiskManager --> BrowserExec

    %% Execution <-> Brokers
    LiveTrader <--> Alpaca
    LiveTrader <--> Hyperliquid
    BrowserExec <--> BrowserBroker

    %% Learning feedback loop
    PerfEvaluator --> FactorEvolution
    PerfEvaluator --> ModelEvolution
    FactorEvolution --> Graph
    ModelEvolution --> Graph

    %% LLM Router connections
    Graph <--> LLMRouter

    %% Data Pipeline connections
    DataPipeline --> ResearchTeam

    %% Infrastructure connections
    Graph <--> TimescaleDB
    Graph <--> Redis
    EventBus <--> RedisPubSub
    Graph <--> ChromaDB

    %% Styling
    classDef ui fill:#1a1a2e,stroke:#6366f1,color:#e2e8f0
    classDef gateway fill:#16213e,stroke:#8b5cf6,color:#e2e8f0
    classDef orchestrator fill:#0f3460,stroke:#06b6d4,color:#e2e8f0
    classDef research fill:#1e3a5f,stroke:#3b82f6,color:#e2e8f0
    classDef debate fill:#3b1f5e,stroke:#a855f7,color:#e2e8f0
    classDef strategy fill:#1f3a1f,stroke:#22c55e,color:#e2e8f0
    classDef risk fill:#3a1f1f,stroke:#ef4444,color:#e2e8f0
    classDef execution fill:#3a2e1f,stroke:#f59e0b,color:#e2e8f0
    classDef learning fill:#1f3a3a,stroke:#14b8a6,color:#e2e8f0
    classDef llm fill:#2d1f3a,stroke:#d946ef,color:#e2e8f0
    classDef data fill:#1f2d3a,stroke:#38bdf8,color:#e2e8f0
    classDef broker fill:#2d2d1f,stroke:#eab308,color:#e2e8f0
    classDef infra fill:#1a2a1a,stroke:#4ade80,color:#e2e8f0

    class NextJS,WS_Client,HitL ui
    class FastAPI,WS_Server,Auth gateway
    class Graph,StateManager,EventBus orchestrator
    class MarketAnalyst,NewsAnalyst,SentimentAnalyst,FundamentalsAnalyst,EconomicAgent research
    class BullResearcher,BearResearcher debate
    class StrategyCoord,PortfolioOpt,RegimeDetector strategy
    class AggressiveRisk,NeutralRisk,ConservativeRisk,RiskManager risk
    class PaperTrader,LiveTrader,BrowserExec execution
    class FactorEvolution,ModelEvolution,PerfEvaluator learning
    class Ollama,OpenAI,Gemini,Anthropic,DeepSeek llm
    class yFinance,AlphaVantage,SECEDGAR,Reddit,NewsAPIs,FRED data
    class Alpaca,Hyperliquid,BrowserBroker broker
    class TimescaleDB,Redis,,ChromaDB infra

Tech-Stack

Schicht	Technologie	Zweck
Frontend	Next.js 15, React 19, TypeScript	Dashboard & Benutzeroberfläche
Styling	Tailwind CSS, Glassmorphism	Modernes Dark-Theme-Design
Echtzeit	WebSocket (native), Socket.io	Live-Daten-Streaming
Backend	FastAPI (Python 3.11+)	REST-API & WebSocket-Server
Orchestrierung	LangGraph, LangChain	Agenten-Graph & Zustandsverwaltung
LLM-Backend	LiteLLM, Ollama	Modell-agnostischer LLM-Router
Datenbank	PostgreSQL + TimescaleDB	Zeitreihendaten & Trade-Historie
Cache	Redis	Kurzzeit-Cache (24h TTL)
Message Bus		Asynchrone Agentenkommunikation
Vektorspeicher	ChromaDB	Semantisches Gedächtnis der Agenten
Broker-APIs	Alpaca SDK, Hyperliquid SDK	Aktien- & Krypto-Ausführung
Browser-Automation	Playwright	Universelle Handelsplattform-Automatisierung
Containerisierung	Docker, Docker Compose	Microservices-Deployment
Quantitative Tools	Qlib, NumPy, Pandas, TA-Lib	Faktor-Forschung & Signalgenerierung
Observabilität	OpenTelemetry, Prometheus, Grafana	Monitoring & Tracing

Schnellstart

Voraussetzungen

Bitte stelle sicher, dass folgende Software installiert ist:

Software	Mindestversion	Download
Docker Desktop	4.x	docker.com/get-started
Git	2.x	git-scm.com
Node.js	20+ (LTS)	nodejs.org

Windows One-Click-Start (Empfohlen)

Repository klonen:

git clone https://github.com/StockPro-AI/NexusTrader.git
cd NexusTrader

Umgebungsvariablen konfigurieren:

cp .env.example .env
# .env in einem Texteditor öffnen und API-Schlüssel eintragen

Doppelklick auf start.bat — fertig! Das System startet automatisch alle Dienste.

Das Dashboard ist danach erreichbar unter: http://localhost:3000

Manuelle Installation (Docker Compose)

# 1. Repository klonen
git clone https://github.com/StockPro-AI/NexusTrader.git
cd NexusTrader

# 2. Umgebungsvariablen einrichten
cp .env.example .env
# .env bearbeiten und eigene API-Schlüssel eintragen

# 3. Alle Dienste starten
docker-compose up -d

# 4. Logs verfolgen
docker-compose logs -f

# 5. Status prüfen
docker-compose ps

Dienste nach dem Start

Dienst	URL	Beschreibung
Dashboard	http://localhost:3000	Next.js Benutzeroberfläche
API	http://localhost:8000	FastAPI Backend
API-Dokumentation	http://localhost:8000/docs	Swagger UI
-Verwaltung	http://localhost:15672	Message Broker UI
Grafana	http://localhost:3001	Monitoring Dashboard

Entwicklungsumgebung (ohne Docker)

# Backend
cd backend
python -m venv venv
source venv/bin/activate        # Windows: venv\Scripts\activate
pip install -r requirements.txt
uvicorn main:app --reload --port 8000

# Frontend (neues Terminal)
cd frontend
npm install
npm run dev

Konfiguration

Kopiere .env.example zu .env und trage deine Werte ein:

# Core app/config
REDIS_URL=redis://localhost:6379/0
CHROMA_PATH=./data/chromadb
DATABASE_URL=postgresql+asyncpg://nexus:change_me@localhost:5432/nexustrader
CORS_ORIGINS=http://localhost:3000,http://localhost:5173,http://localhost:5174
HOST=0.0.0.0
PORT=8000
ENV=development

# LLM
LLM_PROVIDER=openai
LLM_BASE_URL=
OPENAI_API_KEY=
ANTHROPIC_API_KEY=
GOOGLE_API_KEY=
DEEPSEEK_API_KEY=
OPENROUTER_API_KEY=
MISTRAL_API_KEY=

# Broker/Evolution
DEFAULT_BROKER=paper
EVOLUTION_ENABLED=false
EVOLUTION_UNIVERSE=AAPL,MSFT,GOOGL

# Docker compose vars
POSTGRES_DB=nexustrader
POSTGRES_USER=nexus
POSTGRES_PASSWORD=change_me
APP_PORT=8000

# Market data optional
ALPHA_VANTAGE_API_KEY=
NEWS_API_KEY=
REDDIT_CLIENT_ID=
REDDIT_CLIENT_SECRET=
REDDIT_USER_AGENT=NexusTrader/1.0
REDIS_CACHE_TTL=3600

Empfohlene Einstellungen für den Einstieg

Einstellung	Empfehlung	Beschreibung
`DEFAULT_BROKER`	`paper`	Standardmäßig keine Live-Ausführung
`LLM_PROVIDER`	`openai` (oder lokaler Provider)	Cloud- oder lokale Modellanbindung
`ENV`	`development`	Lokale Entwicklung mit sicheren Defaults
`EVOLUTION_ENABLED`	`false`	Evolutionszyklus zunächst deaktiviert

API-Endpunkte

Analyse & Agenten

Methode	Endpunkt	Beschreibung
`POST`	`/api/analyze`	Vollständige Multi-Agenten-Analyse starten
`GET`	`/api/history/{ticker}`	Letzte Analyseberichte für einen Ticker abrufen
`GET`	`/api/agents/status`	Status aller Agenten abrufen
`POST`	`/api/backtest`	Backtest-Lauf starten (Mock/Platzhalter)

Handel & Portfolio

Methode	Endpunkt	Beschreibung
`GET`	`/api/portfolio`	Aktuelles Portfolio anzeigen
`POST`	`/api/trade/approve`	Trade manuell genehmigen/ablehnen (Human-in-the-Loop)

Marktdaten

Methode	Endpunkt	Beschreibung
`GET`	`/api/market/{ticker}`	Markt-Snapshot + technische Indikatoren für ein Symbol
`GET`	`/api/fundamentals/{ticker}`	Fundamentaldaten für ein Symbol
`GET`	`/api/news/{ticker}`	Nachrichten-Sentiment für ein Symbol
`GET`	`/api/economic-indicators`	Makroökonomische Kennzahlen

Konfiguration & System

Methode	Endpunkt	Beschreibung
`GET`	`/api/health`	Liveness-/Gesundheitscheck
`GET`	`/health`	Kompatibler Liveness-Alias (ohne API-Prefix)
`GET`	`/api/readiness`	Readiness-Check für Orchestrierung
`GET`	`/api/metrics`	Prometheus-kompatible Metriken
`WS`	`/ws`	WebSocket für Echtzeit-Updates

Projekt-Struktur

NexusTrader/
├── 📁 backend/                         # Python FastAPI Backend
│   ├── 📁 agents/                      # Alle Agenten-Implementierungen
│   │   ├── 📁 research/                # Forschungs-Team
│   │   │   ├── market_analyst.py
│   │   │   ├── news_analyst.py
│   │   │   ├── sentiment_analyst.py
│   │   │   ├── fundamentals_analyst.py
│   │   │   └── economic_indicators.py
│   │   ├── 📁 debate/                  # Debatt-Team
│   │   │   ├── bull_researcher.py
│   │   │   └── bear_researcher.py
│   │   ├── 📁 strategy/                # Strategie-Team
│   │   │   ├── strategy_coordinator.py
│   │   │   ├── portfolio_optimizer.py
│   │   │   └── regime_detector.py
│   │   ├── 📁 risk/                    # Risiko-Team
│   │   │   ├── aggressive_debater.py
│   │   │   ├── neutral_debater.py
│   │   │   ├── conservative_debater.py
│   │   │   └── risk_manager.py
│   │   ├── 📁 execution/               # Ausführungs-Team
│   │   │   ├── paper_trader.py
│   │   │   ├── live_trader.py
│   │   │   └── browser_executor.py
│   │   └── 📁 learning/                # Lern-Team
│   │       ├── factor_evolution.py
│   │       ├── model_evolution.py
│   │       └── performance_evaluator.py
│   ├── 📁 core/                        # Kerninfrastruktur
│   │   ├── orchestrator.py             # LangGraph Trading Graph
│   │   ├── llm_router.py               # LiteLLM Multi-Provider Router
│   │   ├── state_manager.py            # Gemeinsamer Zustandsspeicher
│   │   └── event_bus.py                #  Event Bus
│   ├── 📁 data/                        # Datenpipeline
│   │   ├── yfinance_client.py
│   │   ├── alpha_vantage_client.py
│   │   ├── sec_edgar_client.py
│   │   ├── reddit_client.py
│   │   └── news_client.py
│   ├── 📁 brokers/                     # Broker-Konnektoren
│   │   ├── alpaca_connector.py
│   │   ├── hyperliquid_connector.py
│   │   └── browser_connector.py
│   ├── 📁 db/                          # Datenbankmodelle & Migrationen
│   │   ├── models.py
│   │   └── migrations/
│   ├── 📁 api/                         # FastAPI Routen
│   │   ├── routes/
│   │   └── websocket.py
│   ├── main.py                         # Anwendungs-Einstiegspunkt
│   └── requirements.txt
├── 📁 frontend/                        # Next.js 15 Frontend
│   ├── 📁 app/                         # App Router
│   │   ├── page.tsx                    # Dashboard-Startseite
│   │   ├── 📁 agents/                  # Agenten-Monitor-Seite
│   │   ├── 📁 portfolio/               # Portfolio-Seite
│   │   └── 📁 trades/                  # Trade-Historie & Genehmigung
│   ├── 📁 components/
│   │   ├── 📁 ui/                      # Glassmorphism UI-Komponenten
│   │   ├── AgentCard.tsx
│   │   ├── TradeApproval.tsx
│   │   └── RealtimeChart.tsx
│   ├── 📁 lib/
│   │   ├── websocket.ts                # WebSocket-Client
│   │   └── api.ts                      # API-Client
│   └── package.json
├── 📁 infrastructure/                  # Infrastruktur-Konfiguration
│   ├── docker-compose.yml              # Haupt-Compose-Datei
│   ├── docker-compose.dev.yml          # Entwicklungsoverride
│   ├── 📁 postgres/
│   │   └── init.sql                    # Datenbankinitialisierung
│   ├── 📁 grafana/                     # Grafana-Dashboards
│   └── 📁 prometheus/
│       └── prometheus.yml
├── 📁 docs/                            # Dokumentation
│   ├── architecture.md
│   └── api-reference.md
├── .env.example                        # Umgebungsvariablen-Vorlage
├── start.bat                           # Windows One-Click-Starter
├── start.sh                            # Linux/macOS Starter
├── README.md                           # Diese Datei
├── AGENTS.md                           # Detaillierte Agenten-Spezifikation
└── LICENSE

Mitwirken

Beiträge sind herzlich willkommen! So kannst du helfen:

Fehler melden

Prüfe, ob der Fehler bereits als Issue bekannt ist.
Erstelle ein neues Issue mit einer klaren Beschreibung, Reproduktionsschritten und deiner Systemumgebung.

Code beitragen

# 1. Repository forken und klonen
git clone https://github.com/DEIN_USERNAME/NexusTrader.git

# 2. Feature-Branch erstellen
git checkout -b feature/neuer-agent

# 3. Änderungen vornehmen und testen
pytest backend/tests/

# 4. Commit mit aussagekräftiger Nachricht
git commit -m "feat: Neuen Sentiment-Agenten für X-API hinzugefügt"

# 5. Pull Request erstellen
git push origin feature/neuer-agent

Entwicklungsrichtlinien

Code: Englische Bezeichner (Variablen, Funktionen, Klassen, Endpunkte)
Benutzertext: Deutsche Beschriftungen, Meldungen und Dokumentation
Tests: Mindestens 80% Testabdeckung für neue Agenten
Dokumentation: Neue Agenten in AGENTS.md dokumentieren
Stil: Black (Python), Prettier (TypeScript)

Lizenz

Dieses Projekt steht unter der MIT-Lizenz. Siehe LICENSE für Details.

MIT License — Copyright (c) 2026 Francis Klein / StockPro-AI

Die Nutzung, Vervielfältigung und Modifikation ist kostenlos erlaubt,
solange der Copyright-Hinweis erhalten bleibt.

Haftungsausschluss

⚠️ KEIN FINANZRAT — NUR FÜR FORSCHUNGS- UND BILDUNGSZWECKE

NexusTrader ist ein experimentelles Forschungsprojekt und kein zugelassenes Finanzprodukt. Die durch das System generierten Handelssignale und Empfehlungen stellen keine Anlageberatung dar und sollten nicht als Grundlage für echte Finanzentscheidungen verwendet werden.

Der Handel mit Wertpapieren, Derivaten und Kryptowährungen birgt erhebliche Risiken, einschließlich des vollständigen Kapitalverlusts. Vergangene Leistungen sind kein Indikator für zukünftige Ergebnisse. Verwende dieses System ausschließlich im Paper-Trading-Modus, bis du seine Funktionsweise vollständig verstehst.

Die Entwickler und Mitwirkenden übernehmen keinerlei Haftung für finanzielle Verluste, die durch die Nutzung dieses Systems entstehen.

Credits & Danksagung

Entwickelt mit Leidenschaft von

Francis Klein StockPro-AI — März 2026

Mit freundlicher Unterstützung von Perplexity Pro

Inspiriert von und aufgebaut auf den Schultern von:

Projekt	Beitrag
Microsoft RD-Agent	Selbstevolvierender Faktor/Modell-Optimierungsloop, LiteLLM-Backend
Moon-Dev AI Agents	Bull/Bär-Debatte, 3-Wege-Risikodebatte, ChromaDB-Gedächtnis
AgenticTrading	Hexagonale Architektur, DAG-Ausführung, Resilienzmuster
SMART_TRADING_MULTIAGENT	Umfangreicher Agenten-Roster, HMM-Regimeerkennung, Black-Litterman
tradesecure-agentic-app	Browser-basierte Ausführung, Human-in-the-Loop, Glassmorphism-UI

NexusTrader — Wo KI-Forschung auf echten Handel trifft.

⭐ Wenn dir dieses Projekt gefällt, hinterlasse einen Stern auf GitHub! ⭐

Name		Name	Last commit message	Last commit date
Latest commit History 46 Commits
.agent		.agent
.codex		.codex
agents		agents
core		core
migrations		migrations
services		services
tests		tests
ui		ui
.dockerignore		.dockerignore
.editorconfig		.editorconfig
.env.example		.env.example
.gitattributes		.gitattributes
.gitignore		.gitignore
AGENTS.md		AGENTS.md
CLAUDE.md		CLAUDE.md
COMPLETION_REPORT.md		COMPLETION_REPORT.md
Dockerfile.backend		Dockerfile.backend
LICENSE		LICENSE
Makefile		Makefile
PHASE1_SUMMARY.txt		PHASE1_SUMMARY.txt
PROJECT_PLAN.md		PROJECT_PLAN.md
README.md		README.md
TODO.md		TODO.md
alembic.ini		alembic.ini
demo_strategy.py		demo_strategy.py
docker-compose.yml		docker-compose.yml
main.py		main.py
requirements.txt		requirements.txt
start.bat		start.bat
status_monitor.py		status_monitor.py
test_golden_path.py		test_golden_path.py

Folders and files

Latest commit

History

Repository files navigation

NexusTrader — Autonomes Multi-Agenten Handelssystem

Über NexusTrader

Aktueller Implementierungsstand (April 2026)

Hinweis zur API-Basisroute im Frontend

Funktionsübersicht

Systemarchitektur

Tech-Stack

Schnellstart

Voraussetzungen

Windows One-Click-Start (Empfohlen)

Manuelle Installation (Docker Compose)

Dienste nach dem Start

Entwicklungsumgebung (ohne Docker)

Konfiguration

Empfohlene Einstellungen für den Einstieg

API-Endpunkte

Analyse & Agenten

Handel & Portfolio

Marktdaten

Konfiguration & System

Projekt-Struktur

Mitwirken

Fehler melden

Code beitragen

Entwicklungsrichtlinien

Lizenz

Haftungsausschluss

Credits & Danksagung

About

Resources

License

Uh oh!

Stars

Watchers

Forks

Releases

Packages 0

Uh oh!

Uh oh!

Contributors

Uh oh!

Languages

Packages