Bot Telegram para alertas de preço do ₿itcoin

Bot simples para alertas de preço de Bitcoin. Observa o preço e envia notificações quando um alerta configurado é disparado.

📄 English Version

🚀 Funcionalidades

• Monitora o preço do Bitcoin a cada 15 minutos via API CoinGecko.
• Envia alertas via bot no Telegram quando o preço atinge o valor configurado.
• Funciona 24/7 sem precisar de servidor local, usando GitHub Actions.

⚙️ Como copiar esse projeto para usar suas funcioalidades

1. Fork o repositório

Clique em Fork no GitHub para ter seu próprio repositório.

2. Configurar Secrets

Vá em Settings → Secrets and variables → Actions → New repository secret e adicione:

• TOKEN → token do bot do Telegram

  • Crie um bot no Telegram com o BotFather
  • Siga as instruções do BotFather e copie o token.

• CHAT_ID → ID do chat para receber alertas

  • Abra o Telegram e pesquise por @UserInfeBot
  • Inicie uma conversa com ele clicando em Start.
  • O bot vai te enviar uma mensagem mostrando seu User ID.
  • Esse User ID é o valor que você usa como CHAT_ID no workflow.

💡 Dica para grupos:

• Adicione o bot a um grupo para que várias pessoas recebam os alertas.
• O ID do grupo é um número negativo. Pode ser obtido pela URL do grupo ou via API getUpdates.

3. Aguardar

• O workflow roda automaticamente a cada 15 minutos.
• Alertas chegarão no Telegram quando o preço atingir ou ultrapassar o valor configurado.
• Também é possível rodar manualmente em Actions → BTC Alert → Run workflow.

⚠ Editando os alertas (alert.json)

O arquivo alert.json define os alertas de preço do BTC. Cada alerta possui:

Campo	Descrição
id	Identificador único do alerta
type	Tipo do alerta: "above" (acima), "below" (abaixo) ou outros tipos especiais
price	Preço que dispara o alerta
active	true para ativar, false para desativar
once	true para disparar apenas uma vez, false para alertas contínuos

Exemplo rápido

{
  "id": 1,
  "type": "above",
  "price": 116000,
  "active": true,
  "once": false
}

• Altere o price para definir o valor que deseja monitorar.
• Mude active para false se quiser desativar temporariamente o alerta.
• Use once: true se o alerta deve disparar apenas uma vez.

💡 Dica: Cada novo alerta precisa de um id único.

---