Bot de trading Telegram: criar e pilotar o seu robô

O Telegram não se limita à mensageria: a sua API permite transformar uma conversa em interface de controlo para um robô de trading. Receber alertas, enviar ordens, consultar o estado das suas posições — tudo a partir do telemóvel. Eis como montar uma arquitetura confiável e segura, sem cair nas armadilhas clássicas.

Porque é que o Telegram se impôs como consola de trading

Três características explicam a adoção massiva do Telegram pelos traders algorítmicos:

• API estável e gratuita. A Bot API e a API MTProto são documentadas, versionadas e disponibilizadas sem custo.
• Notificações instantâneas. Latência inferior a 500 ms entre o evento de mercado e a notificação recebida.
• Interface conversacional. Os comandos (/status, /close BTC, /pnl) são mais rápidos do que aceder a um dashboard web a partir do telemóvel.

Canal de alerta	Latência	Interatividade	Mobile-friendly
Telegram	< 1 s	Elevada (comandos, botões)	Excelente
Email	5 a 60 s	Baixa	Média
SMS	1 a 5 s	Nula	Boa
Discord	< 1 s	Elevada	Boa
Push de app nativa	< 1 s	Variável	Excelente

O Telegram combina velocidade e interatividade sem exigir desenvolvimento móvel específico.

Arquitetura de um bot de trading Telegram

Um bot bem concebido separa quatro camadas:

1. O bot Telegram: recebe os comandos do utilizador e expõe os alertas.
2. O motor de estratégia: analisa o mercado e gera os sinais.
3. O conector da exchange: executa as ordens (Binance, Bybit, Kraken via ccxt).
4. A base de dados: regista ordens, posições e desempenho.

Esta separação permite substituir o bot Telegram por outra interface (Discord, Slack) sem tocar no motor, e mudar de exchange sem reescrever a estratégia.

Criar o seu bot Telegram em 7 passos

1. Criar o bot com o BotFather

No Telegram, pesquise @BotFather. Execute /newbot, escolha um nome e um username. Obtenha o token (formato 123456789:ABCdefGHIjklMNOpqrSTUvwxYZ). Esse token equivale a uma palavra-passe — nunca o partilhe.

2. Proteger o acesso

Sem precauções, qualquer pessoa pode enviar um comando ao seu bot. Três proteções:

• Whitelist de ID Telegram. Codifique o seu ID de utilizador (obtenível via @userinfobot).
• Palavra-passe na ativação. Primeiro comando: /auth palavrapasse.
• Apenas webhook HTTPS se mudar para modo webhook em vez de polling.

3. Ligar à exchange via ccxt

import ccxt
exchange = ccxt.binance({
    'apiKey': os.environ['BINANCE_KEY'],
    'secret': os.environ['BINANCE_SECRET'],
    'options': {'defaultType': 'spot'}
})

Ative «trading», desative «withdrawals», coloque o IP do servidor na whitelist do lado da exchange.

4. Definir os comandos

Comando	Ação
/status	Mostra as posições abertas e o PnL não realizado
/balance	Saldo por ativo
/buy BTC 100	Compra de 100 USDT de BTC
/close BTC	Fecha a posição BTC
/pnl 7d	Desempenho nos últimos 7 dias
/strategy on/off	Ativa ou desativa a estratégia automática
/halt	Paragem de emergência: fecha tudo e desliga a estratégia

O comando /halt é essencial. Tem de poder cortar tudo em dois segundos a partir do telemóvel.

5. Implementar a estratégia automática

A estratégia corre em loop num thread separado. Usa os mesmos blocos de um bot Python clássico: obtenção de OHLCV, indicadores, sinais, execução. Quando um trade é aberto ou fechado, envia uma mensagem para o canal do Telegram.

6. Fazer backtest antes do live

Nenhum comando do Telegram substitui um backtest sério. Meça em 3 anos de dados: CAGR, drawdown máximo (alvo < 25 %), Sharpe (> 1), profit factor (> 1,5). Faça paper trading durante 14 a 30 dias antes do primeiro euro real.

7. Implementar em VPS

Um bot Telegram deve correr 24/7. Aloje num VPS modesto (2 vCPU, 4 GB de RAM, 5 a 15 €/mês). Encapsule o processo com systemd ou Docker para reiniciar automaticamente em caso de crash.

Proteger um bot Telegram: os pontos inegociáveis

Um bot Telegram está exposto a vários vetores de ataque. Siga esta checklist:

• Token do bot em variável de ambiente. Nunca no código, nunca num repositório Git.
• Chaves de exchange separadas. Um par de chaves dedicado a este bot, revogável de forma independente.
• Whitelist de ID. Recuse qualquer comando vindo de um ID não autorizado.
• Rate limiting. Limite a 10 comandos por minuto para evitar que um atacante faça spam na sua exchange.
• Logs auditáveis. Guarde cada comando recebido com timestamp, ID de utilizador e resultado.
• Alertas anómalos. Se um drawdown ultrapassar 5 % numa hora, envie um alerta e pare a estratégia.
• Sem levantamentos via API. Desative a permissão ao nível da exchange. Sempre.

Estratégias frequentes para bot Telegram

Estratégia	Vantagem	Risco
Seguir sinais de um canal	Sem lógica própria a codificar	Dependência do fornecedor, latência
Cruzamento EMA automático	Legível, robusto	Falsos sinais em mercado lateral
Alertas RSI extremo + ordem manual	Mantém o controlo	Exige a sua disponibilidade
Arbitragem entre exchanges	Baixo risco direcional	Comissões e latência consomem a margem
Grid trading	Desempenho constante em range	Drawdown pesado em tendência

As melhores configurações combinam alertas automáticos + execução manual confirmada, sobretudo no início da aprendizagem. Mantém o controlo final eliminando a fadiga de vigilância.

Hosting: onde fazer correr o bot

• VPS Hetzner / OVH / DigitalOcean. 5 a 15 €/mês. A escolha certa em 95 % dos casos.
• Raspberry Pi. Tentador, mas desaconselhado: falha de alimentação, queda da internet doméstica, sem SLA.
• Cloud gerida (Heroku, Railway). Simples, mas cara além do tier gratuito.
• Servidor on-premise. Reservado a setups profissionais, com redundância de ISP.

Escolha uma localização próxima da exchange: Tóquio para a Binance, Frankfurt para a Bitstamp, Estados Unidos para a Coinbase. Algumas dezenas de milissegundos poupam slippage em ordens de mercado.

Os erros que saem caros

• Token Telegram num repositório público. Detetado em minutos por bots maliciosos.
• Sem comando de paragem de emergência. Quando a sua estratégia descontrola, quer /halt em dois segundos.
• Logs demasiado verbosos com chaves API. Nunca registe segredos, mesmo parcialmente.
• Sem reconexão automática. O polling do Telegram corta-se por vezes. Implemente um retry exponencial.
• Estratégia testada apenas em bull. Faça forward test em dois regimes de mercado antes de aumentar o capital.

Quando preferir o Obside a um bot Telegram caseiro

Construir e manter um bot Telegram exige tempo: 40 a 80 horas para uma V1, depois 2 a 5 horas por semana em manutenção. Criar uma conta Obside gratuita permite-lhe escrever as suas estratégias em linguagem natural, receber alertas no Telegram, fazer backtest em segundos e ligar a sua corretora sem programar. Mantém o benefício da automatização sem pagar a dívida operacional de um projeto caseiro.

Conteúdo exclusivamente educativo. Não constitui aconselhamento de investimento. O trading envolve riscos, incluindo a possível perda de capital.