Crypto Sentinel

AI-powered crypto news monitor that watches for risk signals about your chosen exchanges and coins. Runs on GitHub Actions 4x/day, analyses headlines via Gemini, and emails you only when meaningful risk is detected.

Documentation

Why

"Not your keys, not your coins" — but sometimes you have assets on exchanges anyway. Instead of reading crypto news every day hoping to catch early warning signs, this tool does it for you. There are plenty of open-source price alert projects, but none that use AI to analyse news sentiment and risk — insolvency rumours, hacks, regulatory actions — and alert you a few times a day so you can act fast to protect your assets.

Email Alert Preview

Quick Start

The easiest way to use Crypto Sentinel is to fork this repo and configure it with your own secrets and variables — no code changes needed.

1. Fork this repo on GitHub

2. Get your API keys (both free tier):

   Key	Where	Cost
   GEMINI_API_KEY	aistudio.google.com	Free (1500 req/day)
   RESEND_API_KEY	resend.com	Free (3000 emails/month)

3. Add config — go to your fork's Settings → Secrets and variables → Actions:

   • Secrets tab: GEMINI_API_KEY, RESEND_API_KEY
   • Variables tab: RECIPIENT_EMAIL (your email), WATCH_KEYWORDS (e.g. binance,bybit,youhodler)

4. Enable Actions — go to the Actions tab in your fork and enable workflows

5. Done — the monitor runs automatically 4x/day. Go to Actions → Crypto Sentinel → Run workflow to trigger immediately.

Optional: Telegram alerts

Add these as Secrets to also receive Telegram notifications:

• TELEGRAM_BOT_TOKEN — from @BotFather
• TELEGRAM_CHAT_ID — from @userinfobot

Local development

git clone <your-fork-url> crypto-sentinel
cd crypto-sentinel
npm install
cp .env.example .env   # fill in your keys
npm run dev

Alert thresholds

Emails are sent for medium, high, and critical risk levels only.
low and none are logged but silent.

Level	Example triggers
🚨 critical	Insolvency, confirmed hack, withdrawal freeze
🔴 high	Security breach, regulatory enforcement
🟡 medium	Regulatory warning, leadership changes
🟢 low	Minor negative press, market coverage
⚪ none	Neutral / positive news

Manual trigger

Go to Actions → Crypto Sentinel → Run workflow in GitHub to trigger a run immediately.