Habilidad de StandX CLI
StandX CLI es una herramienta de línea de comandos para trading de criptomonedas en el exchange StandX.
Instalación
Opción 1: ClawHub (Recomendado - Instalación automática)
clawhub install standx-cli
Opción 2: Homebrew
Nota de seguridad: Esto utiliza un tap de terceros. Puedes inspeccionar la fórmula antes de instalar:
# Ver el código fuente de la fórmula curl -sL https://raw.githubusercontent.com/wjllance/homebrew-standx-cli/main/standx-cli.rb # Luego instalar brew tap wjllance/standx-cli brew install standx-cli
brew tap wjllance/standx-cli
brew install standx-cli
Inicio rápido
Verificar instalación:
standx --version
Ver precio de BTC:
standx market ticker BTC-USD
# O usar alias corto
standx m t BTC-USD
Alias cortos de comandos
StandX CLI admite alias cortos para escribir más rápido:
| Comando completo | Alias corto |
|---|---|
standx market ticker | standx m t |
standx market depth | standx m d |
standx market kline | standx m k |
standx account balances | standx a b |
standx account positions | standx a p |
standx account orders | standx a o |
standx portfolio snapshot | standx p s |
standx dashboard --watch | standx d -w |
Autenticación
La mayoría de los comandos requieren autenticación. StandX CLI admite múltiples métodos de autenticación seguros.
Variables de entorno (Recomendado)
La forma más segura de autenticarse. Las credenciales no se almacenan en el historial del shell ni en los registros de comandos.
# Agregar a ~/.bashrc o ~/.zshrc
export STANDX_JWT="tu_token_jwt"
export STANDX_PRIVATE_KEY="tu_clave_privada_ed25519"
# Recargar configuración del shell
source ~/.bashrc
Mejores prácticas de seguridad:
- Nunca codificar credenciales en comandos (aparece en el historial del shell)
- Nunca enviar credenciales a control de versiones
- Establecer permisos de archivo en 600 para cualquier archivo que contenga credenciales
- Rotar los tokens regularmente (expiran después de 7 días)
Obtener credenciales
Visita https://standx.com/user/session para generar:
- Token JWT (requerido) - Válido por 7 días, se usa para leer datos de la cuenta
- Clave privada Ed25519 (opcional pero recomendada) - Necesaria para operaciones de trading
Verificar autenticación
standx auth status
Métodos de autenticación alternativos
Inicio de sesión interactivo
Para configuración inicial o pruebas:
standx auth login --interactive
Inicio de sesión basado en archivos
Para scripts de automatización donde las variables de entorno no están disponibles:
# Almacenar credenciales en archivos con permisos restringidos
echo "tu_token_jwt" > ~/.standx_token
echo "tu_clave_privada" > ~/.standx_key
chmod 600 ~/.standx_token ~/.standx_key
# Iniciar sesión usando archivos
standx auth login --token-file ~/.standx_token --key-file ~/.standx_key
⚠️ Evitar esto en producción:
# PELIGRO: Las credenciales serán visibles en el historial del shell
standx auth login --token "tu_token" --private-key "tu_clave"
Cerrar sesión
standx auth logout
Datos de mercado (Sin autenticación)
Listar pares de trading
standx market symbols
Obtener ticker
standx market ticker BTC-USD
standx market ticker ETH-USD
Profundidad del libro de órdenes
standx market depth BTC-USD --limit 10
Datos de velas (K-line)
# Últimas 24 horas, velas de 1 hora
standx market kline BTC-USD -r 60 --from 1d
# Últimos 7 días, velas diarias
standx market kline BTC-USD -r 1D --from 7d
# Rango de fechas específico
standx market kline BTC-USD -r 60 --from 2024-01-01 --to 2024-01-07
Tasa de financiamiento
standx market funding BTC-USD --days 7
Cuenta y Trading (Autenticación requerida)
Información de la cuenta
standx account balances
standx account positions
standx account orders
standx account history --limit 20
Crear orden
# Compra limitada
standx order create BTC-USD buy limit --qty 0.01 --price 60000
# Venta de mercado
standx order create BTC-USD sell market --qty 0.01
Cancelar orden
standx order cancel BTC-USD --order-id 123456
standx order cancel-all BTC-USD
Historial de trades
standx trade history BTC-USD --from 7d
Tablero y Portafolio (Autenticación requerida)
Tablero en tiempo real
Tablero de trading interactivo con actualización automática:
# Iniciar tablero con actualización automática (modo watch)
standx dashboard --watch
# Tablero para símbolos específicos
standx dashboard --symbols BTC-USD,ETH-USD
# Tablero con intervalo de actualización personalizado (segundos)
standx dashboard --watch --interval 5
Características del tablero:
- Visualización de saldo de cuenta en tiempo real
- Posiciones activas con PnL
- Resumen de órdenes abiertas
- Visualización de profundidad del libro de órdenes
- Panel de trades recientes (COMPRA/VENTA)
- Actualización automática con salida controlada (Ctrl+C)
Resumen del portafolio
Ver resumen y rendimiento del portafolio:
# Resumen del portafolio
standx portfolio snapshot
# Alias corto
standx p s
Apalancamiento y Margen (Autenticación requerida)
# Consultar apalancamiento
standx leverage get BTC-USD
# Establecer apalancamiento
standx leverage set BTC-USD 10
# Consultar modo de margen
standx margin mode BTC-USD
# Establecer modo de margen
standx margin mode BTC-USD --set isolated
Transmisión en tiempo real
Streams públicos (Sin autenticación)
# Stream de precios
standx stream price BTC-USD
# Stream de profundidad del libro
standx stream depth BTC-USD --levels 5
# Stream de trades
standx stream trade BTC-USD
Streams de usuario (Autenticación requerida)
standx stream order # Actualizaciones de órdenes
standx stream position # Actualizaciones de posiciones
standx stream balance # Actualizaciones de saldo
standx stream fills # Actualizaciones de ejecuciones
Formatos de salida
# Salida JSON
standx -o json market ticker BTC-USD
# Exportación CSV
standx -o csv market symbols > symbols.csv
# Modo silencioso (solo valores)
standx -o quiet config get base_url
Modos especiales
Modo OpenClaw (JSON optimizado para IA)
standx --openclaw market ticker BTC-USD
Ejecución en seco (vista previa sin ejecutar)
standx --dry-run order create BTC-USD buy limit --qty 0.01 --price 60000