Communitygithub.com

lacymorrow/openclaw-alpaca-trading-skill

Führe Trades aus, analysiere Märkte und verwalte Portfolios mit dem apcacli-Kommandozeilentool für die Alpaca Trading API. Nutze es bei Aktienkauf/-verkauf, Optionshandel, Krypto, Marktdaten, Positionen, Orders und Portfoliomanagement.

Was ist openclaw-alpaca-trading-skill?

Diese Fähigkeit ermöglicht es, über die Alpaca Trading API direkt von der Kommandozeile aus zu handeln. Sie bietet umfassende Funktionen zur Ordererstellung (Markt-, Limit-, Stop- und Trailing-Stop-Orders), zur Verwaltung offener Positionen (Schließen einzelner oder aller Positionen) sowie zum Abrufen von Kontoinformationen, Marktdaten und Asset-Details. Unterstützt werden Aktien, ETFs, Optionen und Kryptowährungen in Papier- und Live-Umgebungen. Die installierte `apcacli`-Rust-CLI sowie die API-Schlüssel als Umgebungsvariablen sind Voraussetzung; die Nutzung beginnt mit der Installation über Cargo und dem Export von `APCA_API_KEY_ID` und `APCA_API_SECRET_KEY`. Die ausführliche SKILL.md-Dokumentation enthält alle Befehle, Best Practices für Risikomanagement, Troubleshooting-Hinweise und praktische Workflow-Beispiele.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add lacymorrow/openclaw-alpaca-trading-skill

In Ihrer bevorzugten KI fragen

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

Dokumentation

Alpaca Trading Skill

Führe Trades aus und verwalte Portfolios mit dem Kommandozeilen-Tool apcacli für die Alpaca Trading API.

Installation

apcacli ist ein Rust-CLI. Installiere es plattformunabhängig:

macOS (Homebrew)

brew install rustup
rustup-init -y
source "$HOME/.cargo/env"
cargo install apcacli

Linux

curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh -s -- -y
source "$HOME/.cargo/env"
cargo install apcacli

Windows

  1. Lade rustup-init.exe herunter und führe es aus
  2. Öffne ein neues Terminal und führe aus: cargo install apcacli

Umgebungsvariablen

export APCA_API_KEY_ID='dein-key-id'
export APCA_API_SECRET_KEY='dein-geheimer-schlüssel'
# Für Live-Handel (Standard ist Paper Trading):
# export APCA_API_BASE_URL='https://api.alpaca.markets'

Überblick

Du bist ein Experte in der Nutzung von apcacli für den Aktienhandel über die Kommandozeile. Dein Ziel ist es, Benutzern zu helfen, Aktien, ETFs, Optionen und Kryptowährungen effizient über die Alpaca-API zu handeln, wobei Sicherheit und Best Practices im Vordergrund stehen.

Verwendung dieser Fähigkeit

Bei der Unterstützung von Benutzern bei Handelsaufgaben:

  1. Sicherheit zuerst: Empfehle neuen Benutzern oder beim Testen immer das Paper Trading
  2. Befehle prüfen: Zeige den genauen Befehl vor der Ausführung von Trades
  3. Voraussetzungen prüfen: Bestätige Marktzeiten, Kontostand und gültige Symbole
  4. Orderarten erklären: Hilf Benutzern, die richtige Orderart für ihre Bedürfnisse auszuwählen
  5. Risikomanagement: Schlage Stop-Loss und Positionsgrößen vor

Was diese Fähigkeit tut

apcacli ist eine Rust-basierte CLI für die Interaktion mit der Alpaca-Handelsplattform. Sie bietet:

  • Handel: Orders für Aktien, ETFs, Optionen und Kryptowährungen aufgeben, ändern und stornieren
  • Portfoliomanagement: Positionen, Gewinn/Verlust und Kontoinformationen anzeigen
  • Marktdaten: Auf Asset-Informationen und Marktuhrenstatus zugreifen
  • Kontoaktivität: Handelshistorie und Kontoänderungen verfolgen
  • Echtzeit-Streaming: Konto- und Handelsereignisse überwachen

Wann diese Fähigkeit verwendet werden soll

Verwende diese Fähigkeit, wenn der Benutzer möchte:

  • Trades ausführen (Aktien, ETFs, Optionen, Kryptowährungen kaufen/verkaufen)
  • Portfolio-Positionen und Performance prüfen
  • Orders anzeigen oder verwalten (offen, gefüllt, storniert)
  • Kontostand und Kaufkraft abrufen
  • Marktdaten und Asset-Informationen abrufen
  • Kontoaktivitäten und Ereignisse überwachen
  • Prüfen, ob der Markt geöffnet ist
  • Stop-Loss oder Trailing-Stops einrichten
  • Handelsworkflows mit Skripten automatisieren

Häufige Auslösephrasen:

  • "Kaufe 10 Aktien von AAPL"
  • "Zeige meine offenen Positionen"
  • "Wie hoch ist mein Kontostand?"
  • "Liste alle meine Orders"
  • "Storniere Order [ID]"
  • "Ist der Markt geöffnet?"
  • "Zeige meine Portfolio-Performance"
  • "Setze einen Stop-Loss auf meine Position"
  • "Schließe alle meine Positionen"

Wann diese Fähigkeit NICHT verwendet werden soll:

  • Benutzer möchte GUI-basiertes Trading (verweise auf die Weboberfläche)
  • Benutzer fragt nach Finanzberatung (Stelle Werkzeuge bereit, keine Empfehlungen)
  • Benutzer möchte mit Instrumenten handeln, die nicht von Alpaca unterstützt werden
  • Benutzer hat apcacli nicht installiert (hilf zuerst bei der Installation)

Installation und Einrichtung

apcacli installieren

# Mit Cargo (Rust-Paketmanager)
cargo install apcacli

# Installation überprüfen
apcacli --help

Voraussetzungen:

  • Rust 1.71 oder neuer
  • Alpaca-Konto (Paper oder Live Trading)
  • Alpaca-API-Anmeldedaten

Umgebungsvariablen konfigurieren

Für Paper Trading (empfohlen zum Testen):

export APCA_API_KEY_ID='dein_paper_key_id'
export APCA_API_SECRET_KEY='dein_paper_geheimer_schlüssel'
# Paper Trading ist die Standardeinstellung, APCA_API_BASE_URL muss nicht gesetzt werden

Für Live Trading:

export APCA_API_BASE_URL='https://api.alpaca.markets'
export APCA_API_KEY_ID='dein_live_key_id'
export APCA_API_SECRET_KEY='dein_live_geheimer_schlüssel'

API-Anmeldedaten abrufen:

  1. Registrieren auf https://alpaca.markets/
  2. Zum Dashboard navigieren
  3. API-Schlüssel generieren (Paper oder Live)
  4. Die Umgebungsvariablen exportieren

Kernbefehle

Kontoinformationen

Kontodetails anzeigen:

apcacli account get

Zeigt Kontostatus, Barbestand, Kaufkraft, Eigenkapital und Margin-Informationen an.

Kontoaktivität anzeigen:

apcacli account activity

Zeigt die letzten Kontoaktivitäten, einschließlich Trades, Dividenden und Überweisungen.

Kontokonfiguration aktualisieren:

apcacli account config <optionen>

Ändere Kontoeinstellungen (verwende --help für verfügbare Optionen).

Orderverwaltung

Eine Marktorder aufgeben:

# Mit Dollarbetrag kaufen
apcacli order submit buy AAPL --value 1000

# Bestimmte Stückzahl kaufen
apcacli order submit buy AAPL --quantity 10

# Aktien verkaufen
apcacli order submit sell TSLA --quantity 5

Eine Limitorder aufgeben:

# Zu einem bestimmten Preis kaufen
apcacli order submit buy MSFT --quantity 10 --limit-price 420

# Zu einem bestimmten Preis verkaufen
apcacli order submit sell NVDA --quantity 20 --limit-price 850

Erweiterte Orders aufgeben:

# Stop-Order
apcacli order submit sell AAPL --quantity 10 --stop-price 180

# Stop-Limit-Order
apcacli order submit sell TSLA --quantity 5 --stop-price 800 --limit-price 795

# Trailing-Stop-Order (prozentual)
apcacli order submit sell NVDA --quantity 10 --trail-percent 5

Alle Orders auflisten:

apcacli order list

Zeigt alle Orders mit ihrem Status (offen, gefüllt, storniert usw.).

Bestimmte Orderdetails abrufen:

apcacli order get <ORDER_ID>

Zeigt umfassende Orderinformationen, einschließlich Zeitstempel, Preis und Status.

Eine Order stornieren:

apcacli order cancel <ORDER_ID>

Storniert eine ausstehende Order anhand ihrer ID.

Alle Orders stornieren:

apcacli order cancel-all

Storniert alle offenen Orders.

Positionsverwaltung

Alle offenen Positionen auflisten:

apcacli position list

Zeigt alle offenen Positionen mit:

  • Stückzahl und Einstiegspreis
  • Aktueller Marktwert
  • Täglichem Gewinn/Verlust (mit Prozentsatz)
  • Gesamtgewinn/-verlust (mit Prozentsatz)
  • Farbcodiertem Gewinn/Verlust

Bestimmte Position abrufen:

apcacli position get <SYMBOL>

Zeigt detaillierte Informationen zu einer bestimmten Position an.

Eine Position schließen:

# Gesamte Position schließen
apcacli position close <SYMBOL>

# Teilweise schließen
apcacli position close <SYMBOL> --quantity 5

Alle Positionen schließen:

apcacli position close-all

Schließt alle offenen Positionen.

Asset-Informationen

Verfügbare Assets auflisten:

apcacli asset list

Zeigt alle handelbaren Assets.

Asset-Details abrufen:

apcacli asset get <SYMBOL>

Zeigt Asset-Informationen, einschließlich Börse, Klasse und Handelsstatus.

Nach Assets suchen:

apcacli asset search <SUCHE>

Sucht nach Assets, die der Abfrage entsprechen.

Marktdaten

Marktuhr prüfen:

apcacli market clock

Zeigt den aktuellen Marktstatus (geöffnet/geschlossen), nächste Öffnungszeit und nächste Schließzeit.

Streaming (Echtzeit-Ereignisse)

Kontoaktualisierungen streamen:

apcacli stream account

Überwacht Echtzeit-Kontoereignisse, einschließlich Orderaktualisierungen und Ausführungen.

Handelsaktualisierungen streamen:

apcacli stream trades

Überwacht Echtzeit-Handelsereignisse für deine Positionen.

Best Practices

Sicherheit und Risikomanagement

  1. Mit Paper Trading beginnen - Teste Strategien immer zuerst mit Paper Trading
  2. Limit-Orders verwenden - Vermeide Marktorders in volatilen Situationen für eine bessere Preiskontrolle
  3. Symbole prüfen - Überprüfe Tickersymbole doppelt, bevor du Trades ausführst
  4. Vor der Ausführung prüfen - Verwende apcacli order get, um Orderdetails zu prüfen
  5. Stop-Loss setzen - Schütze Positionen mit Stop-Orders
  6. Kontostand prüfen - Stelle vor dem Handel ausreichende Kaufkraft sicher
  7. Positionen überwachen - Prüfe regelmäßig den Gewinn/Verlust mit apcacli position list

Effektive Nutzung

  1. Hilfe für jeden Befehl prüfen - Verwende apcacli <befehl> --help für detaillierte Optionen
  2. Order-IDs speichern - Speichere zurückgegebene Order-IDs, um Orders später verfolgen und verwalten zu können
  3. Umgebungsvariablen verwenden - Bewahre Anmeldedaten sicher in Umgebungsvariablen auf, kodiere sie niemals fest
  4. Marktzeiten prüfen - Überprüfe apcacli market clock vor dem Platzieren von Orders
  5. Aktivität regelmäßig prüfen - Überwache Kontoaktivitäten auf unerwartete Änderungen

Häufige Workflows

Einfacher Aktienkauf:

# 1. Kontostand prüfen
apcacli account get

# 2. Prüfen, ob das Asset handelbar ist
apcacli asset get AAPL

# 3. Prüfen, ob der Markt geöffnet ist
apcacli market clock

# 4. Marktorder aufgeben
apcacli order submit buy AAPL --value 1000

# 5. Position prüfen
apcacli position list

Limit-Order mit Überwachung:

# 1. Limit-Order aufgeben
apcacli order submit buy MSFT --quantity 10 --limit-price 420

# 2. Zurückgegebene ORDER_ID speichern
# 3. Orderstatus prüfen
apcacli order get <ORDER_ID>

# 4. Falls nötig, stornieren
apcacli order cancel <ORDER_ID>

Portfolio-Überprüfung:

# 1. Alle Positionen anzeigen
apcacli position list

# 2. Kontozusammenfassung prüfen
apcacli account get

# 3. Letzte Aktivität prüfen
apcacli account activity

Position mit Stop-Loss schließen:

# 1. Aktuelle Position prüfen
apcacli position get AAPL

# 2. Trailing-Stop setzen, um Gewinne zu schützen
apcacli order submit sell AAPL --quantity 10 --trail-percent 5

# 3. Order überwachen
apcacli order list

Kurzreferenz Befehle

AufgabeBefehl
Konto anzeigenapcacli account get
Kontoaktivitätapcacli account activity
Aktie kaufen (Markt)apcacli order submit buy SYMBOL --value AMOUNT
Aktie kaufen (Limit)apcacli order submit buy SYMBOL --quantity N --limit-price PRICE
Aktie verkaufenapcacli order submit sell SYMBOL --quantity N
Alle Orders auflistenapcacli order list
Orderdetails abrufenapcacli order get ORDER_ID
Order stornierenapcacli order cancel ORDER_ID
Alle Orders stornierenapcacli order cancel-all
Positionen auflistenapcacli position list
Position abrufenapcacli position get SYMBOL
Position schließenapcacli position close SYMBOL
Alle Positionen schließenapcacli position close-all
Assets auflistenapcacli asset list
Asset-Info abrufenapcacli asset get SYMBOL
Marktstatus prüfenapcacli market clock
Kontoereignisse streamenapcacli stream account
Trades streamenapcacli stream trades

Orderarten und Parameter

Grundlegende Orderparameter

  • --quantity N - Anzahl der zu handelnden Aktien
  • --value AMOUNT - Dollarbetrag zum investieren (für Marktorders)
  • --limit-price PRICE - Limitpreis für Limit-Orders
  • --stop-price PRICE - Stopppreis für Stop-Orders
  • --trail-percent N - Trailing-Stop-Prozentsatz
  • --trail-amount AMOUNT - Trailing-Stop-Dollarbetrag

Orderarten

Marktorder - Wird sofort zum aktuellen Marktpreis ausgeführt

apcacli order submit buy AAPL --quantity 10

Limitorder - Wird nur zum angegebenen Preis oder besser ausgeführt

apcacli order submit buy AAPL --quantity 10 --limit-price 185

Stoporder - Wird in eine Marktorder umgewandelt, wenn der Stopppreis erreicht wird

apcacli order submit sell AAPL --quantity 10 --stop-price 180

Stop-Limit-Order - Wird in eine Limitorder umgewandelt, wenn der Stopppreis erreicht wird

apcacli order submit sell AAPL --quantity 10 --stop-price 180 --limit-price 179

Trailing Stop - Der Stopppreis folgt dem Markt um einen bestimmten Prozentsatz oder Betrag

# Prozentbasiert
apcacli order submit sell AAPL --quantity 10 --trail-percent 5

# Dollar-basiert
apcacli order submit sell AAPL --quantity 10 --trail-amount 10

Wichtige Hinweise

Voraussetzungen

  • apcacli-Binärdatei muss installiert sein - Installieren über cargo install apcacli
  • Umgebungsvariablen müssen gesetzt sein - APCA_API_KEY_ID und APCA_API_SECRET_KEY sind erforderlich
  • Alpaca-Konto - Aktives Paper- oder Live-Handelskonto
  • Rust 1.71+ - Erforderlich für die Installation aus dem Quellcode

Handelsbeschränkungen

  • Paper vs. Live: Standard ist Paper Trading; setze APCA_API_BASE_URL für Live Trading
  • Marktzeiten: Die meisten Trades werden nur während der Marktzeiten (9:30 - 16:00 Uhr ET) ausgeführt
  • Pattern Day Trading (PDT): Konten unter 25.000 $ unterliegen PDT-Beschränkungen
  • Kaufkraft: Begrenzt durch Kontoeigenkapital und Margin-Anforderungen
  • Orderbeschränkungen: Einige Orderarten sind möglicherweise nicht für alle Wertpapiere verfügbar
  • Krypto-Handel: Kann abweichende Regeln und Handelszeiten haben

Daten und Leistung

  • API-Ratenlimits: Alpaca hat Anfragebeschränkungen, um Missbrauch zu verhindern
  • Echtzeitdaten: Erfordern möglicherweise ein aktives Datenabonnement
  • Befehlsausgabe: Ergebnisse sind farbcodiert für einfaches Lesen formatiert
  • Order-IDs: Speichere zurückgegebene Order-IDs zur Nachverfolgung und Verwaltung
  • Netzwerkabhängigkeit: Erfordert Internetverbindung zur Alpaca-API

Fehlerbehebung

Umgebungsvariablen nicht gesetzt

# Fehler: "Missing APCA_API_KEY_ID"
# Lösung: Erforderliche Umgebungsvariablen exportieren
export APCA_API_KEY_ID='dein_key'
export APCA_API_SECRET_KEY='dein_geheimnis'

Befehl nicht gefunden

# Fehler: "apcacli: command not found"
# Lösung: apcacli installieren
cargo install apcacli

# Installation überprüfen
which apcacli

API-Authentifizierung fehlgeschlagen

  • Überprüfe, ob die API-Anmeldedaten korrekt sind
  • Prüfe, ob der richtige Endpunkt verwendet wird (Paper vs. Live)
  • Stelle sicher, dass die API-Schlüssel nicht widerrufen wurden
  • Bestätige, dass der Kontostatus aktiv ist

Order abgelehnt

  • Überprüfe, ob der Markt geöffnet ist (für Aktien)
  • Stelle ausreichende Kaufkraft sicher
  • Bestätige, dass das Symbol gültig und handelbar ist
  • Überprüfe die Orderparameter (Preis, Menge)
  • Prüfe auf Kontobeschränkungen

Position nicht gefunden

  • Überprüfe, ob das Symbol korrekt ist
  • Stelle sicher, dass die Position tatsächlich offen ist
  • Prüfe, ob die Position zuvor geschlossen wurde
  • Bestätige, dass das richtige Konto verwendet wird (Paper vs. Live)

Erweiterte Funktionen

Shell-Vervollständigung

Generiere Shell-Vervollständigung für schnellere Befehlseingabe:

# Vervollständigungsskript installieren
cargo run --bin=shell-complete > apcacli.bash
source apcacli.bash

# Jetzt kannst du die Tabulator-Vervollständigung nutzen
apcacli order <TAB>

Streaming zur Überwachung

Verwende Streaming-Befehle, um Kontoaktivitäten in Echtzeit zu überwachen:

# Terminal 1: Kontoereignisse überwachen
apcacli stream account

# Terminal 2: Trades ausführen
apcacli order submit buy AAPL

Verwandte Skills