Was macht Clawdfolio?
Quantitatives Portfolio-Toolkit für professionelle Anleger. Multi-Broker-Aggregation (Longport, Moomoo/Futu, Demo), institutionelle Risikoanalyse, Verwaltung des Lebenszyklus von Optionsstrategien, über 20 automatisierte Finanz-Workflows und CSV/JSON-Datenexport.
PyPI: pip install clawdfolio · Repo: https://github.com/YichengYang-Ethan/clawdfolio · Python >= 3.10 (getestet 3.10–3.13)
Vollständige Python-API-Referenz unter API.md und Konfiguration, Umgebungsvariablen, Broker-Setup sowie Monitor-Details unter CONFIG.md.
CLI-Befehle
Alle Befehle unterstützen --broker {longport,futu,demo,all}, --output {console,json} und --config PFAD.
Portfolio
clawdfolio summary # Portfolio-Übersicht (Standardbefehl)
clawdfolio summary --top 20 # Top 20 Positionen anzeigen
clawdfolio quotes AAPL MSFT # Echtzeitkurse
clawdfolio alerts # Preis-/RSI-/PnL-/Konzentrationsalarme
clawdfolio alerts --severity critical
Risikoanalyse
clawdfolio risk # Volatilität, Beta, Sharpe, Sortino, VaR, CVaR, Drawdown
clawdfolio risk --detailed # + RSI-Extremwerte, Konzentration, Sektorenexposure, Portfolio-RSI
Berechnete Risikokennzahlen:
- Volatilität: 20d, 60d, annualisiert
- Beta: vs. SPY, vs. QQQ
- Sharpe Ratio: annualisiert, Überschussrendite / Gesamtvolatilität
- Sortino Ratio: annualisiert, Überschussrendite / nur Abwärtsvolatilität
- VaR: 95 % und 99 % (historisch), absolut und prozentual
- CVaR / Expected Shortfall: 95 % und 99 % – Tail-Risiko jenseits des VaR
- Max Drawdown: historisch und aktuell
- HHI: Herfindahl-Hirschman-Konzentrationsindex
- RSI: Portfolio-RSI (14 Tage)
- Korrelation: Erkennung von Paaren mit hoher Korrelation (>= 0,8)
Gewinne
clawdfolio earnings # Bevorstehende Gewinne (Standard 14 Tage)
clawdfolio earnings --days 30 # 30-Tage-Vorausschau
DCA (Dollar-Cost-Averaging)
clawdfolio dca # DCA-Signale für das Portfolio (Rebalancing + Dip-Erkennung)
clawdfolio dca AAPL --months 12 --amount 1000 # Historischer DCA-Backtest
Signaltypen: REGULAR (geplant), DIP (Preisrückgang vom jüngsten Hoch), REBALANCE (Gewichtsabweichung vom Ziel).
Export
clawdfolio export portfolio # CSV auf stdout
clawdfolio export portfolio --format json # JSON auf stdout
clawdfolio export risk --file risk.csv # Risikokennzahlen in Datei
clawdfolio export alerts --format json --file alerts.json
Exportziele: portfolio, risk, alerts. Formate: csv, json.
Optionen
clawdfolio options expiries TQQQ
clawdfolio options chain TQQQ --expiry 2026-03-21 --side calls --limit 10
clawdfolio options quote TQQQ --expiry 2026-03-21 --strike 80 --type C
clawdfolio options buyback # Buyback-Trigger aus Konfiguration prüfen
clawdfolio options buyback --strict # Exit-Code 1, wenn keine Ziele ausgelöst
Finanz-Workflows
20 gebündelte Workflows in 7 Kategorien. Validierte Einrichtungsreihenfolge:
- Broker-Konnektivität prüfen:
clawdfolio summary --broker demo(sollte 10 Demo-Positionen anzeigen) - Arbeitsbereich initialisieren:
clawdfolio finance initdann mitls ~/.clawdfolio/financeüberprüfen - Verfügbare Workflows auflisten:
clawdfolio finance list - Workflow ausführen:
clawdfolio finance run portfolio_daily_brief_tg - Ausgabe prüfen:
--output jsonfür maschinenlesbare Ergebnisse hinzufügen; bei Fehlern mit--broker demoerneut versuchen, um Broker- von Workflow-Problemen zu isolieren
clawdfolio finance list --category alerts_monitors # Nach Kategorie filtern
clawdfolio finance run dca_proposal_tg -- --budget 5000 # Zusätzliche Argumente übergeben
Kategorien: portfolio_reports, briefing_cards, alerts_monitors, market_intel, broker_snapshots, strategy, security.
Wichtige Workflows:
| ID | Beschreibung |
|---|---|
portfolio_report | Täglicher Portfoliobericht mit Performance, Risiko, Positionen |
portfolio_daily_brief_tg | Telegram-freundliche tägliche Kurzübersicht |
portfolio_alert_monitor | Deduplizierte RSI-/PnL-/Konzentrations-/Bewegungsalarme |
option_buyback_monitor | Zustandsbehafteter Buyback-Trigger-Überwachung |
earnings_calendar | Bevorstehende Gewinne für aktuelle Positionen |
dca_proposal_tg | Budgetbegrenzter DCA-Vorschlag |
account_report | Kombinierte Longport- + moomoo-Übersicht |
Arbeitsbereich: ~/.clawdfolio/finance (konfigurierbar mit --workspace).
Installation
pip install clawdfolio # Kern (yfinance + Demo-Broker)
pip install clawdfolio[longport] # + Longport-Broker
pip install clawdfolio[futu] # + Moomoo/Futu-Broker
pip install clawdfolio[all] # Alle Broker
pip install clawdfolio[dev] # + pytest, mypy, ruff (Entwicklung)
Python-API
Wichtige Importe für die programmatische Nutzung:
from clawdfolio import Symbol, Position, Quote, Portfolio, RiskMetrics, Alert
from clawdfolio.brokers import get_broker
from clawdfolio.analysis.risk import analyze_risk
from clawdfolio.analysis.technical import calculate_rsi, calculate_macd
from clawdfolio.market import get_price, get_history, is_market_open
from clawdfolio.strategies.dca import DCAStrategy, calculate_dca_performance
from clawdfolio.output import export_portfolio_csv, export_risk_json
Vollständige API-Referenz mit Nutzungsbeispielen unter API.md.
Konfiguration
Suchreihenfolge: --config-Flag > CLAWDFOLIO_CONFIG-Umgebungsvariable > ./config.yaml > ~/.config/clawdfolio/config.yaml. Unterstützt YAML und JSON.
Unterstützte Broker: Longport (Umgebungsvariablen), Moomoo/Futu (lokales OpenD), Demo (integriert), Aggregator (Multi-Broker-Zusammenführung).
Vollständige Konfigurationsreferenz, Umgebungsvariablen, Broker-Setup und Monitor-Details unter CONFIG.md.