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
| Variable | Objectif |
|---|---|
APCA_API_KEY_ID | Clé API Alpaca |
APCA_API_SECRET_KEY | Secret API Alpaca |
Variables d'environnement facultatives
| Variable | Valeur par défaut | Objectif |
|---|---|---|
APCA_API_BASE_URL | https://paper-api.alpaca.markets | Point de terminaison de trading. Définir sur https://api.alpaca.markets pour le trading en direct |
APCA_DATA_API_BASE_URL | https://data.alpaca.markets | Point 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é
- Par défaut, utiliser le paper trading. Ne jamais définir
APCA_API_BASE_URLsur le trading en direct sans confirmation explicite de l'utilisateur. - Afficher le JSON de l'ordre avant soumission. Laisser l'utilisateur confirmer le symbole, la quantité, le côté et le type.
- 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: truesur les ordres à limite. - Vérifier le pouvoir d'achat via
GET /v2/accountavant les ordres importants. - Ne jamais fournir de conseils financiers. Présentez les données ; laissez l'utilisateur décider.
- Avertir sur les actions irréversibles — fermeture de toutes les positions, annulation de tous les ordres.
Dépannage
| Symptôme | Correctif |
|---|---|
HTTP 401 | Vérifiez que APCA_API_KEY_ID / APCA_API_SECRET_KEY sont définis et valides |
HTTP 403 | Clé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 429 | Limite de débit atteinte — attendez et réessayez ; Alpaca autorise 200 req/min |
| Ordre rejeté en dehors des heures | Ajoutez "extended_hours":true (ordres à limite uniquement) ou attendez l'ouverture du marché |
jq: command not found | Le script utilise python3 -m json.tool comme solution de secours ; installez jq pour une meilleure sortie |