Sistema de Entrada Manual de Operações – Guia do Usuário

Visão Geral

O sistema de Entrada Manual de Trades permite que você insira manualmente oportunidades de trade que o bot irá monitorar e executar automaticamente, sem precisar esperar pela geração normal de sinais. É perfeito para quando você identifica oportunidades durante uma análise manual do mercado e não quer que o bot as perca.

Como Funciona

🔄 Recarregamento Automático em Tempo Real (Hot-Reload)

  • Adicione entradas no arquivo settings/manual_trade_symbols.yaml enquanto o bot está rodando
  • As alterações são detectadas automaticamente em até 30 segundos (próximo ciclo de processamento)
  • Sem necessidade de reiniciar!

🎯 Fluxo de Execução de Trades

  1. Você adiciona uma entrada de trade no arquivo YAML
  2. O bot detecta a nova entrada no próximo ciclo (≤ 30 segundos)
  3. O bot valida:
    • O símbolo existe na lista de trading do bot
    • Não existem ordens em andamento para esse símbolo
    • Condições de preço atendidas (se houver threshold configurado)
  4. O bot executa o trade automaticamente
  5. A entrada é removida do arquivo YAML após execução bem-sucedida (evita duplicatas)

Localização do Arquivo de Configuração

settings/manual_trade_symbols.yaml

Referência dos Campos

Symbol (Obrigatório)

  • Par de trading no formato específico da exchange
  • Exemplos: BTCUSDT, ETHUSDT, 1000PEPEUSDT
  • Deve corresponder exatamente ao que aparece na lista de símbolos do seu bot

Price (Obrigatório)

  • 0 = O bot busca e usa o preço de mercado atual (recomendado)
  • > 0 = Usa este preço específico como referência de entrada
  • Quando definido como 0, o bot irá:
    • Buscar o preço de mercado atual
    • Atualizar este campo no YAML com o preço obtido
    • Usar este preço para cálculos de threshold nos ciclos seguintes

Direction (Obrigatório)

  • Long = Posição comprada / longa
  • Short = Posição vendida / curta

Amount (Obrigatório)

  • 0 = Usa o dimensionamento de posição padrão do bot
  • > 0 = Sobrescreve com um valor específico (na moeda de cotação)
  • Exemplos:
    • 1000.0 = Tamanho de posição de $1000
    • 2500.5 = Tamanho de posição de $2500,50

ExecuteThresholdPerfect (Obrigatório)

  • 0 = Executa imediatamente (sem necessidade de movimento de preço)
  • > 0 = Aguarda o preço se mover essa porcentagem antes de executar
  • Para posições LONG: Aguarda o preço CAIR essa %
  • Para posições SHORT: Aguarda o preço SUBIR essa %

Timestamp (Opcional)

  • Use null ou simplesmente omita o campo
  • O bot define automaticamente esse valor ao processar a entrada
  • Pode ser usado futuramente para validação de expiração

Exemplos de Uso

Exemplo 1: Entrada Imediata (Aproveite uma oportunidade AGORA)

Trades:
 - Symbol: 'BTCUSDT'
 Price: 0 # Usa o preço atual
 Direction: Long # Vai long
 Amount: 0 # Usa tamanho padrão
 ExecuteThresholdPerfect: 0 # Executa imediatamente
 Timestamp: null

Caso de uso: Você vê o BTC rompendo para cima e quer entrar agora.

Exemplo 2: Comprar no Dip (Estratégia de pullback de 5%)

Trades:
 - Symbol: 'ETHUSDT'
 Price: 0 # O bot vai buscar o preço atual (ex: $3000)
 Direction: Long
 Amount: 1000 # Posição de $1000
 ExecuteThresholdPerfect: 5 # Aguarda queda de 5% (executa em ~$2850)
 Timestamp: null

Caso de uso: ETH parece forte, mas um pouco esticado. Você quer comprar se houver um recuo de 5%.

Exemplo 3: Compra Agressiva no Dip (Retracement de 10%)

Trades:
 - Symbol: '1000PEPEUSDT'
 Price: 0
 Direction: Long
 Amount: 2000 # Posição de $2000
 ExecuteThresholdPerfect: 10 # Aguarda queda de 10%
 Timestamp: null

Caso de uso: PEPE está subindo forte. Você quer acumular se houver um recuo significativo.

Exemplo 4: Shortar o Pump (Aguardar alta de 3%)

Trades:
 - Symbol: 'SOLUSDT'
 Price: 0 # O bot busca o preço atual (ex: $100)
 Direction: Short # Posição short
 Amount: 1500
 ExecuteThresholdPerfect: 3 # Executa quando subir 3% (para ~$103)
 Timestamp: null

Caso de uso: SOL parece esticado. Você quer entrar short se subir mais 3%.

Exemplo 5: Entradas Múltiplas em Diferentes Níveis

Trades:
  # Entrada imediata
 - Symbol: 'BTCUSDT'
 Price: 0
 Direction: Long
 Amount: 500
 ExecuteThresholdPerfect: 0 # Entra agora
 Timestamp: null
  # Adicionar mais em queda de 5%
 - Symbol: 'BTCUSDT'
 Price: 0
 Direction: Long
 Amount: 1000
 ExecuteThresholdPerfect: 5 # Adiciona na posição em queda de 5%
 Timestamp: null
  # Adicionar ainda mais em queda de 10%
 - Symbol: 'BTCUSDT'
 Price: 0
 Direction: Long
 Amount: 1500
 ExecuteThresholdPerfect: 10 # Acumulação pesada em queda de 10%
 Timestamp: null

Caso de uso: Dollar-cost averaging (DCA) no BTC em vários níveis de preço.

Notas Importantes

✅ O QUE FAZER

  • ✅ Manter o arquivo YAML válido (indentação correta, sem erros de sintaxe)
  • ✅ Usar null no Timestamp (não usar None)
  • ✅ Usar Long ou Short no Direction (não 0 ou 1)
  • ✅ Verificar que os nomes dos símbolos correspondem exatamente ao formato da exchange
  • ✅ Aguardar pelo menos 30 segundos após adicionar para o bot detectar

❌ O QUE NÃO FAZER

  • ❌ Não usar None no Timestamp (use null ou omita)
  • ❌ Não usar 0 ou 1 no Direction (use Long ou Short)
  • ❌ Não adicionar entradas para símbolos que o bot não está monitorando
  • ❌ Não editar o arquivo enquanto o bot está salvando (raro risco de race condition)

🔒 Recursos de Segurança

  • Sem execuções duplicadas: Entradas são removidas após execução
  • Sem conflitos: Não executa se o símbolo já tiver ordens em andamento
  • Validação de preço: Busca e atualiza preços automaticamente quando definido como 0
  • Rastreamento de timestamp: O bot registra quando cada entrada foi criada

📊 Monitoramento

Verifique os logs para acompanhar quando as entradas são processadas:

  • logs/orders.YYYY-MM-DD.log – Todas as execuções de trades (formato JSON)
  • logs/trade_summary.YYYY-MM-DD.log – Resumos de alto nível
  • logs/debug.YYYY-MM-DD.log – Processamento detalhado (se modo debug ativado)

Exemplo de Fluxo de Trabalho

Passo 1: Você está analisando os gráficos e vê ETHUSDT rompendo uma resistência

# Adicionar no manual_trade_symbols.yaml
Trades:
 - Symbol: 'ETHUSDT'
 Price: 0
 Direction: Long
 Amount: 1000
 ExecuteThresholdPerfect: 0
 Timestamp: null

Passo 2: Salve o arquivo (o bot continua rodando)

Passo 3: Em até 30 segundos, o bot irá:

  • Carregar o arquivo
  • Buscar o preço atual de ETH (ex: $3000)
  • Atualizar o campo Price para 3000 no YAML
  • Definir o Timestamp para o momento atual
  • Verificar que não há ordens em andamento no ETHUSDT
  • Executar o trade
  • Remover a entrada do YAML

Passo 4: Verifique os logs para confirmar a execução

✅ Trade executado com sucesso para ETHUSDT
💾 Configuração de trades manuais atualizada e salva (trades executados removidos)

Dicas Profissionais

💡 Para mercados voláteis: Use thresholds mais altos (10–20%) para capturar entradas melhores

💡 Para oportunidades imediatas: Use ExecuteThresholdPerfect: 0 e Amount: 0 para entradas rápidas com tamanho padrão

💡 Para scaling in: Adicione várias entradas com thresholds crescentes para o mesmo símbolo

💡 Para gerenciamento de risco: Use valores específicos em vez de 0 para controlar exatamente o tamanho das posições

💡 Para múltiplos símbolos: Agrupe estratégias semelhantes no YAML para facilitar o gerenciamento

Lembre-se: Esse sistema foi feito para complementar sua análise manual, não para substituí-la. Use com inteligência para capturar oportunidades que o bot pode perder durante seus ciclos normais de geração de sinais! 🚀

📎 Related Topics