🤖 Apex HFT V8.5 — Bot de Mercado Lateral (BingX Edition)

Bot de High-Frequency Trading (HFT) híbrido (Python + Rust) projetado especificamente para operar em mercados laterais (range bound) na exchange BingX Perpetual Futures.

---

🚀 Arquitetura Híbrida

O projeto utiliza o melhor de duas linguagens para máxima eficiência:

1. Python (Maestro): Responsável pela orquestração, busca de alvos via REST API, monitoramento de risco sistêmico (ASRI), gestão de parâmetros adaptativos e auditoria em CSV.
2. Rust (Core): Motor de execução de alta performance que processa o orderbook e executa as ordens com latência mínima.

A comunicação entre os dois módulos é feita via IPC (Inter-Process Communication) através da porta 9001.

---

🧠 Funcionalidades Principais

• 🎯 Seleção de Alvos Dinâmica: Busca automaticamente os pares com maior volume na BingX (ex: SOL-USDT).
• ⚙️ Parâmetros Adaptativos: Ajusta automaticamente os thresholds de entrada (z_threshold e obi_threshold) com base na performance recente (Win Rate).
• 🛡️ Monitoramento ASRI: Sistema de segurança que trava o bot (asri_halt) se detectar um risco sistêmico baseado no desvio padrão (Z-score > 2.5) do histórico de PnL.
• 📊 Dashboard Integrado: Painel Streamlit (app.py) para visualização de métricas, PnL acumulado, winrate e performance por ativo.

---

📁 Estrutura do Repositório

bot_mercado_lateral/
├── rust_core/              # Motor de execução em Rust
├── python_brain/           # Orquestrador Maestro em Python
│   ├── main_orchestrator.py # Script principal do Maestro
│   ├── dashboard.py        # Dashboard Streamlit
│   └── requirements.txt    # Dependências Python
├── app.py                  # Entrada simplificada para o Dashboard
├── rodar.md                # Guia rápido de execução
└── .gitignore              # Filtro de arquivos desnecessários

---

🛠️ Como Executar

1. Preparar Ambiente Python

cd python_brain
python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt

2. Iniciar o Maestro (Python)

python main_orchestrator.py

3. Iniciar o Motor (Rust)

cd ../rust_core
cargo run

4. Visualizar Dashboard

streamlit run app.py

---

📈 Métricas de Monitoramento

O Maestro exibe estatísticas em tempo real no terminal:

• Win Rate: Percentual de acerto.
• PnL Médio: Lucro/Prejuízo médio por operação.
• Thresholds: Valores atuais de Z-Score e OBI.
• ASRI Status: Monitoramento de saúde do sistema.

---

👨‍💻 Autor

Vinicius da Silva Pontual
@Vinisilva0010

---

📄 Licença

Uso pessoal e de estudo. Veja os códigos fonte para mais detalhes de implementação.