⚙️ Configuração da Aplicação
O novo MagicTradeBot não requer backend de gerenciamento, banco de dados ou instalação complexa. Ele funciona diretamente como uma aplicação leve e auto-hospedada com arquivos de configuração simples em YAML e JSON. Isso o torna extremamente eficiente em termos de recursos e adequado para usuários técnicos e não técnicos.
Em vez de bancos de dados tradicionais, todas as configurações e registros são armazenados em arquivos estruturados. Você pode editá-los diretamente com qualquer editor de texto ou IDE.
📁 Visão Geral dos Arquivos de Configuração
appsettings.yaml— Configuração principal do bot e da exchange.tradesettings.yaml— Lógica de negociação, processamento de sinais e configurações de automação.symbols.json— Gerencia sincronização e rastreamento de símbolos para exchanges.opentrades.yaml— Arquivo do sistema para rastrear posições abertas (não editar).completedorders.yaml— Registra trades concluídos e resumos de PnL.
Você pode executar o bot em modo demo para testes, ajustar estratégias de negociação ou entrar ao vivo com chaves de API reais. Sempre revise sua configuração antes de iniciar negociações ao vivo.
🧠 Configurações Principais do Bot (appsettings.yaml)
# ===========================================================
# Arquivo de Configuração do MagicTradeBot (appsettings.yaml)
# ===========================================================
Exchange:
Name: "binance" # Suportado: binance, okx, bitget, bybit, hype | hyperliquid
APIKEY: "" # Chave API para exchanges centralizadas
APISECRET: "" # Segredo da API ou chave privada (para Hyperliquid use a chave da wallet)
Passphrase: "" # Necessário apenas para algumas exchanges (OKX, Bitget)
# Alternativa de Variável de Ambiente (Recomendado)
# Use BINANCE_API_KEY, OKX_API_KEY etc. para evitar salvar credenciais em arquivos.
# -----------------------------------------------------------
# Configurações de Licença
# -----------------------------------------------------------
License:
Key: "your_license_here" # Insira sua chave de licença válida aqui
# Gerar, estender ou atualizar em: https://magictradebot.com
# -----------------------------------------------------------
# Configurações Gerais da Aplicação
# -----------------------------------------------------------
General:
BotName: "MyBot01"
DemoMode: true # true = modo de simulação
DebugMode: false
Timezone: "UTC"
# -----------------------------------------------------------
# Configuração de Dados de Mercado / Kline
# -----------------------------------------------------------
Kline:
RefreshInterval: 3
maxKlineLength: 30
chunkSize: 20
refreshRate: 7
summaryInterval: "3m"
strategyIntervals:
scalp: ["3m"]
day: ["15m", "30m", "1h", "2h"]
swing: ["1h", "2h", "4h", "6h"]
long: ["1d"]
default: ["5m", "15m", "1h"]
# -----------------------------------------------------------
# Limites de Taxa
# -----------------------------------------------------------
rateLimits:
maxRequestsPerSecond: 10
safeBuffer: 0.2
# -----------------------------------------------------------
# Canais de Broadcast / Notificação
# -----------------------------------------------------------
BroadCast:
whatsapp_token: null
whatsapp_phone_id: null
discord_webhook_url: null
instagram_token: null
telegram_bot_token: null
telegram_chat_id: null
✅ Para detalhes completos de configuração e ajustes avançados (modos de negociação, tratamento de sinais, gerenciamento de capital), visite a seção Configuração.
🤖 Lógica de Negociação & Configuração de Sinais (tradesettings.yaml)
Este arquivo define seus perfis de negociação, regras de sinais, comportamento inteligente de stop-loss/take-profit e estratégias de gerenciamento de capital. Você pode executar modos de scalp, swing ou longo prazo com controle total.
# MAGIC TRADE BOT - CONFIGURAÇÃO DE NEGOCIAÇÃO
# --------------------------------
General:
Profile: "scalp"
BaseCurrency: "USDT"
SyncSymbolsOnStartup: true
InitialTradeAmount: 100.0
Leverage: 5
MaxOpenTrades: 10
MoneyManagementStrategy: 0
SignalSettings:
enable_extreme_volatility: true
supported_volatility_action:
- "BUY"
- "SELL"
- "PUMP"
- "CRASH"
enable_fisher_only_detection: true
pump_multiplier: 0.04
crash_multiplier: 0.025
SLTPSettings:
StopLossPercent: 0.0
TakeProfitPercent: 0.0
EnableTrailingSl: false
EnableBreakeven: false
EnableTrailingTp: false
IntelligentRuleOptions:
IsEnabled: true
UseOriginalTPAsBase: false
CandleExitRules:
IsEnabled: false
IntelligentGlobalSettings:
MinProfitToEnableTP: 0.0
MaxLossBeforeForceClose: -30.0
💡 Cada seção pode ser personalizada ou desativada individualmente. O bot ajusta dinamicamente a lógica de negociação com base nessas configurações. Para explorar todos os campos disponíveis, consulte a documentação detalhada de Configuração de Negociação.
📦 Gerenciamento de Símbolos (symbols.json)
O bot pode sincronizar automaticamente todos os símbolos negociáveis da sua exchange conectada (por exemplo, Binance 500+ pares). Você pode desativar a sincronização ou limitá-la a pares específicos.
{
"syncEnabled": true,
"includeSymbols": ["BTCUSDT", "ETHUSDT"],
"excludeSymbols": ["USDCUSDT"]
}
Você também pode definir configurações por símbolo para alavancagem, cooldowns ou gatilhos para refinar sua estratégia de negociação para mercados específicos.
💾 Arquivos do Sistema
opentrades.yaml— Armazena trades atualmente ativos. Não modifique manualmente.completedorders.yaml— Registra histórico de trades e resultados de PnL para relatórios e acompanhamento de desempenho.
Esses arquivos ajudam o bot a retomar com segurança após reinicializações e manter a consistência entre sessões ao vivo e demo.
🚀 Resumo de Início Rápido
- Baixe o pacote MagicTradeBot.
- Edite
appsettings.yamletradesettings.yaml. - Adicione suas chaves de API da exchange ou configure via variáveis de ambiente.
- Execute o bot — ele carregará automaticamente os símbolos, começará a escanear e gerenciar as negociações.