Communitygithub.com

Compétence de Trading Alpaca

Négociez actions, ETF, options et crypto via l'API REST d'Alpaca en utilisant curl. Support complet des options (achat/vente de calls & puts, calls couverts, puts couverts par du cash, spreads, exercice, recherche de contrats, données de chaîne d'options). Gérez les ordres, positions, listes de suivi, activités de compte et historique de portefeuille. Accédez aux données de marché en temps réel et historiques pour actions, options et crypto, y compris cotations, barres, instantanés, actualités, cribleur (plus actifs, tops mouvements) et actions corporatives.

Qu'est-ce que Compétence de Trading Alpaca ?

Cette compétence pour agent IA permet de trader et gérer des portefeuilles via l'API REST d'Alpaca en utilisant un simple script shell (`scripts/alpaca.sh`) qui s'appuie sur curl et jq. Elle supporte les actions, ETF, options (niveaux 1, 2 et 3) et crypto-monnaies (24/7). Les fonctionnalités incluent la passation d'ordres (market, limit, stop, trailing stop, bracket, OCO, OTO), la gestion des positions, des watchlists, l'accès aux données de marché (cotations, barres, instantanés, actualités, cribleur comme 'most active' et 'top movers'), et la consultation des activités de compte et de l'historique du portefeuille. La compétence est compatible avec tout environnement disposant de curl, jq et un shell bash (Linux, macOS, WSL). Elle est conçue pour des agents comme Claude Code, Cursor, Codex, etc. La configuration se fait via des variables d'environnement (`APCA_API_KEY_ID`, `APCA_API_SECRET_KEY`) et utilise par défaut le paper trading (bac à sable). Des règles de sécurité empêchent tout passage en production sans confirmation explicite de l'utilisateur, et exigent d'afficher le JSON de l'ordre avant soumission.

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add lacymorrow/alpaca-trading-skill

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Que fait Compétence de Trading Alpaca ?

Tradez et gérez des portefeuilles via l'API REST d'Alpaca en utilisant scripts/alpaca.sh.

Configuration

Variables d'environnement requises

VariableObjectif
APCA_API_KEY_IDClé API Alpaca
APCA_API_SECRET_KEYSecret API Alpaca

Variables d'environnement facultatives

VariableValeur par défautObjectif
APCA_API_BASE_URLhttps://paper-api.alpaca.marketsPoint de terminaison de trading. Définir sur https://api.alpaca.markets pour le trading en direct
APCA_DATA_API_BASE_URLhttps://data.alpaca.marketsPoint de terminaison des données de marché

Le paper trading est la valeur par défaut. Confirmez toujours avec l'utilisateur avant de passer en direct.

Script d'aide

Sourcez scripts/alpaca.sh depuis ce répertoire de compétence. Utilisation :

alpaca MÉTHODE CHEMIN [JSON_BODY]
# Données de marché :
ALPACA_DATA=1 alpaca MÉTHODE CHEMIN

Référence rapide

Compte et portefeuille

alpaca GET /v2/account                                          # solde, capitaux propres, pouvoir d'achat
alpaca GET /v2/account/configurations                           # configuration de trading
alpaca GET GET '/v2/account/portfolio/history?period=1M&timeframe=1D'  # graphique du portefeuille
alpaca GET GET '/v2/account/activities?activity_types=FILL,DIV'     # historique des transactions/dividendes
alpaca GET /v2/clock                                            # marché ouvert/fermé
alpaca GET GET '/v2/calendar?start=2026-03-01&end=2026-03-31'       # jours de bourse

Ordres — Actions et Crypto

# Achat au marché (par quantité ou montant en dollars)
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"}'

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

# Limite / stop / stop-limite / trailing stop / bracket / OTO / OCO — voir references/api.md

# Lister / obtenir / remplacer / annuler
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                                        # annuler TOUT

Ordres — Options

# Acheter un call (Niveau 2+)
alpaca POST /v2/orders '{"symbol":"AAPL260418C00260000","qty":"1","side":"buy","type":"market","time_in_force":"day"}'

# Vendre un call couvert (Niveau 1+, doit posséder 100 actions par contrat)
alpaca POST /v2/orders '{"symbol":"AAPL260418C00270000","qty":"1","side":"sell","type":"limit","limit_price":"2.00","time_in_force":"day"}'

# Acheter/vendre des puts, puts couverts par du cash, spreads (Niveau 3) — voir references/api.md

# Exercer une option
alpaca POST /v2/positions/AAPL260418C00260000/exercise

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

Positions

alpaca GET /v2/positions                                        # toutes les positions ouvertes
alpaca GET '/v2/positions?asset_class=us_option'                # options uniquement
alpaca GET /v2/positions/AAPL                                   # action individuelle
alpaca GET /v2/positions/NVDA260417C00220000                     # option individuelle
alpaca DELETE /v2/positions/AAPL                                # fermer
alpaca DELETE '/v2/positions/AAPL?qty=5'                        # fermeture partielle
alpaca DELETE '/v2/positions?cancel_orders=true'                # fermer TOUT

Données de marché — Actions

ALPACA_DATA=1 alpaca GET /v2/stocks/AAPL/snapshot               # cours + transaction + barre
ALPACA_DATA=1 alpaca GET '/v2/stocks/snapshots?symbols=AAPL,MSFT,GOOGL'  # multi-instantané
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'

Données de marché — Options

ALPACA_DATA=1 alpaca GET '/v1beta1/options/snapshots/AAPL?feed=indicative&limit=10'  # chaîne d'options
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 (gratuit/retardé) ou opra (abonnement requis)

Données de marché — Crypto

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'

Actions corporatives

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

Actifs et listes de suivi

alpaca GET /v2/assets/AAPL                                      # informations sur l'actif
alpaca GET '/v2/assets?status=active&attributes=has_options'     # actions éligibles aux options
alpaca GET /v2/watchlists                                       # lister les listes de suivi
alpaca POST /v2/watchlists '{"name":"Tech","symbols":["AAPL","MSFT","GOOGL"]}'

Référence complète de l'API

Lisez references/api.md pour la documentation complète des points de terminaison, y compris :

  • Tous les types d'ordres (limite, stop, stop-limite, trailing stop, bracket, OCO, OTO)
  • Référence des champs d'ordre (side, type, time_in_force, order_class)
  • CRUD des listes de suivi
  • Contrats d'options
  • Barres/transactions/cotations historiques avec tous les paramètres de requête
  • Points de terminaison crypto
  • Calendrier du marché

Règles de sécurité

  1. Par défaut, utiliser le paper trading. Ne jamais définir APCA_API_BASE_URL sur le trading en direct sans confirmation explicite de l'utilisateur.
  2. Afficher le JSON de l'ordre avant soumission. Laisser l'utilisateur confirmer le symbole, la quantité, le côté et le type.
  3. Vérifier l'horloge du marché avant de passer des ordres — les actions ne se négocient que pendant les heures de marché (9h30-16h00 ET) sauf si extended_hours: true sur les ordres à limite.
  4. Vérifier le pouvoir d'achat via GET /v2/account avant les ordres importants.
  5. Ne jamais fournir de conseils financiers. Présentez les données ; laissez l'utilisateur décider.
  6. Avertir sur les actions irréversibles — fermeture de toutes les positions, annulation de tous les ordres.

Dépannage

SymptômeCorrectif
HTTP 401Vérifiez que APCA_API_KEY_ID / APCA_API_SECRET_KEY sont définis et valides
HTTP 403Clés papier sur URL de trading en direct ou vice versa ; vérifiez APCA_API_BASE_URL
HTTP 422 (quantité insuffisante)Vérifiez le pouvoir d'achat, le support fractionnaire ou la validité du symbole
HTTP 429Limite de débit atteinte — attendez et réessayez ; Alpaca autorise 200 req/min
Ordre rejeté en dehors des heuresAjoutez "extended_hours":true (ordres à limite uniquement) ou attendez l'ouverture du marché
jq: command not foundLe script utilise python3 -m json.tool comme solution de secours ; installez jq pour une meilleure sortie

Skills associés