Communitygithub.com

SnapTrade Portfolio

Verbindung zu den Anlagekonten eines Benutzers über das SnapTrade SDK herstellen und Portfolioreports (z. B. täglicher Gesamtwert) generieren. Verwende dies, wenn der Benutzer eine SnapTrade-basierte Broker-Konnektivität (Webull, E*TRADE usw.), Verbindungsportal-Links, Kontoregistrierung oder automatisierte Portfoliozusammenfassungen benötigt.

Was ist SnapTrade Portfolio?

Diese Fähigkeit ermöglicht es einem KI-Assistenten, sich über das SnapTrade SDK mit den Brokerkonten eines Benutzers zu verbinden und automatisierte Portfolioreports zu erstellen. Der Assistent kann Benutzer registrieren, Verbindungslinks generieren, Konten verknüpfen, Orders aufgeben und überwachen sowie tägliche Gesamtwertberichte ausgeben. Sie unterstützt mehrere Broker (Webull, E*TRADE usw.) und Plattformen, die SnapTrade integrieren, und eignet sich ideal für Anwendungsfälle wie persönliche Finanzassistenten oder automatisierte Reporting-Tools. Die Fähigkeit nutzt das offizielle `snaptrade_client` Python SDK mit automatischer Signierung der Anfragen und stellt mehrere Skripte für gängige Aufgaben wie Kontoregistrierung, Depotübersicht, Orderausführung und Überwachung bereit. Die Konfiguration erfolgt über eine lokale JSON-Datei, die die API-Schlüssel und den Benutzer-UUID enthält. Der Daily-Report kann per Cron-Job automatisiert und als kurze Nachricht (z. B. WhatsApp) an den Benutzer gesendet werden. Die Fähigkeit ist besonders nützlich für Benutzer, die eine zentrale Verwaltung mehrerer Brokerkonten und einen schnellen Überblick über ihr Gesamtportfolio wünschen.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/baneeishaque/ljt-520_openclaw-backup/tree/HEAD/skills/brendanwood/portfolio-trader

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

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-interval und --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-interval und --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_secret fehlt
  • user_secret zurü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-Erstellung
  • scripts/snaptrade_portal.py — Benutzer registrieren + Verbindungsportal-Link generieren
  • scripts/snaptrade_reconnect.py — Wiederherstellungslink für deaktivierte Verbindungen generieren
  • scripts/snaptrade_brokers.py — Erlaubte Broker für diesen Client auflisten
  • scripts/snaptrade_order.py — Kauf-/Verkaufsorders aufgeben (market/limit) mit optionaler Überwachung
  • scripts/snaptrade_watch_order.py — Eine bestehende Order nach ID auf Ausführung überwachen
  • scripts/snaptrade_total.py — Gesamtwert über alle Konten berechnen
  • scripts/snaptrade_broker_totals.py — Pro-Broker Summen mit Währungsumrechnung

Hinweise

  • Die Signierung der Anfragen wird vom SDK über request_after_hook mit consumer_key übernommen.
  • Der Gesamtwert wird durch Summierung des account.balance.total aus 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.

Individual skills in this repo

This repo contains 13 individual skills — each has its own dedicated page.

baneeishaque/ljt-520_openclaw-backup

Complete investment portfolio risk management system. Analyze positions, calculate risk metrics, stress test scenarios, optimize allocations, and generate institutional-grade risk reports — all without external APIs.

baneeishaque/ljt-520_openclaw-backup

Balance tracking, order overview, and market data across exchanges using OpenMM.

baneeishaque/ljt-520_openclaw-backup

Balance tracking, order overview, and market data across exchanges using OpenMM.

baneeishaque/ljt-520_openclaw-backup

An investment portfolio tracker that runs entirely locally. All data stays in ~/.portfolio-tracker/.

baneeishaque/ljt-520_openclaw-backup

Discover and register autonomous AI agents. Use when: browsing the agent registry, submitting an agent for verification, or embedding agent badges. NOT for: general web search or agent capability analysis.

baneeishaque/ljt-520_openclaw-backup

Query land ownership, leases, landlord info, and land payments. Write operations for payment management and lease renewals.

baneeishaque/ljt-520_openclaw-backup

Build high-converting landing pages and product sales pages using proven 10-section conversion frameworks. Includes Hero → Social Proof → Benefits → CTA flow for both lead capture and e-commerce pages.

baneeishaque/ljt-520_openclaw-backup

Generate complete, responsive HTML landing pages from a product name, tagline, and description. Clean CSS, mobile-ready, with hero, features, CTA, and footer sections.

baneeishaque/ljt-520_openclaw-backup

Optimize conversion pages for paid traffic from Meta (Facebook/Instagram), Google Ads, TikTok Ads, YouTube Ads, Amazon Ads, and Shopify Ads journeys.

baneeishaque/ljt-520_openclaw-backup

Perform a structured conversion rate optimization (CRO) audit of a landing page. Use when a user shares a landing page URL, pastes their page copy, describes their page content, or uploads a screenshot and asks for a conversion audit, CRO review, conversion analysis, landing page feedback, or wants to know why their page isn't converting. Produces a scored 8-factor audit (0–80 total), prioritized fix list with quick wins and strategic recommendations, and an executive summary. Covers: headline clarity, supporting copy, social proof, CTA effectiveness, visual hierarchy, trust signals, mobile/speed signals, and offer clarity.

baneeishaque/ljt-520_openclaw-backup

Generate landing page content from PRD — hero section, features, A/B headline variants, CTA, and SEO meta tags. Use when user says "create landing page", "write landing copy", "hero section", "A/B headlines", or "landing content". Can scaffold actual pages for astro-static. Do NOT use for SEO auditing (use /seo-audit).

baneeishaque/ljt-520_openclaw-backup

Build high-converting landing pages with proven structure, persuasive copy, and conversion optimization.

baneeishaque/ljt-520_openclaw-backup

Track a crypto portfolio across Binance, Hyperliquid, and Polymarket. Calculates NAV, unrealized P&L, daily drawdown, win rate, and equity curve. Use when you need portfolio tracking, NAV calculation, drawdown monitoring, or multi-venue position management.

Verwandte Skills