Portefeuille SnapTrade
Aperçu
Connectez les comptes de courtage via SnapTrade et générez un rapport de valeur totale quotidienne. Cette compétence utilise le SDK Python officiel SnapTrade (snaptrade_client) avec signature de requête gérée automatiquement.
Flux de travail
2d) Passer des ordres d'achat/vente (actions/ETF)
Exécutez :
python3 scripts/snaptrade_order.py buy|sell TICKER UNITÉS --account-id <ID_COMPTE> [--order-type market|limit] [--limit-price <PRIX>] [--tif Day|GTC|IOC|FOK]
Valeurs par défaut :
- type d'ordre : market
- durée de validité : Day
- prix limite : requis uniquement pour les ordres à cours limité
Surveillance optionnelle (interroger les ordres récents) :
python3 scripts/snaptrade_order.py buy|sell TICKER UNITÉS --account-id <ID_COMPTE> --watch
- interroge toutes les 10s pendant jusqu'à 120s par défaut
- ajustez avec
--watch-intervalet--watch-seconds
Surveiller un ordre existant par ID :
python3 scripts/snaptrade_watch_order.py --account-id <ID_COMPTE> --order-id <ID_ORDRE_COURTIER>
- mêmes valeurs par défaut 10s/120s, ajustables avec
--watch-intervalet--watch-seconds
Utilisez le point de terminaison des ordres du compte pour confirmer les exécutions et signaler les ordres ouverts à l'utilisateur lorsque demandé.
0) Créer un compte SnapTrade + clés API
Vous avez besoin d'un compte SnapTrade pour connecter les courtiers. Créez un compte gratuit sur https://snaptrade.com, générez votre ID client et votre Clé consommateur, puis ajoutez-les à la configuration de la compétence.
1) Installer les dépendances
pip3 install -r requirements.txt
2) Configurer les identifiants (une fois)
Stockez les identifiants dans un fichier de configuration local (non validé). user_id est généré automatiquement lors de la première exécution :
/home/openclaw/.openclaw/workspace/secrets/snaptrade.json
Exemple :
{
"client_id": "VOTRE_ID_CLIENT",
"consumer_key": "VOTRE_CLÉ_CONSOMMATEUR",
"user_id": "<uuid-généré-automatiquement>"
}
2) Enregistrer l'utilisateur + générer le lien du portail de connexion
Exécutez :
python3 scripts/snaptrade_portal.py
Cela va :
- enregistrer l'utilisateur si
user_secretest manquant - stocker
user_secretdans le fichier de configuration - afficher une URL du portail de connexion que l'utilisateur doit ouvrir pour lier les comptes
2b) Reconnecter une connexion désactivée
Exécutez :
python3 scripts/snaptrade_reconnect.py [nom-du-courtier]
Cela va :
- lister les connexions désactivées
- générer un lien de reconnexion (optionnellement correspondre par nom de courtier)
- afficher une URL de reconnexion pour que l'utilisateur réactive la connexion
2c) Lister les courtiers disponibles (connexions autorisées)
Exécutez :
python3 scripts/snaptrade_brokers.py
Cela appelle /snaptrade/partners et renvoie la liste allowed_brokerages (noms affichés).
3) Récupérer la valeur totale du portefeuille
Exécutez :
python3 scripts/snaptrade_total.py
La sortie est un JSON comme :
{"total_value": 123456.78, "currency": "CAD"}
3b) Totaux par courtier (devise convertie)
Exécutez :
python3 scripts/snaptrade_broker_totals.py --currency CAD
Le JSON de sortie inclut les totaux par courtier dans la devise choisie et les taux de change utilisés.
Notes d'implémentation : Évitez get_user_holdings lorsque possible. Préférez get_user_account_positions (point de terminaison des positions) pour les données de détentions/positions. Utilisez uniquement les soldes/espèces des détentions si explicitement demandé par l'utilisateur ; sinon, n'appelez pas les détentions.
4) Planifier le rapport quotidien
Utilisez cron pour appeler snaptrade_total.py, formatez un message WhatsApp concis, puis envoyez-le à l'utilisateur. Seule la valeur totale est requise.
Scripts
scripts/snaptrade_common.py— chargement/sauvegarde de configuration + création de clientscripts/snaptrade_portal.py— enregistrer l'utilisateur + générer le lien du portail de connexionscripts/snaptrade_reconnect.py— générer un lien de reconnexion pour les connexions désactivéesscripts/snaptrade_brokers.py— lister les courtiers autorisés pour ce clientscripts/snaptrade_order.py— passer des ordres d'achat/vente (marché/limite) avec surveillance optionnellescripts/snaptrade_watch_order.py— surveiller un ordre existant par ID pour les exécutionsscripts/snaptrade_total.py— calculer la valeur totale sur tous les comptesscripts/snaptrade_broker_totals.py— totaux par courtier avec conversion de devise
Remarques
- La signature de requête est gérée par le SDK via
request_after_hooken utilisantconsumer_key. - Le total est calculé en additionnant
account.balance.totalde chaque compte à partir des détentions ; cela évite les erreurs lorsque des comptes sont ajoutés ou supprimés. - Si plusieurs devises sont présentes, le script utilise la première devise rencontrée.
- Gardez les secrets dans le fichier de configuration local avec les permissions
chmod 600.