🦅 Smart Money Radar

Real-time Solana token intelligence — track what the best wallets buy before it trends.

Built for the Birdeye Data BIP Competition · Sprint 4 · May 2026 · #BirdeyeAPI

---

🧠 The Idea

Most people watch what's already trending. Smart money acts before it trends.

Smart Money Radar reverse-engineers which wallets on Solana consistently buy tokens early — before they blow up — then watches new token listings in real time for when those same wallets buy in again.

---

✨ Features

Feature	Description
📡 Live Radar	Scans trending Solana tokens every 3 minutes and scores each one 0–100
🏆 Leaderboard	Ranks smart money wallets by how many trending tokens they caught early
🧠 Smart Wallets	Card view of all tracked wallets with their full early-buy history
🔎 Token Search	Look up any Solana token by contract address — live price, volume, liquidity, and chart
👁️ Wallet Tracker	Enter any wallet address to see if it's in our smart money list
📈 Price Charts	One-click Birdeye chart popup for any scanned token
📱 Telegram Alerts	Get instant notifications on your phone when a smart money alpha signal is detected
⏱️ Live Countdown	Dashboard shows exact time until the next scan, synced to the backend
❓ How It Works	Built-in explanation of the scoring system for new users

---

🔬 How It Works

Step 1 → Pull top trending tokens on Solana via Birdeye /defi/token_trending
Step 2 → For each trending token, find the earliest buyers (first transactions)
Step 3 → Any wallet that bought early across 2+ trending tokens = "Smart Money"
Step 4 → Monitor trending tokens continuously for smart money wallet activity
Step 5 → Score each token 0–100 across 4 signals
Step 6 → Tokens scoring 60+ trigger an Alpha Signal + Telegram alert

---

🧮 Scoring System

Each token is scored out of 100 across 4 signals:

Signal	Max	What It Measures
🧠 Smart$	40 pts	Are known early-winner wallets buying this token?
🛡️ Safety	30 pts	Risk of rug pull — freeze authority, mint authority, whale concentration
⚡ Momentum	20 pts	Price change + 24h volume growth
👥 Holders	10 pts	How distributed are the token holders?

Score Bands:

• 🟢 60–100 — Alpha Signal. Smart money detected. High priority.
• 🟡 40–59 — Watch. Interesting but not confirmed.
• 🔴 0–39 — Low. No smart money interest.

---

📡 Birdeye API Endpoints Used

Endpoint	Purpose
/defi/token_trending	Find trending tokens + identify early buyers
/defi/txs/token	Get transaction history to detect smart money wallets
/defi/tokenlist	Monitor tokens being scanned
/defi/token_security	Safety and rug-pull risk scoring
/defi/token_overview	Price, volume, market cap, liquidity, holders

---

🚀 How to Run

1. Clone the repo

git clone https://github.com/devblackelon/smart-money-radar.git
cd smart-money-radar

2. Install dependencies

pip install requests flask

3. Add your API key

Copy config.example.py to config.py and add your key from bds.birdeye.so:

cp config.example.py config.py

Then open config.py and set your BIRDEYE_API_KEY.

4. (Optional) Set up Telegram alerts

Open telegram_bot.py and fill in your bot token and chat ID.

5. Run the radar (Terminal 1)

python radar.py

6. Run the dashboard (Terminal 2)

python dashboard.py

7. Open your browser

http://localhost:5000

---

📁 Project Structure

smart-money-radar/
│
├── config.py          → API key and settings
├── birdeye.py         → All Birdeye API calls
├── smart_money.py     → Wallet scoring and smart money detection engine
├── radar.py           → Main monitor — scans tokens and scores them
├── dashboard.py       → Flask web dashboard (6 tabs)
├── telegram_bot.py    → Telegram alert bot
└── requirements.txt   → Dependencies

---

🛠️ Tech Stack

• Python — core language
• Birdeye Data API — all onchain data (transactions, prices, security, trending)
• Flask — lightweight web server for the dashboard
• Telegram Bot API — real-time mobile alerts
• Solana — the chain being monitored

---

📸 Dashboard Tabs

1. Live Radar — all scanned tokens with scores, filter by Alpha/Watch/Low, chart button
2. Leaderboard — wallets ranked by early hit count with 🥇🥈🥉 medals
3. Smart Wallets — card view showing each wallet's early-buy history
4. Token Search — search any contract address for live stats
5. Wallet Tracker — check if any wallet is in the smart money list
6. How It Works — full scoring explanation for new users

---

Built by @johndoeofx · Powered by @birdeye_data · #BirdeyeAPI