Boomerang AI
EN PT Testar a demo
Documentação

O que é o Boomerang AI

O Boomerang AI é um agente de trading autônomo. Em vez de você ficar olhando gráficos o dia todo, ele faz isso por você: observa o mercado, decide com inteligência artificial e executa as operações sozinho na BNB Chain (a rede da Binance), seguindo regras que você define.

O nome "boomerang" vem da ideia central: o capital é lançado numa operação e sempre volta para a sua carteira, com o resultado da operação. Você está sempre no controle e o dinheiro nunca sai do seu alcance.

💡

Em uma frase: ele transforma picos de atenção do mercado em operações disciplinadas, automaticamente, 24 horas por dia.

Conceito

Como funciona

Quando uma moeda "viraliza", as pessoas correm primeiro para sites como a CoinMarketCap para pesquisar. Esse interesse aparece ali antes do dinheiro chegar de fato à blockchain. Existe uma pequena janela de oportunidade nesse intervalo, e é nela que o agente atua.

Toda decisão passa por três verificações em sequência (chamamos de "os três escudos"). Se qualquer uma reprovar, a operação não acontece.

1. O escudo analítico (os olhos)

O agente lê os sinais de atenção e de força (momentum) na CoinMarketCap. Uma inteligência artificial avalia esses números e só aprova uma compra se a confiança passar de um limite que você ajusta. Nunca por impulso.

2. O escudo on-chain (a checagem de realidade)

Antes de gastar qualquer valor, o agente simula a operação na própria blockchain: confere se existe liquidez de verdade para comprar e, principalmente, para vender depois. Ele rejeita moedas com taxas escondidas ou preços fora do normal. A regra de ouro: se não dá para sair limpo, não entra.

3. O escudo de execução (as mãos e o cofre)

Aprovado, o agente assina e envia a transação usando o Trust Wallet Agent Kit. A assinatura é feita pelo próprio agente, com a chave que move o dinheiro guardada cifrada no ambiente do agente. Ela nunca aparece no navegador, no site nem no código. Isso se chama autocustódia.

🪃

Resumo do ciclo: sinal, checagem, operação, e o capital volta para você. Como um boomerang.

Confiança

Segurança e privacidade

O dinheiro é seu, as regras são suas, e a chave é sua. Esses são os princípios:

  • Autocustódia. A carteira é do próprio agente (não fica numa corretora). A chave privada (a "senha mestra" que move os fundos) fica guardada cifrada e nunca aparece no navegador, no site ou no código.
  • Isolamento. A parte que "pensa" (lê o mercado) não tem acesso à chave; a parte que "guarda" o dinheiro não fica exposta à internet.
  • Proteção contra manipulação. A inteligência artificial só recebe números organizados, nunca texto solto que alguém poderia usar para enganá-la.
  • Trava de dono. Só você comanda o agente, confirmado pela assinatura da sua carteira.
  • Saque travado. O resgate dos fundos só vai para a sua carteira pessoal, nunca para um endereço desconhecido.

E quando virar produto, com vários usuários?

Hoje isto é um protótipo com uma única carteira (a de demonstração). Em um produto real com muitos usuários e valores maiores, a arquitetura prevista é não-custodial: cada usuário mantém a posse do próprio dinheiro, o agente recebe apenas permissão para operar (nunca para sacar para fora), e cada pessoa vê somente a própria carteira, protegida por login com a carteira. Nunca existirá um modelo em que o operador guarda a chave de todos.

⚠️

O endereço de uma carteira é público por natureza (qualquer um vê na blockchain) e não representa risco. O que jamais pode vazar é a chave privada / frase de recuperação. Guarde-a offline e nunca a digite em sites.

Mão na massa

Instalação

O passo a passo abaixo leva você do zero até o agente pronto para rodar. Não precisa ser programador: é só seguir na ordem.

1

Instale os pré-requisitos. Baixe de cada site oficial e instale com as opções padrão:

  • Python 3.12 ou mais nova, em python.org/downloads. É o motor do agente. No Windows, marque a caixinha "Add Python to PATH" durante a instalação (é fácil de esquecer e dá dor de cabeça depois).
  • Node.js versão LTS, em nodejs.org. Necessário para o Trust Wallet.
  • Git, em git-scm.com. Serve para baixar o projeto (ou baixe o ZIP, no passo 2).

Depois de instalar, abra um terminal novo (no Windows chama "PowerShell"; no Mac, "Terminal") e confira que tudo respondeu:

python --version node --version
💡

Abra sempre um terminal novo depois de instalar algo. Senão ele pode não "enxergar" o programa recém-instalado.

2

Baixe o projeto e entre na pasta:

git clone https://github.com/deegalabs/boomerang-ai cd boomerang-ai

Não tem Git? Na página do projeto no GitHub, clique em Code e depois Download ZIP, extraia, e abra a pasta no terminal.

3

Instale as dependências em um ambiente isolado (assim nada bagunça o resto do seu computador):

python -m venv .venv # Windows: .venv\Scripts\activate # macOS / Linux: source .venv/bin/activate pip install -r requirements.txt
4

Pegue as chaves de acesso. O agente conversa com quatro serviços. Crie uma conta em cada um e guarde as chaves (são gratuitas para começar):

  • Telegram. Fale com o @BotFather, use /newbot e guarde o token do bot. Pegue também o seu ID com o @userinfobot (é a trava que deixa só você comandar).
  • Claude (Anthropic). Em console.anthropic.com, crie uma chave de API. É o "cérebro" do agente.
  • CoinMarketCap. Em coinmarketcap.com/api, pegue sua chave de API. São os "olhos".
  • Trust Wallet (TWAK). Em portal.trustwallet.com, crie um app e copie o Access ID e o HMAC Secret (o secret aparece uma única vez). São as "mãos".
🔒

Nunca compartilhe essas chaves nem as coloque em prints. Elas ficam no seu arquivo .env (explicado adiante), que nunca é versionado (não vai pro Git nem pro site). Ao hospedar o agente, você as configura como variáveis de ambiente protegidas no provedor.

5

Instale a ferramenta do Trust Wallet (TWAK). Com o Node.js já instalado, instale a CLI do TWAK seguindo as instruções do portal.trustwallet.com. Para confirmar que deu certo, rode:

twak --version

Se aparecer um número de versão, está pronto para criar a carteira.

O coração

A carteira do agente

O agente precisa de uma carteira própria na BNB Chain, com um pouco de dinheiro para operar. Você cria essa carteira em segundos e mantém o controle total dela.

1

Crie a carteira (escolha uma senha forte e guarde-a):

twak wallet create --password "SUA_SENHA_FORTE"

Use exatamente a mesma senha em todos os comandos a seguir e no arquivo .env. Se elas não baterem, o agente não consegue abrir a carteira.

📝

Anote a frase de recuperação (seed) que aparecer e guarde-a offline, em local seguro. Com ela você sempre recupera o acesso, mesmo que perca o computador. Nunca a digite em sites.

2

Veja o endereço da carteira do agente na BNB Chain:

twak wallet address --chain bsc
3

Coloque um pouco de dinheiro. Do seu app pessoal da Trust Wallet (ou qualquer carteira), envie para o endereço acima, pela rede BNB Smart Chain (BEP-20):

  • Uma banca pequena de teste em USDC (sugestão: 10 a 20 dólares para começar).
  • Um pouquinho de BNB para pagar as taxas de rede (uns 2 dólares já bastam; cada operação custa centavos).
⚠️

Confira duas vezes duas coisas antes de enviar: que a rede é BNB Smart Chain (BEP-20) e que o endereço está correto. Enviar pela rede errada ou para o endereço errado pode fazer você perder o dinheiro, sem volta. Por isso comece com pouco.

4

Confira o saldo para ter certeza de que chegou:

twak wallet portfolio --chains bsc --password "SUA_SENHA_FORTE"
✅

Pronto. Você mantém o controle total: importando a frase de recuperação no app da Trust Wallet, pode sacar manualmente a qualquer momento.

Quase lá

Configurar e operar

1

Monte o arquivo de configuração. Copie o modelo e preencha com as suas chaves:

# Windows: copy .env.example .env # macOS / Linux: cp .env.example .env

Abra o .env com um editor de texto simples (o Bloco de Notas no Windows já serve) e preencha cada linha no formato NOME=valor: a senha da carteira, as chaves do Telegram, Claude, CoinMarketCap e Trust Wallet, e o endereço da sua carteira pessoal (para onde os saques voltam). Cole cada valor logo depois do =, sem espaços nem aspas.

2

Ligue o agente:

python run_agent.py

Ele inicia, conecta ao Telegram e fica pronto. (Para apenas testar sem dinheiro real, use python run_agent.py --paper, que simula as operações.) Para operar 24/7 sem deixar seu computador ligado, o agente roda hospedado na nuvem; a instância oficial roda na Railway, com a chave guardada cifrada no ambiente do agente.

3

Configure pelo Telegram. No seu bot, mande /start e use o assistente em três passos:

  • Moeda-foco. Em qual moeda (ou em todas as líquidas) o agente deve focar.
  • Stop-loss. Quanto você aceita perder por operação antes de vender (2%, 4% ou 5%).
  • Lucro-alvo. Quando realizar o ganho (+5%, +10%, +15% ou "deixar correr").

Confirme em Ativar e pronto: o agente começa a operar e te avisa a cada ação.

4

Deixe rodando 24/7 (na nuvem). Para o agente trabalhar sem deixar seu computador ligado, hospede-o na Railway (é onde a instância oficial roda). Em quatro passos:

  • Crie a conta na Railway, instale a CLI e entre: npm i -g @railway/cli e depois railway login.
  • Na pasta do projeto: railway init e crie um volume para o estado: railway volume add -m /app/state.
  • Envie seus segredos e a carteira (cifrada) para a Railway sem expor valores: python scripts/railway_setvars.py. Defina também SESSION_SECRET e OWNER_WALLET_ADDRESS.
  • Publique e pegue o link: railway up e railway domain.

Pronto: o bot e o site ficam no ar o tempo todo. O passo a passo completo (com o que cada comando faz) está no arquivo DEPLOY.md do projeto.

🔒

Ao hospedar, a chave (cifrada) e a senha ficam guardadas como variáveis protegidas no provedor, não no seu PC. É assim que qualquer bot 24/7 funciona; por isso comece com uma banca pequena. E não rode o agente do seu PC junto com o da nuvem: dois agentes na mesma carteira entram em conflito.

📊

A qualquer momento, mande /status para ver patrimônio, posições e PnL ao vivo, ou /dashboard para abrir o painel ao vivo. Em emergência, /panic liquida tudo e trava o agente.

Disciplina

Gestão de risco

O agente foi feito para proteger o capital. As travas funcionam em camadas, todas automáticas:

  • Stop-loss por operação. Corta uma perda pequena antes que cresça.
  • Trailing (acompanhamento). Quando o trade sobe, ele protege parte do ganho já conquistado.
  • Lucro-alvo. Realiza o ganho quando atinge a meta que você definiu.
  • Disjuntor global. Se o conjunto perder além de um limite, ele vende tudo e para, evitando um prejuízo grande.

A filosofia é simples: posições pequenas, perdas contidas, sobrevivência em primeiro lugar.

⚠️

Operar criptomoedas envolve risco. Nenhuma ferramenta garante lucro. Use apenas valores que você está disposto a arriscar. Isto não é recomendação financeira.

O futuro

Roadmap

  • Multiusuário não-custodial. Cada pessoa com a própria carteira e painel privado, mantendo a posse dos fundos.
  • Boomerang return automático. Ao bater a meta, devolver o capital para a carteira pessoal e pausar (modo "fez o objetivo, descansa").
  • Mais moedas e mais redes. Ampliar o universo conforme a liquidez permitir.
  • Painel público de prova. Acompanhamento em tempo real, verificável on-chain por qualquer pessoa.

Este projeto foi construído para o BNB Hack (Track 1), unindo CoinMarketCap, Trust Wallet e BNB Chain.