Alpaca Trading Skill
Handeln und Verwalten von Portfolios über die REST-API von Alpaca mit scripts/alpaca.sh.
Einrichtung
Erforderliche Umgebungsvariablen
| Variable | Zweck |
|---|---|
APCA_API_KEY_ID | Alpaca-API-Schlüssel |
APCA_API_SECRET_KEY | Alpaca-API-Geheimnis |
Optionale Umgebungsvariablen
| Variable | Standardwert | Zweck |
|---|---|---|
APCA_API_BASE_URL | https://paper-api.alpaca.markets | Handelsendpunkt. Auf https://api.alpaca.markets für Live-Handel setzen |
APCA_DATA_API_BASE_URL | https://data.alpaca.markets | Marktdatenendpunkt |
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
- Standardmäßig Paper-Trading. Setzen Sie
APCA_API_BASE_URLniemals ohne explizite Bestätigung des Benutzers auf Live. - Zeigen Sie das Order-JSON vor dem Absenden. Lassen Sie den Benutzer Symbol, Menge, Seite und Typ bestätigen.
- Ü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: trueist bei Limit-Orders gesetzt. - Überprüfen Sie die Kaufkraft über
GET /v2/accountvor großen Orders. - Geben Sie niemals Finanzberatung. Präsentieren Sie Daten; lassen Sie den Benutzer entscheiden.
- Warnen Sie vor irreversiblen Aktionen – Schließen aller Positionen, Stornieren aller Orders.
Fehlerbehebung
| Symptom | Lösung |
|---|---|
HTTP 401 | Überprüfen Sie, ob APCA_API_KEY_ID / APCA_API_SECRET_KEY gesetzt und gültig sind |
HTTP 403 | Paper-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 429 | Rate-Limit erreicht – warten und erneut versuchen; Alpaca erlaubt 200 req/min |
| Auftrag außerhalb der Geschäftszeiten abgelehnt | Fügen Sie "extended_hours":true hinzu (nur Limit-Orders) oder warten Sie auf Marktöffnung |
jq: command not found | Skript fällt auf python3 -m json.tool zurück; installieren Sie jq für bessere Ausgabe |