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
- Lade rustup-init.exe herunter und führe es aus
- Ö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:
- Sicherheit zuerst: Empfehle neuen Benutzern oder beim Testen immer das Paper Trading
- Befehle prüfen: Zeige den genauen Befehl vor der Ausführung von Trades
- Voraussetzungen prüfen: Bestätige Marktzeiten, Kontostand und gültige Symbole
- Orderarten erklären: Hilf Benutzern, die richtige Orderart für ihre Bedürfnisse auszuwählen
- 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:
- Registrieren auf https://alpaca.markets/
- Zum Dashboard navigieren
- API-Schlüssel generieren (Paper oder Live)
- 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
- Mit Paper Trading beginnen - Teste Strategien immer zuerst mit Paper Trading
- Limit-Orders verwenden - Vermeide Marktorders in volatilen Situationen für eine bessere Preiskontrolle
- Symbole prüfen - Überprüfe Tickersymbole doppelt, bevor du Trades ausführst
- Vor der Ausführung prüfen - Verwende
apcacli order get, um Orderdetails zu prüfen - Stop-Loss setzen - Schütze Positionen mit Stop-Orders
- Kontostand prüfen - Stelle vor dem Handel ausreichende Kaufkraft sicher
- Positionen überwachen - Prüfe regelmäßig den Gewinn/Verlust mit
apcacli position list
Effektive Nutzung
- Hilfe für jeden Befehl prüfen - Verwende
apcacli <befehl> --helpfür detaillierte Optionen - Order-IDs speichern - Speichere zurückgegebene Order-IDs, um Orders später verfolgen und verwalten zu können
- Umgebungsvariablen verwenden - Bewahre Anmeldedaten sicher in Umgebungsvariablen auf, kodiere sie niemals fest
- Marktzeiten prüfen - Überprüfe
apcacli market clockvor dem Platzieren von Orders - 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
| Aufgabe | Befehl |
|---|---|
| Konto anzeigen | apcacli account get |
| Kontoaktivität | apcacli 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 verkaufen | apcacli order submit sell SYMBOL --quantity N |
| Alle Orders auflisten | apcacli order list |
| Orderdetails abrufen | apcacli order get ORDER_ID |
| Order stornieren | apcacli order cancel ORDER_ID |
| Alle Orders stornieren | apcacli order cancel-all |
| Positionen auflisten | apcacli position list |
| Position abrufen | apcacli position get SYMBOL |
| Position schließen | apcacli position close SYMBOL |
| Alle Positionen schließen | apcacli position close-all |
| Assets auflisten | apcacli asset list |
| Asset-Info abrufen | apcacli asset get SYMBOL |
| Marktstatus prüfen | apcacli market clock |
| Kontoereignisse streamen | apcacli stream account |
| Trades streamen | apcacli 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_IDundAPCA_API_SECRET_KEYsind 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_URLfü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