Communitygithub.com

wjllance/StandX-CLI

Interface en ligne de commande pour le trading de crypto-monnaies sur l'échange StandX. Permet de consulter les données de marché, gérer les ordres, vérifier les soldes et positions, diffuser des données en temps réel via WebSocket, et afficher un tableau de bord.

Qu'est-ce que StandX-CLI ?

StandX CLI est un outil en ligne de commande (CLI) conçu pour interagir avec l'échange de crypto-monnaies StandX. Il permet aux développeurs et traders automatisés d'interroger les données de marché (cours, carnets d'ordres, chandeliers, taux de financement), de gérer les ordres (création, annulation, consultation), de vérifier les soldes et positions de compte, et de diffuser des données en temps réel via WebSocket. L'outil prend en charge l'authentification sécurisée via JWT et clé privée Ed25519, avec plusieurs méthodes (variables d'environnement, fichiers, interactif). Il offre également un tableau de bord interactif en temps réel avec actualisation automatique, un résumé de portefeuille, et des alias de commandes courts pour une utilisation rapide. Il supporte les paires de trading majeures comme BTC, ETH, SOL, XRP, et propose des formats de sortie JSON, CSV et mode silencieux, ainsi qu'un mode IA optimisé (OpenClaw) et un mode simulation (dry-run). La CLI est disponible via ClawHub (recommandé) ou Homebrew, et son code source est ouvert sur GitHub.

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/wjllance/StandX-CLI/tree/HEAD/openclaw

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 StandX CLI

StandX CLI est un outil en ligne de commande pour le trading de crypto-monnaies sur l'échange StandX.

Installation

Option 1 : ClawHub (Recommandé - Installation automatique)

clawhub install standx-cli

Option 2 : Homebrew

Note de sécurité : Cela utilise un dépôt tiers. Vous pouvez inspecter la formule avant de l'installer :

# Voir le source de la formule
curl -sL https://raw.githubusercontent.com/wjllance/homebrew-standx-cli/main/standx-cli.rb

# Puis installer
brew tap wjllance/standx-cli
brew install standx-cli
brew tap wjllance/standx-cli
brew install standx-cli

Démarrage rapide

Vérifier l'installation :

standx --version

Voir le prix du BTC :

standx market ticker BTC-USD
# Ou utiliser l'alias court
standx m t BTC-USD

Alias de commandes courts

StandX CLI prend en charge des alias courts pour une frappe plus rapide :

Commande complèteAlias court
standx market tickerstandx m t
standx market depthstandx m d
standx market klinestandx m k
standx account balancesstandx a b
standx account positionsstandx a p
standx account ordersstandx a o
standx portfolio snapshotstandx p s
standx dashboard --watchstandx d -w

Authentification

La plupart des commandes nécessitent une authentification. StandX CLI prend en charge plusieurs méthodes d'authentification sécurisées.

Variables d'environnement (Recommandé)

La méthode d'authentification la plus sécurisée. Les identifiants ne sont pas stockés dans l'historique du shell ni dans les journaux de commandes.

# Ajouter à ~/.bashrc ou ~/.zshrc
export STANDX_JWT="votre_jeton_jwt"
export STANDX_PRIVATE_KEY="votre_cle_privee_ed25519"

# Recharger la configuration du shell
source ~/.bashrc

Bonnes pratiques de sécurité :

  • Ne jamais coder en dur les identifiants dans les commandes (apparaît dans l'historique du shell)
  • Ne jamais commettre les identifiants dans le contrôle de version
  • Définir les permissions de fichier à 600 pour tout fichier contenant des identifiants
  • Renouveler les jetons régulièrement (ils expirent après 7 jours)

Obtenir les identifiants

Visitez https://standx.com/user/session pour générer :

  • Jeton JWT (obligatoire) - Valide 7 jours, utilisé pour lire les données du compte
  • Clé privée Ed25519 (optionnelle mais recommandée) - Requise pour les opérations de trading

Vérifier l'authentification

standx auth status

Méthodes d'authentification alternatives

Connexion interactive

Pour une première configuration ou des tests :

standx auth login --interactive

Connexion par fichier

Pour les scripts d'automatisation lorsque les variables d'environnement ne sont pas disponibles :

# Stocker les identifiants dans des fichiers avec des permissions restreintes
echo "votre_jeton_jwt" > ~/.standx_token
echo "votre_cle_privee" > ~/.standx_key
chmod 600 ~/.standx_token ~/.standx_key

# Se connecter en utilisant les fichiers
standx auth login --token-file ~/.standx_token --key-file ~/.standx_key

⚠️ Évitez ceci en production :

# DANGER : Les identifiants seront visibles dans l'historique du shell
standx auth login --token "votre_jeton" --private-key "votre_cle"

Déconnexion

standx auth logout

Données de marché (Authentification non requise)

Liste des paires de trading

standx market symbols

Obtenir le cours

standx market ticker BTC-USD
standx market ticker ETH-USD

Profondeur du carnet d'ordres

standx market depth BTC-USD --limit 10

Données de chandeliers (K-line)

# Dernières 24 heures, bougies de 1 heure
standx market kline BTC-USD -r 60 --from 1d

# Derniers 7 jours, bougies quotidiennes
standx market kline BTC-USD -r 1D --from 7d

# Plage de dates spécifique
standx market kline BTC-USD -r 60 --from 2024-01-01 --to 2024-01-07

Taux de financement

standx market funding BTC-USD --days 7

Compte et trading (Authentification requise)

Informations du compte

standx account balances
standx account positions
standx account orders
standx account history --limit 20

Créer un ordre

# Achat limité
standx order create BTC-USD buy limit --qty 0.01 --price 60000

# Vente au marché
standx order create BTC-USD sell market --qty 0.01

Annuler un ordre

standx order cancel BTC-USD --order-id 123456
standx order cancel-all BTC-USD

Historique des transactions

standx trade history BTC-USD --from 7d

Tableau de bord et portefeuille (Authentification requise)

Tableau de bord en temps réel

Tableau de bord de trading interactif avec actualisation automatique :

# Lancer le tableau de bord avec actualisation automatique (mode surveillance)
standx dashboard --watch

# Tableau de bord pour des symboles spécifiques
standx dashboard --symbols BTC-USD,ETH-USD

# Tableau de bord avec intervalle d'actualisation personnalisé (secondes)
standx dashboard --watch --interval 5

Fonctionnalités du tableau de bord :

  • Affichage en temps réel du solde du compte
  • Positions actives avec PnL
  • Résumé des ordres ouverts
  • Visualisation de la profondeur du carnet d'ordres
  • Panneau des transactions récentes (ACHAT/VENTE)
  • Actualisation automatique avec sortie gracieuse (Ctrl+C)

Instantané du portefeuille

Voir le résumé et la performance du portefeuille :

# Instantané du portefeuille
standx portfolio snapshot

# Alias court
standx p s

Effet de levier et marge (Authentification requise)

# Interroger l'effet de levier
standx leverage get BTC-USD

# Définir l'effet de levier
standx leverage set BTC-USD 10

# Interroger le mode de marge
standx margin mode BTC-USD

# Définir le mode de marge
standx margin mode BTC-USD --set isolated

Diffusion en temps réel

Flux publics (Authentification non requise)

# Flux de prix
standx stream price BTC-USD

# Flux du carnet d'ordres
standx stream depth BTC-USD --levels 5

# Flux de transactions
standx stream trade BTC-USD

Flux utilisateur (Authentification requise)

standx stream order     # Mises à jour des ordres
standx stream position  # Mises à jour des positions
standx stream balance   # Mises à jour du solde
standx stream fills     # Mises à jour des exécutions

Formats de sortie

# Sortie JSON
standx -o json market ticker BTC-USD

# Export CSV
standx -o csv market symbols > symbols.csv

# Mode silencieux (juste les valeurs)
standx -o quiet config get base_url

Modes spéciaux

Mode OpenClaw (JSON optimisé pour IA)

standx --openclaw market ticker BTC-USD

Simulation (prévisualisation sans exécution)

standx --dry-run order create BTC-USD buy limit --qty 0.01 --price 60000

Références

Liens

Skills associés