Visão Geral e Filosofia Self-Hosted

O Mestres dos Sinais (Agente 001) é um sistema autônomo de inteligência quantitativa e execução para Binance Futures. Projetado para rodar inteiramente na infraestrutura do usuário (computador pessoal ou VPS privada), ele une análise técnica de fluxo institucional, machine learning e gerenciamento rigoroso de risco.

Tabela Comparativa Arquitetural

O núcleo quantitativo do Agente 001 utiliza uma arquitetura baseada na interface comum de estratégia (agente001/engines/strategy_interface.py). O roteador de sinal avalia continuamente cinco motores isolados e especializados:

Contrato da Interface de Estratégia (Python):

# agente001/engines/strategy_interface.py

class IStrategy(ABC):
    @abstractmethod
    def generate_entry(self, candles: pd.DataFrame, market_ctx: dict) -> Optional[SignalResult]:
        """Avalia velas históricas e fluxo de mercado para gerar sinal de entrada."""
        pass

    @abstractmethod
    def describe_decision(self, signal: SignalResult) -> str:
        """Retorna telemetria legível sobre o racional da tomada de decisão."""
        pass

O módulo de backtesting é um simulador event-driven estritamente causal e isolado da execução live. Ele permite testar estratégias em velas históricas da Binance Futures sem risco financeiro.

Comando para Rodar Auditoria de Backtest CLI:

python -m agente001.backtesting.cli --symbol BTCUSDT --timeframe 15m --strategy TREND --days 90

Suportamos três caminhos de instalação adaptados para Windows, Linux e VPS. Escolha a opção mais adequada ao seu ambiente:

# 1. Clone ou extraia o repositório
cd mestres-dos-sinais-agente-001

# 2. Crie e ative o ambiente virtual
python -m venv venv
venv\Scriptsctivate        # No Windows
source venv/bin/activate     # No Linux/macOS

# 3. Instale as dependências
pip install -r requirements.txt

# 4. Copie a configuração padrão
cp .env.example .env

# 5. Inicie o Agente
python main.py   # Ou dê duplo clique em INICIAR_MESTRES_DOS_SINAIS.vbs

# Sobe a aplicação completa com reinício automático e volume de dados
docker-compose up -d --build

# Acompanhe os logs em tempo real
docker-compose logs -f --tail=100

python installer_gui.py   # Ou execute INSTALAR.bat

A segurança do seu saldo depende da correta restrição de permissões nas chaves de API da Binance.

Modelo de Arquivo `.env`:

# Credenciais da Binance Futures
BINANCE_API_KEY=sua_api_key_aqui
BINANCE_SECRET_KEY=sua_secret_key_aqui
FORCE_PAPER_TRADING=true       # Mantenha true para testar antes de dinheiro real

# Notificações e Comandos Telegram
TELEGRAM_BOT_TOKEN=789101112:AAFg...
TELEGRAM_CHAT_ID=123456789

# Dashboard Web Admin
DASHBOARD_PORT=8199
ADMIN_PASSWORD=sua_senha_segura_aqui

O Agente oferece 4 modos de operação flexíveis e um gerenciador de risco paramétrico que impede entradas sem espectro favorável:

Escada de Trailing Stop em 5 Níveis:

Controle o Agente 001 via mensagens no Telegram/WhatsApp ou através do Dashboard Web interativo: