Was macht SnapTrade Portfolio?
Übersicht
Stelle eine Verbindung zu Brokerkonten über SnapTrade her und generiere einen täglichen Gesamtwertbericht. Diese Fähigkeit verwendet das offizielle SnapTrade Python SDK (snaptrade_client) mit automatischer Signierung der Anfragen.
Arbeitsablauf
2d) Kaufe/Verkaufe Orders (Aktien/ETFs) aufgeben
Ausführen:
python3 scripts/snaptrade_order.py buy|sell TICKER UNITS --account-id <ACCOUNT_ID> [--order-type market|limit] [--limit-price <PREIS>] [--tif Day|GTC|IOC|FOK]
Standardeinstellungen:
- Auftragstyp: market
- Gültigkeit: Day
- Limitpreis: nur bei Limit-Orders erforderlich
Optional Überwachung (kürzliche Orders abrufen):
python3 scripts/snaptrade_order.py buy|sell TICKER UNITS --account-id <ACCOUNT_ID> --watch
- Pollt standardmäßig alle 10s für max. 120s
- Anpassbar mit
--watch-intervalund--watch-seconds
Eine bestehende Order nach ID überwachen:
python3 scripts/snaptrade_watch_order.py --account-id <ACCOUNT_ID> --order-id <BROKER_ORDER_ID>
- Gleiche 10s/120s Standardeinstellungen, anpassbar mit
--watch-intervalund--watch-seconds
Verwende den Account Orders Endpunkt, um Ausführungen zu bestätigen und offene Orders dem Benutzer zu melden, wenn gefragt.
0) SnapTrade-Konto + API-Schlüssel erstellen
Du benötigst ein SnapTrade-Konto, um Broker anzubinden. Erstelle ein kostenloses Konto unter https://snaptrade.com, generiere deine Client-ID und deinen Consumer-Key und füge sie der Skill-Konfiguration hinzu.
1) Abhängigkeiten installieren
pip3 install -r requirements.txt
2) Anmeldedaten konfigurieren (einmalig)
Speichere die Anmeldedaten in einer lokalen Konfigurationsdatei (nicht eingecheckt). user_id wird beim ersten Start automatisch generiert:
/home/openclaw/.openclaw/workspace/secrets/snaptrade.json
Beispiel:
{
"client_id": "DEINE_CLIENT_ID",
"consumer_key": "DEIN_CONSUMER_KEY",
"user_id": "<automatisch-generierte-uuid>"
}
2) Benutzer registrieren + Verbindungsportal-Link generieren
Ausführen:
python3 scripts/snaptrade_portal.py
Dies wird:
- den Benutzer registrieren, falls
user_secretfehlt user_secretzurück in die Konfigurationsdatei speichern- eine Verbindungsportal-URL ausgeben, die der Benutzer öffnen muss, um Konten zu verknüpfen
2b) Eine deaktivierte Verbindung wiederherstellen
Ausführen:
python3 scripts/snaptrade_reconnect.py [broker-name]
Dies wird:
- deaktivierte Verbindungen auflisten
- einen Wiederherstellungslink generieren (optional nach Broker-Name abgleichen)
- eine Wiederherstellungs-URL ausgeben, um die Verbindung für den Benutzer wieder zu aktivieren
2c) Verfügbare Broker auflisten (erlaubte Verbindungen)
Ausführen:
python3 scripts/snaptrade_brokers.py
Dies ruft /snaptrade/partners auf und gibt die Liste der allowed_brokerages (Anzeigenamen) zurück.
3) Gesamtportfoliowert abrufen
Ausführen:
python3 scripts/snaptrade_total.py
Ausgabe ist JSON wie:
{"total_value": 123456.78, "currency": "CAD"}
3b) Pro-Broker Summen (umgerechnete Währung)
Ausführen:
python3 scripts/snaptrade_broker_totals.py --currency CAD
Ausgabe-JSON enthält Pro-Broker Summen in der gewählten Währung sowie die verwendeten Wechselkurse.
Implementierungshinweise: Vermeide get_user_holdings wenn möglich. Bevorzuge get_user_account_positions (Positionsendpunkt) für Bestands-/Positionsdaten. Verwende nur Salden/Bargeld aus Holdings, wenn der Benutzer dies ausdrücklich verlangt; andernfalls rufe Holdings nicht auf.
4) Täglichen Bericht planen
Verwende Cron, um snaptrade_total.py aufzurufen, formatiere eine kurze WhatsApp-Nachricht und sende sie an den Benutzer. Nur der Gesamtwert ist erforderlich.
Skripte
scripts/snaptrade_common.py— Konfiguration laden/speichern + Client-Erstellungscripts/snaptrade_portal.py— Benutzer registrieren + Verbindungsportal-Link generierenscripts/snaptrade_reconnect.py— Wiederherstellungslink für deaktivierte Verbindungen generierenscripts/snaptrade_brokers.py— Erlaubte Broker für diesen Client auflistenscripts/snaptrade_order.py— Kauf-/Verkaufsorders aufgeben (market/limit) mit optionaler Überwachungscripts/snaptrade_watch_order.py— Eine bestehende Order nach ID auf Ausführung überwachenscripts/snaptrade_total.py— Gesamtwert über alle Konten berechnenscripts/snaptrade_broker_totals.py— Pro-Broker Summen mit Währungsumrechnung
Hinweise
- Die Signierung der Anfragen wird vom SDK über
request_after_hookmitconsumer_keyübernommen. - Der Gesamtwert wird durch Summierung des
account.balance.totalaus den Holdings berechnet; dies vermeidet Fehler, wenn Konten hinzugefügt oder entfernt werden. - Wenn mehrere Währungen vorhanden sind, verwendet das Skript die erste gefundene Währung.
- Bewahre Geheimnisse in der lokalen Konfigurationsdatei mit Berechtigungen
chmod 600.