Habilidade CLI StandX
O StandX CLI é uma ferramenta de linha de comando para negociação de criptomoedas na exchange StandX.
Instalação
Opção 1: ClawHub (Recomendado - Instalação automática)
clawhub install standx-cli
Opção 2: Homebrew
Nota de Segurança: Isso usa um tap de terceiros. Você pode inspecionar a fórmula antes de instalar:
# Ver a fonte da fórmula curl -sL https://raw.githubusercontent.com/wjllance/homebrew-standx-cli/main/standx-cli.rb # Depois instalar brew tap wjllance/standx-cli brew install standx-cli
brew tap wjllance/standx-cli
brew install standx-cli
Início Rápido
Verificar instalação:
standx --version
Ver preço do BTC:
standx market ticker BTC-USD
# Ou usar alias curto
standx m t BTC-USD
Aliases Curtos de Comandos
O StandX CLI suporta aliases curtos para digitação mais rápida:
| Comando Completo | Alias Curto |
|---|---|
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 |
Autenticação
A maioria dos comandos requer autenticação. O StandX CLI suporta múltiplos métodos de autenticação seguros.
Variáveis de Ambiente (Recomendado)
A maneira mais segura de autenticar. As credenciais não são armazenadas no histórico do shell ou logs de comando.
# Adicionar ao ~/.bashrc ou ~/.zshrc
export STANDX_JWT="seu_jwt_token"
export STANDX_PRIVATE_KEY="sua_chave_privada_ed25519"
# Recarregar configuração do shell
source ~/.bashrc
Melhores Práticas de Segurança:
- Nunca hardcode credenciais em comandos (aparece no histórico do shell)
- Nunca commitar credenciais para controle de versão
- Definir permissões de arquivo como 600 para qualquer arquivo contendo credenciais
- Rotacionar tokens regularmente (expirar após 7 dias)
Obter Credenciais
Visite https://standx.com/user/session para gerar:
- Token JWT (obrigatório) - Válido por 7 dias, usado para ler dados da conta
- Chave Privada Ed25519 (opcional, mas recomendado) - Necessário para operações de negociação
Verificar Autenticação
standx auth status
Métodos Alternativos de Autenticação
Login Interativo
Para configuração inicial ou teste:
standx auth login --interactive
Login Baseado em Arquivo
Para scripts de automação onde variáveis de ambiente não estão disponíveis:
# Armazenar credenciais em arquivos com permissões restritas
echo "seu_jwt_token" > ~/.standx_token
echo "sua_chave_privada" > ~/.standx_key
chmod 600 ~/.standx_token ~/.standx_key
# Login usando arquivos
standx auth login --token-file ~/.standx_token --key-file ~/.standx_key
⚠️ Evite isso em produção:
# PERIGO: Credenciais ficarão visíveis no histórico do shell
standx auth login --token "seu_token" --private-key "sua_chave"
Logout
standx auth logout
Dados de Mercado (Sem autenticação necessária)
Listar pares de negociação
standx market symbols
Obter ticker
standx market ticker BTC-USD
standx market ticker ETH-USD
Profundidade do livro de ordens
standx market depth BTC-USD --limit 10
Dados de K-line (velas)
# Últimas 24 horas, velas de 1 hora
standx market kline BTC-USD -r 60 --from 1d
# Últimos 7 dias, velas diárias
standx market kline BTC-USD -r 1D --from 7d
# Intervalo de datas específico
standx market kline BTC-USD -r 60 --from 2024-01-01 --to 2024-01-07
Taxa de funding
standx market funding BTC-USD --days 7
Conta e Negociação (Autenticação necessária)
Informações da conta
standx account balances
standx account positions
standx account orders
standx account history --limit 20
Criar ordem
# Compra limitada
standx order create BTC-USD buy limit --qty 0.01 --price 60000
# Venda a mercado
standx order create BTC-USD sell market --qty 0.01
Cancelar ordem
standx order cancel BTC-USD --order-id 123456
standx order cancel-all BTC-USD
Histórico de negociações
standx trade history BTC-USD --from 7d
Painel e Portfólio (Autenticação necessária)
Painel em Tempo Real
Painel de negociação interativo com atualização automática:
# Iniciar painel com atualização automática (modo watch)
standx dashboard --watch
# Painel para símbolos específicos
standx dashboard --symbols BTC-USD,ETH-USD
# Painel com intervalo de atualização personalizado (segundos)
standx dashboard --watch --interval 5
Funcionalidades do Painel:
- Exibição de saldo da conta em tempo real
- Posições ativas com PnL
- Resumo de ordens abertas
- Visualização da profundidade do livro de ordens
- Painel de negociações recentes (COMPRA/VENDA)
- Atualização automática com saída graciosa (Ctrl+C)
Snapshot do Portfólio
Visualizar resumo e desempenho do portfólio:
# Snapshot do portfólio
standx portfolio snapshot
# Alias curto
standx p s
Alavancagem e Margem (Autenticação necessária)
# Consultar alavancagem
standx leverage get BTC-USD
# Definir alavancagem
standx leverage set BTC-USD 10
# Consultar modo de margem
standx margin mode BTC-USD
# Definir modo de margem
standx margin mode BTC-USD --set isolated
Transmissão em Tempo Real
Streams públicos (Sem autenticação)
# Stream de preços
standx stream price BTC-USD
# Stream do livro de ordens
standx stream depth BTC-USD --levels 5
# Stream de negociações
standx stream trade BTC-USD
Streams de usuário (Autenticação necessária)
standx stream order # Atualizações de ordens
standx stream position # Atualizações de posições
standx stream balance # Atualizações de saldo
standx stream fills # Atualizações de execuções
Formatos de Saída
# Saída JSON
standx -o json market ticker BTC-USD
# Exportação CSV
standx -o csv market symbols > symbols.csv
# Modo silencioso (apenas valores)
standx -o quiet config get base_url
Modos Especiais
Modo OpenClaw (JSON otimizado para IA)
standx --openclaw market ticker BTC-USD
Dry run (pré-visualizar sem executar)
standx --dry-run order create BTC-USD buy limit --qty 0.01 --price 60000