Communitygithub.com

lacymorrow/openclaw-alpaca-trading-skill

Exécutez des transactions, analysez les marchés et gérez des portefeuilles avec l'outil en ligne de commande apcacli pour l'API Alpaca Trading.

Qu'est-ce que openclaw-alpaca-trading-skill ?

Cette compétence permet aux agents IA (comme Claude Code, Cursor, Codex) d'interagir avec la plateforme de trading Alpaca via l'outil en ligne de commande `apcacli`, écrit en Rust. Elle couvre l'exécution d'ordres (actions, ETF, options, crypto), la gestion de portefeuille, l'accès aux données de marché, et le suivi des activités en temps réel. Particulièrement utile pour les développeurs et traders souhaitant automatiser leurs flux de trading, elle met l'accent sur la sécurité (recommandation du paper trading, ordres limités, stop-loss) et les bonnes pratiques. La compétence guide l'installation de `apcacli` (cross-platform via Cargo), la configuration des variables d'environnement, et fournit des exemples de commandes pour les opérations courantes comme l'achat/vente, la consultation des positions ou l'annulation d'ordres. Elle s'intègre parfaitement dans des workflows automatisés où un agent doit réagir à des déclencheurs textuels comme "acheter", "position", "solde du compte" ou "marché ouvert".

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add lacymorrow/openclaw-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

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

  1. Téléchargez et exécutez rustup-init.exe
  2. 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 :

  1. Sécurité avant tout : Recommandez toujours le paper trading pour les nouveaux utilisateurs ou lors des tests
  2. Vérifiez les commandes : Montrez la commande exacte avant d'exécuter les transactions
  3. Vérifiez les prérequis : Confirmez les heures de marché, le solde du compte et les symboles valides
  4. Expliquez les types d'ordres : Aidez les utilisateurs à choisir le type d'ordre adapté à leurs besoins
  5. 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 :

  1. Inscrivez-vous sur https://alpaca.markets/
  2. Accédez à votre tableau de bord
  3. Générez des clés API (paper ou en direct)
  4. 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

  1. Commencez par le paper trading - Testez toujours les stratégies d'abord avec le paper trading
  2. Utilisez des ordres limités - Évitez les ordres au marché dans des conditions volatiles pour un meilleur contrôle des prix
  3. Vérifiez les symboles - Vérifiez deux fois les symboles ticker avant d'exécuter des transactions
  4. Vérifiez avant d'exécuter - Utilisez apcacli order get pour vérifier les détails de l'ordre
  5. Configurez des stop-loss - Protégez les positions avec des ordres stop
  6. Vérifiez le solde du compte - Assurez-vous d'avoir un pouvoir d'achat suffisant avant de trader
  7. Surveillez les positions - Révisez régulièrement les profits/pertes avec apcacli position list

Utilisation efficace

  1. Vérifiez l'aide pour n'importe quelle commande - Utilisez apcacli <commande> --help pour les options détaillées
  2. Enregistrez les IDs des ordres - Stockez les IDs d'ordres retournés pour suivre et gérer les ordres plus tard
  3. Utilisez les variables d'environnement - Gardez les identifiants en sécurité dans les variables d'environnement, ne les codez jamais en dur
  4. Vérifiez les heures de marché - Utilisez apcacli market clock avant de placer des ordres
  5. 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âcheCommande
Voir le compteapcacli account get
Activité du compteapcacli 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 actionapcacli order submit sell SYMBOL --quantity N
Lister tous les ordresapcacli order list
Obtenir détails d'un ordreapcacli order get ORDER_ID
Annuler un ordreapcacli order cancel ORDER_ID
Annuler tous les ordresapcacli order cancel-all
Lister les positionsapcacli position list
Obtenir une positionapcacli position get SYMBOL
Fermer une positionapcacli position close SYMBOL
Fermer toutes les positionsapcacli position close-all
Lister les actifsapcacli asset list
Obtenir infos sur un actifapcacli asset get SYMBOL
Vérifier statut du marchéapcacli market clock
Stream événements du compteapcacli stream account
Stream transactionsapcacli 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_ID et APCA_API_SECRET_KEY sont 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_URL pour 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

...

Skills associés