Communitygithub.com

lacymorrow/alpaca-trading-skill

Handeln Sie Aktien, ETFs, Optionen und Kryptowährungen über die REST-API von Alpaca mit curl. Volle Optionsunterstützung (Kauf/Verkauf von Calls & Puts, gedeckte Calls, cash-gesicherte Puts, Spreads, Ausübung, Vertragssuche, Optionskettendaten). Verwalten Sie Orders, Positionen, Watchlists, Kontoaktivitäten und Portfoliohistorie. Greifen Sie auf Echtzeit- und historische Marktdaten für Aktien, Optionen und Kryptowährungen zu, einschließlich Kurse, Balken, Snapshots, Nachrichten, Screener (meistgehandelt, Top-Mover) und Unternehmensereignisse.

Was ist alpaca-trading-skill?

Diese Fertigkeit ermöglicht es KI-Agenten, direkt über curl und jq mit der Alpaca-Handelsplattform zu interagieren, ohne dass ein externes CLI-Binärprogramm erforderlich ist. Sie deckt ein breites Spektrum an Handelsaktivitäten ab, darunter Aktien, ETFs, Optionen und Kryptowährungen. Zu den unterstützten Funktionen gehören das Erstellen, Ändern und Stornieren von Orders (einschließlich komplexer Optionsstrategien wie gedeckte Calls und Spreads), die Portfolio- und Kontoverwaltung, der Zugriff auf Echtzeit- und historische Marktdaten (Kurse, Balken, Snapshots, Nachrichten) sowie die Nutzung von Marktscreenern für meistgehandelte Aktien und Top-Mover. Die Fertigkeit priorisiert die Nutzung des Paper-Trading-Endpunkts und enthält Sicherheitsregeln, um Benutzer vor dem Wechsel in den Live-Handel zu warnen und riskante Aktionen zu bestätigen.

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

In Ihrer bevorzugten KI fragen

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

Dokumentation

Alpaca Trading Skill

Handeln und Verwalten von Portfolios über die REST-API von Alpaca mit scripts/alpaca.sh.

Einrichtung

Erforderliche Umgebungsvariablen

VariableZweck
APCA_API_KEY_IDAlpaca-API-Schlüssel
APCA_API_SECRET_KEYAlpaca-API-Geheimnis

Optionale Umgebungsvariablen

VariableStandardwertZweck
APCA_API_BASE_URLhttps://paper-api.alpaca.marketsHandelsendpunkt. Auf https://api.alpaca.markets für Live-Handel setzen
APCA_DATA_API_BASE_URLhttps://data.alpaca.marketsMarktdatenendpunkt

Paper-Trading ist die Standardeinstellung. Vor dem Wechsel in den Live-Handel immer die Bestätigung des Benutzers einholen.

Hilfsskript

scripts/alpaca.sh aus diesem Skill-Verzeichnis quellen. Verwendung:

alpaca METHODE PFAD [JSON_BODY]
# Marktdaten:
ALPACA_DATA=1 alpaca METHODE PFAD

Kurzreferenz

Konto & Portfolio

alpaca GET /v2/account                                          # Guthaben, Eigenkapital, Kaufkraft
alpaca GET /v2/account/configurations                           # Handelskonfiguration
alpaca GET '/v2/account/portfolio/history?period=1M&timeframe=1D'  # Portfolio-Diagramm
alpaca GET '/v2/account/activities?activity_types=FILL,DIV'     # Handels-/Dividendenhistorie
alpaca GET /v2/clock                                            # Markt geöffnet/geschlossen
alpaca GET '/v2/calendar?start=2026-03-01&end=2026-03-31'       # Handelstage

Orders — Aktien & Kryptowährungen

# Marktkauf (nach Stückzahl oder Nennbetrag)
alpaca POST /v2/orders '{"symbol":"AAPL","qty":"10","side":"buy","type":"market","time_in_force":"day"}'
alpaca POST /v2/orders '{"symbol":"AAPL","notional":"1000","side":"buy","type":"market","time_in_force":"day"}'

# Kryptowährungen (24/7)
alpaca POST /v2/orders '{"symbol":"BTC/USD","qty":"0.001","side":"buy","type":"market","time_in_force":"gtc"}'

# Limit / Stop / Stop-Limit / Trailing Stop / Bracket / OTO / OCO — siehe references/api.md

# Auflisten / Abrufen / Ersetzen / Stornieren
alpaca GET /v2/orders
alpaca GET /v2/orders/ORDER_ID
alpaca PATCH /v2/orders/ORDER_ID '{"qty":"20","limit_price":"190.00"}'
alpaca DELETE /v2/orders/ORDER_ID
alpaca DELETE /v2/orders                                        # ALLE stornieren

Orders — Optionen

# Call kaufen (Level 2+)
alpaca POST /v2/orders '{"symbol":"AAPL260418C00260000","qty":"1","side":"buy","type":"market","time_in_force":"day"}'

# Gedeckten Call verkaufen (Level 1+, muss 100 Aktien pro Kontrakt besitzen)
alpaca POST /v2/orders '{"symbol":"AAPL260418C00270000","qty":"1","side":"sell","type":"limit","limit_price":"2.00","time_in_force":"day"}'

# Puts kaufen/verkaufen, cash-gesicherte Puts, Spreads (Level 3) — siehe references/api.md

# Option ausüben
alpaca POST /v2/positions/AAPL260418C00260000/exercise

# Kontrakte suchen
alpaca GET '/v2/options/contracts?underlying_symbols=AAPL&expiration_date_gte=2026-04-01&type=call&limit=10'
alpaca GET /v2/options/contracts/AAPL260418C00260000

Positionen

alpaca GET /v2/positions                                        # alle offenen
alpaca GET '/v2/positions?asset_class=us_option'                # nur Optionen
alpaca GET /v2/positions/AAPL                                   # einzelne Aktie
alpaca GET /v2/positions/NVDA260417C00220000                     # einzelne Option
alpaca DELETE /v2/positions/AAPL                                # schließen
alpaca DELETE '/v2/positions/AAPL?qty=5'                        # teilweise schließen
alpaca DELETE '/v2/positions?cancel_orders=true'                # ALLE schließen

Marktdaten — Aktien

ALPACA_DATA=1 alpaca GET /v2/stocks/AAPL/snapshot               # Kurs + Trade + Balken
ALPACA_DATA=1 alpaca GET '/v2/stocks/snapshots?symbols=AAPL,MSFT,GOOGL'  # Multi-Snapshot
ALPACA_DATA=1 alpaca GET '/v2/stocks/AAPL/bars?timeframe=1Day&start=2026-03-01&limit=30'
ALPACA_DATA=1 alpaca GET /v1beta1/screener/stocks/most-actives
ALPACA_DATA=1 alpaca GET '/v1beta1/screener/stocks/movers?top=10'
ALPACA_DATA=1 alpaca GET '/v1beta1/news?symbols=AAPL&limit=5'

Marktdaten — Optionen

ALPACA_DATA=1 alpaca GET '/v1beta1/options/snapshots/AAPL?feed=indicative&limit=10'  # Optionskette
ALPACA_DATA=1 alpaca GET '/v1beta1/options/bars?symbols=NVDA260417C00220000&timeframe=1Day&limit=10'
ALPACA_DATA=1 alpaca GET '/v1beta1/options/quotes/latest?symbols=NVDA260417C00220000'
ALPACA_DATA=1 alpaca GET '/v1beta1/options/trades/latest?symbols=NVDA260417C00220000'
# feed: indicative (kostenlos/verzögert) oder opra (Abonnement erforderlich)

Marktdaten — Kryptowährungen

ALPACA_DATA=1 alpaca GET '/v1beta3/crypto/us/latest/quotes?symbols=BTC/USD'
ALPACA_DATA=1 alpaca GET '/v1beta3/crypto/us/bars?symbols=BTC/USD&timeframe=1Day&limit=30'
ALPACA_DATA=1 alpaca GET '/v1beta3/crypto/us/snapshots?symbols=BTC/USD,ETH/USD'

Unternehmensereignisse

ALPACA_DATA=1 alpaca GET '/v1/corporate-actions?symbols=AAPL&types=cash_dividend'
# Typen: forward_split, reverse_split, cash_dividend, stock_dividend, spin_off, etc.

Assets & Watchlists

alpaca GET /v2/assets/AAPL                                      # Asset-Informationen
alpaca GET '/v2/assets?status=active&attributes=has_options'     # optionsfähige Aktien
alpaca GET /v2/watchlists                                       # Watchlists auflisten
alpaca POST /v2/watchlists '{"name":"Tech","symbols":["AAPL","MSFT","GOOGL"]}'

Vollständige API-Referenz

Lesen Sie references/api.md für die vollständige Endpunkt-Dokumentation, einschließlich:

  • Alle Auftragsarten (Limit, Stop, Stop-Limit, Trailing Stop, Bracket, OCO, OTO)
  • Auftragsfeld-Referenz (side, type, time_in_force, order_class)
  • Watchlist-CRUD
  • Optionskontrakte
  • Historische Balken/Trades/Kurse mit allen Abfrageparametern
  • Kryptowährungs-Endpunkte
  • Marktkalender

Sicherheitsregeln

  1. Standardmäßig Paper-Trading. Setzen Sie APCA_API_BASE_URL niemals ohne explizite Bestätigung des Benutzers auf Live.
  2. Zeigen Sie das Order-JSON vor dem Absenden. Lassen Sie den Benutzer Symbol, Menge, Seite und Typ bestätigen.
  3. Überprüfen Sie die Marktzeit vor dem Platzieren von Orders – Aktien werden nur während der Handelszeiten (9:30-16:00 ET) gehandelt, es sei denn, extended_hours: true ist bei Limit-Orders gesetzt.
  4. Überprüfen Sie die Kaufkraft über GET /v2/account vor großen Orders.
  5. Geben Sie niemals Finanzberatung. Präsentieren Sie Daten; lassen Sie den Benutzer entscheiden.
  6. Warnen Sie vor irreversiblen Aktionen – Schließen aller Positionen, Stornieren aller Orders.

Fehlerbehebung

SymptomLösung
HTTP 401Überprüfen Sie, ob APCA_API_KEY_ID / APCA_API_SECRET_KEY gesetzt und gültig sind
HTTP 403Paper-Schlüssel auf Live-URL oder umgekehrt; überprüfen Sie APCA_API_BASE_URL
HTTP 422 (unzureichende Menge)Überprüfen Sie Kaufkraft, Unterstützung für Teilaktien oder Gültigkeit des Symbols
HTTP 429Rate-Limit erreicht – warten und erneut versuchen; Alpaca erlaubt 200 req/min
Auftrag außerhalb der Geschäftszeiten abgelehntFügen Sie "extended_hours":true hinzu (nur Limit-Orders) oder warten Sie auf Marktöffnung
jq: command not foundSkript fällt auf python3 -m json.tool zurück; installieren Sie jq für bessere Ausgabe

Verwandte Skills