# 🚀 GUIA RÁPIDO - COMEÇAR EM 5 MINUTOS

## Passo 1: Instalação de Dependências

```bash
pip install ccxt pandas pytz colorama
```

## Passo 2: Escolher um Perfil

Execute o script de exemplos:

```bash
python exemplos_portofolios.py
```

Escolha um dos perfis (1-6) e salve a configuração.

**Recomendação para iniciantes: Perfil 2 (Moderado) com TESTNET**

## Passo 3: Configurar as Chaves da API

Edite `configuracoes_balanceamento.json`:

```json
{
  "api_key": "COLE_SUA_CHAVE_AQUI",
  "api_secret": "COLE_SEU_SECRET_AQUI",
  "testnet": true,
  ...
}
```

### Como obter as chaves:

1. Vá para: https://www.binance.com/en/account/security
2. Clique em "Create an API Key" (ou "API Management")
3. Configure as permissões:
   - ✓ Enable Reading (GET)
   - ✓ Enable Spot & Margin Trading

4. Copie a Key e Secret

⚠️ **SEGURANÇA:**
- Nunca compartilhe suas chaves
- Revise as permissões (deve ser READ + TRADING apenas)
- Considere usar IP whitelist

## Passo 4: Validar Configuração

```bash
python validar_balanceamento.py
```

Se tudo passar, continue!

## Passo 5: Iniciar o Robô

### Opção A: Interface Gráfica (Recomendado)

```bash
python interface_graficabalanceamento.py
```

Clique em "Iniciar Robô"

### Opção B: Linha de Comando

```bash
python robo_balanceamento.py
```

O robô começará a executar!

---

## ✅ O que esperar

### Primeira Execução (FASE 1 - CONSTRUÇÃO)

O robô tentará comprar todas as moedas configuradas:

```
[10:30:15] ========== FASE DE CONSTRUÇÃO DO PORTFÓLIO ==========
[10:30:16] >>> Comprando HBAR <<<
[10:30:18] ✓ Ordem de COMPRA executada: 2840.91 HBAR
[10:30:20] HBAR: Aguardando preço melhor (Atual: 0.09 > Alvo: 0.0881)
[10:30:22] ADA: Preço bom! Comprando...
...
```

### Quando o Portfólio está Pronto (FASE 2 - BALANCEAMENTO)

```
[10:45:00] ========== FASE DE BALANCEAMENTO DO PORTFÓLIO ==========
[10:45:01] --- Análise de Percentuais ---
[10:45:02] HBAR: 26.50% (Alvo: 25.00%) - Diferença: +1.50%
[10:45:03] ADA: 24.10% (Alvo: 25.00%) - Diferença: -0.90%
[10:45:04] SOL: 27.20% (Alvo: 25.00%) - Diferença: +2.20% ⚠️ VENDER!
[10:45:05] DOGE: 22.20% (Alvo: 25.00%) - Diferença: -2.80% ⚠️ COMPRAR!
```

---

## 📊 Acompanhar o Robô

### Visualizar Log em Tempo Real

```bash
# No Windows
type log_balanceamento.log

# No Mac/Linux
tail -f log_balanceamento.log
```

### Verificar Status do Portfólio

```bash
# Ver o estado atual
cat portfolio_estado.json
```

### Usar a Interface Gráfica

- Aba "Log": vê tudo em tempo real
- Aba "Status": resumo do portfólio
- Aba "Moedas": edita moedas e percentuais

---

## ⚠️ IMPORTANTE

### 1️⃣ Use TESTNET Primeiro

```json
"testnet": true
```

Teste sem dinheiro real! Testnet é para aprender.

### 2️⃣ Comece com Pequeno Capital

```json
"capital_inicial": 100
```

Se der errado, perda mínima.

### 3️⃣ Monitore os Logs

Abra o arquivo `log_balanceamento.log` regularmente.

Se ver erros 🔴, verifique:
- Chaves da API estão corretas?
- Tem saldo suficiente?
- Internet está conectada?

### 4️⃣ Não Deixe Rodando Sem Monitoramento

Especialmente na versão REAL! Acompanhe pelo menos no início.

---

## 🛠️ Troubleshooting

### "Falha ao configurar a exchange"
❌ Problema: Chaves API inválidas
✅ Solução: Verifique as chaves em configuracoes_balanceamento.json

### "Saldo insuficiente para comprar"
❌ Problema: Sem dinheiro suficiente
✅ Solução: Aumente "capital_inicial" ou reduza número de moedas

### "Nenhuma ordem executada"
❌ Problema: Preços estão muito altos
✅ Solução: Aumente os valores em "preco_compra" no portfólio

### "Robô parou"
❌ Problema: Erro não tratado
✅ Solução: Verifique `log_balanceamento.log` para detalhes

---

## 📈 Próximos Passos

### Após validar em TESTNET (2-3 horas):

1. Se satisfeito, mude para REAL:
   ```json
   "testnet": false,
   "capital_inicial": 500  // Comece conservador!
   ```

2. Rode novamente:
   ```bash
   python validar_balanceamento.py
   ```

3. Se passou, inicie:
   ```bash
   python interface_graficabalanceamento.py
   ```

### Otimizações Possíveis:

- Aumentar `capital_inicial` quando ganhar confiança
- Reduzir `variacao_balanceamento` para rebalancear mais
- Adicionar mais moedas a `portfolio`
- Ajustar `tempo_ciclo` (mais rápido = mais trades)

---

## 📞 Dúvidas?

Consulte:
- **ROBO_BALANCEAMENTO_GUIA.md** - Documentação completa
- **log_balanceamento.log** - Histórico de operações
- **portfolio_estado.json** - Estado atual do portfólio

---

## ✨ Boa Sorte!

Lembre-se:
- 🎯 Comece pequeno
- 🧪 Teste em TESTNET
- 📊 Acompanhe os logs
- 🆘 Leia a documentação completa

**O sucesso no trading começa com planejamento e paciência!**

---

*Versão: 1.0*  
*Atualizado: Abril 2026*