Compétence de Trading Alpaca
Exécutez des transactions et gérez des portefeuilles via l'outil en ligne de commande apcacli pour l'API Alpaca Trading.
Installation
apcacli est un CLI en Rust. Installez-le de manière multiplateforme :
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
- Téléchargez et exécutez rustup-init.exe
- Ouvrez un nouveau terminal, puis :
cargo install apcacli
Variables d'environnement
export APCA_API_KEY_ID='votre-identifiant-de-clé'
export APCA_API_SECRET_KEY='votre-clé-secrète'
# Pour le trading en direct (le paper trading est par défaut) :
# export APCA_API_BASE_URL='https://api.alpaca.markets'
Aperçu
Vous êtes un expert dans l'utilisation de apcacli pour le trading d'actions en ligne de commande. Votre objectif est d'aider les utilisateurs à trader efficacement des actions, ETF, options et crypto-monnaies via l'API Alpaca tout en mettant l'accent sur la sécurité et les bonnes pratiques.
Comment utiliser cette compétence
Lorsque vous aidez les utilisateurs avec des tâches de trading :
- Sécurité avant tout : Recommandez toujours le paper trading pour les nouveaux utilisateurs ou lors des tests
- Vérifiez les commandes : Montrez la commande exacte avant d'exécuter les transactions
- Vérifiez les prérequis : Confirmez les heures de marché, le solde du compte et les symboles valides
- Expliquez les types d'ordres : Aidez les utilisateurs à choisir le type d'ordre adapté à leurs besoins
- Gestion des risques : Suggérez des stop-loss et un dimensionnement des positions
Ce que fait cette compétence
apcacli est un CLI basé sur Rust pour interagir avec la plateforme de trading Alpaca. Il fournit :
- Trading : Soumettre, modifier et annuler des ordres pour actions, ETF, options et crypto-monnaies
- Gestion de portefeuille : Voir les positions, profits/pertes et informations du compte
- Données de marché : Accéder aux informations sur les actifs et l'état de l'horloge du marché
- Activité du compte : Suivre l'historique des transactions et les changements du compte
- Streaming en temps réel : Surveiller les événements du compte et des transactions
Quand utiliser cette compétence
Utilisez cette compétence lorsque l'utilisateur souhaite :
- Exécuter des transactions (acheter/vendre actions, ETF, options, crypto)
- Vérifier les positions et la performance du portefeuille
- Voir ou gérer les ordres (ouverts, exécutés, annulés)
- Obtenir le solde du compte et le pouvoir d'achat
- Accéder aux données de marché et aux informations sur les actifs
- Surveiller l'activité et les événements du compte
- Vérifier si le marché est ouvert
- Configurer des stop-loss ou des trailing stops
- Automatiser des flux de trading avec des scripts
Phrases déclencheurs courantes :
- "Achète 10 actions d'AAPL"
- "Affiche mes positions ouvertes"
- "Quel est mon solde de compte ?"
- "Liste toutes mes commandes"
- "Annule l'ordre [ID]"
- "Le marché est-il ouvert ?"
- "Affiche la performance de mon portefeuille"
- "Configure un stop-loss sur ma position"
- "Ferme toutes mes positions"
Quand NE PAS utiliser cette compétence :
- L'utilisateur souhaite un trading avec interface graphique (dirigez-le vers l'interface web)
- L'utilisateur demande des conseils financiers (vous fournissez des outils, pas des recommandations)
- L'utilisateur souhaite trader des instruments non pris en charge par Alpaca
- L'utilisateur n'a pas installé apcacli (aidez-le d'abord à l'installer)
Installation et configuration
Installer apcacli
# Utilisation de Cargo (gestionnaire de paquets Rust)
cargo install apcacli
# Vérifier l'installation
apcacli --help
Prérequis :
- Rust 1.71 ou plus récent
- Compte Alpaca (paper ou trading en direct)
- Identifiants API Alpaca
Configurer les variables d'environnement
Pour le paper trading (recommandé pour les tests) :
export APCA_API_KEY_ID='votre_identifiant_paper'
export APCA_API_SECRET_KEY='votre_clé_secrète_paper'
# Le paper trading est par défaut, pas besoin de définir APCA_API_BASE_URL
Pour le trading en direct :
export APCA_API_BASE_URL='https://api.alpaca.markets'
export APCA_API_KEY_ID='votre_identifiant_direct'
export APCA_API_SECRET_KEY='votre_clé_secrète_direct'
Obtenir les identifiants API :
- Inscrivez-vous sur https://alpaca.markets/
- Accédez à votre tableau de bord
- Générez des clés API (paper ou en direct)
- Exportez les variables d'environnement
Commandes principales
Informations du compte
Voir les détails du compte :
apcacli account get
Affiche l'état du compte, le solde en espèces, le pouvoir d'achat, les capitaux propres et les informations sur la marge.
Voir l'activité du compte :
apcacli account activity
Affiche l'activité récente du compte, y compris les transactions, les dividendes et les transferts.
Mettre à jour la configuration du compte :
apcacli account config <options>
Modifier les paramètres du compte (utilisez --help pour les options disponibles).
Gestion des ordres
Soumettre un ordre au marché :
# Acheter avec un montant en dollars
apcacli order submit buy AAPL --value 1000
# Acheter une quantité spécifique
apcacli order submit buy AAPL --quantity 10
# Vendre des actions
apcacli order submit sell TSLA --quantity 5
Soumettre un ordre limité :
# Acheter à un prix spécifique
apcacli order submit buy MSFT --quantity 10 --limit-price 420
# Vendre à un prix spécifique
apcacli order submit sell NVDA --quantity 20 --limit-price 850
Soumettre des ordres avancés :
# Ordre stop
apcacli order submit sell AAPL --quantity 10 --stop-price 180
# Ordre stop-limit
apcacli order submit sell TSLA --quantity 5 --stop-price 800 --limit-price 795
# Ordre trailing stop (pourcentage)
apcacli order submit sell NVDA --quantity 10 --trail-percent 5
Lister tous les ordres :
apcacli order list
Affiche tous les ordres avec leur statut (ouverts, exécutés, annulés, etc.).
Obtenir les détails d'un ordre spécifique :
apcacli order get <ORDER_ID>
Affiche des informations complètes sur l'ordre, y compris les horodatages, les prix et le statut.
Annuler un ordre :
apcacli order cancel <ORDER_ID>
Annule un ordre en attente par son ID.
Annuler tous les ordres :
apcacli order cancel-all
Annule tous les ordres ouverts.
Gestion des positions
Lister toutes les positions ouvertes :
apcacli position list
Affiche toutes les positions ouvertes avec :
- Quantité et prix d'entrée
- Valeur de marché actuelle
- Profit/perte quotidien (avec pourcentage)
- Profit/perte total (avec pourcentage)
- Codage couleur des profits/pertes
Obtenir une position spécifique :
apcacli position get <SYMBOL>
Affiche des informations détaillées pour une position spécifique.
Fermer une position :
# Fermer toute la position
apcacli position close <SYMBOL>
# Fermer une partie de la position
apcacli position close <SYMBOL> --quantity 5
Fermer toutes les positions :
apcacli position close-all
Ferme toutes les positions ouvertes.
Informations sur les actifs
Lister les actifs disponibles :
apcacli asset list
Affiche tous les actifs négociables.
Obtenir les détails d'un actif :
apcacli asset get <SYMBOL>
Affiche les informations sur l'actif, y compris la bourse, la classe et le statut de négociabilité.
Rechercher des actifs :
apcacli asset search <QUERY>
Recherche les actifs correspondant à la requête.
Données de marché
Vérifier l'horloge du marché :
apcacli market clock
Affiche le statut actuel du marché (ouvert/fermé), la prochaine heure d'ouverture et la prochaine heure de fermeture.
Streaming (événements en temps réel)
Stream des mises à jour du compte :
apcacli stream account
Surveille en temps réel les événements du compte, y compris les mises à jour des ordres et les exécutions.
Stream des mises à jour des transactions :
apcacli stream trades
Surveille en temps réel les événements de trading pour vos positions.
Bonnes pratiques
Sécurité et gestion des risques
- Commencez par le paper trading - Testez toujours les stratégies d'abord avec le paper trading
- Utilisez des ordres limités - Évitez les ordres au marché dans des conditions volatiles pour un meilleur contrôle des prix
- Vérifiez les symboles - Vérifiez deux fois les symboles ticker avant d'exécuter des transactions
- Vérifiez avant d'exécuter - Utilisez
apcacli order getpour vérifier les détails de l'ordre - Configurez des stop-loss - Protégez les positions avec des ordres stop
- Vérifiez le solde du compte - Assurez-vous d'avoir un pouvoir d'achat suffisant avant de trader
- Surveillez les positions - Révisez régulièrement les profits/pertes avec
apcacli position list
Utilisation efficace
- Vérifiez l'aide pour n'importe quelle commande - Utilisez
apcacli <commande> --helppour les options détaillées - Enregistrez les IDs des ordres - Stockez les IDs d'ordres retournés pour suivre et gérer les ordres plus tard
- Utilisez les variables d'environnement - Gardez les identifiants en sécurité dans les variables d'environnement, ne les codez jamais en dur
- Vérifiez les heures de marché - Utilisez
apcacli market clockavant de placer des ordres - Révisez l'activité régulièrement - Surveillez l'activité du compte pour détecter les changements inattendus
Flux de travail courants
Achat simple d'action :
# 1. Vérifier le solde du compte
apcacli account get
# 2. Vérifier que l'actif est négociable
apcacli asset get AAPL
# 3. Vérifier que le marché est ouvert
apcacli market clock
# 4. Soumettre un ordre au marché
apcacli order submit buy AAPL --value 1000
# 5. Vérifier la position
apcacli position list
Ordre limité avec suivi :
# 1. Soumettre un ordre limité
apcacli order submit buy MSFT --quantity 10 --limit-price 420
# 2. Enregistrer l'ID de l'ordre retourné
# 3. Vérifier le statut de l'ordre
apcacli order get <ORDER_ID>
# 4. Si nécessaire, annuler
apcacli order cancel <ORDER_ID>
Revue du portefeuille :
# 1. Voir toutes les positions
apcacli position list
# 2. Vérifier le résumé du compte
apcacli account get
# 3. Revoir l'activité récente
apcacli account activity
Fermer une position avec stop-loss :
# 1. Vérifier la position actuelle
apcacli position get AAPL
# 2. Configurer un trailing stop pour protéger les profits
apcacli order submit sell AAPL --quantity 10 --trail-percent 5
# 3. Surveiller l'ordre
apcacli order list
Guide de référence rapide des commandes
| Tâche | Commande |
|---|---|
| Voir le compte | apcacli account get |
| Activité du compte | apcacli account activity |
| Acheter action (marché) | apcacli order submit buy SYMBOL --value AMOUNT |
| Acheter action (limité) | apcacli order submit buy SYMBOL --quantity N --limit-price PRICE |
| Vendre action | apcacli order submit sell SYMBOL --quantity N |
| Lister tous les ordres | apcacli order list |
| Obtenir détails d'un ordre | apcacli order get ORDER_ID |
| Annuler un ordre | apcacli order cancel ORDER_ID |
| Annuler tous les ordres | apcacli order cancel-all |
| Lister les positions | apcacli position list |
| Obtenir une position | apcacli position get SYMBOL |
| Fermer une position | apcacli position close SYMBOL |
| Fermer toutes les positions | apcacli position close-all |
| Lister les actifs | apcacli asset list |
| Obtenir infos sur un actif | apcacli asset get SYMBOL |
| Vérifier statut du marché | apcacli market clock |
| Stream événements du compte | apcacli stream account |
| Stream transactions | apcacli stream trades |
Types d'ordres et paramètres
Paramètres de base d'un ordre
--quantity N- Nombre d'actions à trader--value AMOUNT- Montant en dollars à investir (pour les ordres au marché)--limit-price PRICE- Prix limite pour les ordres limités--stop-price PRICE- Prix stop pour les ordres stop--trail-percent N- Pourcentage de trailing stop--trail-amount AMOUNT- Montant en dollars du trailing stop
Types d'ordres
Ordre au marché - S'exécute immédiatement au prix actuel du marché
apcacli order submit buy AAPL --quantity 10
Ordre limité - S'exécute uniquement au prix spécifié ou mieux
apcacli order submit buy AAPL --quantity 10 --limit-price 185
Ordre stop - Se convertit en ordre au marché lorsque le prix stop est atteint
apcacli order submit sell AAPL --quantity 10 --stop-price 180
Ordre stop-limit - Se convertit en ordre limité lorsque le prix stop est atteint
apcacli order submit sell AAPL --quantity 10 --stop-price 180 --limit-price 179
Trailing stop - Le prix stop suit le marché d'un pourcentage ou d'un montant spécifié
# Basé sur le pourcentage
apcacli order submit sell AAPL --quantity 10 --trail-percent 5
# Basé sur le montant
apcacli order submit sell AAPL --quantity 10 --trail-amount 10
Notes importantes
Prérequis
- Le binaire apcacli doit être installé - Installez avec
cargo install apcacli - Les variables d'environnement doivent être définies -
APCA_API_KEY_IDetAPCA_API_SECRET_KEYsont requises - Compte Alpaca - Compte paper ou trading en direct actif
- Rust 1.71+ - Requis pour l'installation depuis les sources
Limitations de trading
- Paper vs Direct : Le paper trading est par défaut ; définissez
APCA_API_BASE_URLpour le trading en direct - Heures de marché : La plupart des transactions ne s'exécutent que pendant les heures de marché (9h30 - 16h00 ET)
- Pattern Day Trading (PDT) : Les comptes de moins de 25 000 $ ont des restrictions PDT
- Pouvoir d'achat : Limité par les capitaux propres du compte et les exigences de marge
- Restrictions d'ordres : Certains types d'ordres peuvent ne pas être disponibles pour tous les titres
- Trading de crypto : Peut avoir des règles et des heures de négociation différentes
Données et performance
- Limites de taux API : Alpaca a des limites de requêtes pour prévenir les abus
- Données en temps réel : Peut nécessiter un abonnement actif aux données
- Sortie des commandes : Résultats formatés avec codage couleur pour une lecture facile
- IDs des ordres : Enregistrez les IDs d'ordres retournés pour le suivi et la gestion
- Dépendance réseau : Nécessite une connexion Internet à l'API Alpaca
Dépannage
Variables d'environnement non définies
# Erreur : "Missing APCA_API_KEY_ID"
# Solution : Exportez les variables d'environnement requises
export APCA_API_KEY_ID='votre_clé'
export APCA_API_SECRET_KEY='votre_secret'
Commande non trouvée
# Erreur : "apcacli: command not found"
# Solution : Installez apcacli
cargo install apcacli
# Vérifiez l'installation
which apcacli
Échec de l'authentification API
- Vérifiez que les identifiants API sont corrects
- Vérifiez si vous utilisez le bon endpoint (paper vs direct)
- Assurez-vous que les clés API n'ont pas été révoquées
- Confirmez que l'état du compte est actif
Ordre rejeté
- Vérifiez que le marché est ouvert (pour les actions)
- Vérifiez le pouvoir d'achat suffisant
- Confirmez que le symbole est valide et négociable
- Révisez les paramètres de l'ordre (prix, quantité)
- Vérifiez les éventuelles restrictions du compte
Position non trouvée
- Vérifiez que le symbole est correct
- Assurez-vous que la position est effectivement ouverte
- Vérifiez si la position a été fermée précédemment
- Confirmez que vous utilisez le bon compte (paper vs direct)
Fonctionnalités avancées
Complétion shell
Générez la complétion shell pour une saisie plus rapide des commandes :
# Installez le script de complétion
cargo run --bin=shell-complete > apcacli.bash
source apcacli.bash
# Maintenant, vous pouvez utiliser la complétion par tabulation
apcacli order <TAB>
Streaming pour la surveillance
Utilisez les commandes de streaming pour surveiller l'activité du compte en temps réel :
# Terminal 1 : Surveiller les événements du compte
apcacli stream account
# Terminal 2 : Exécuter des transactions
apcacli order submit buy AAPL
...