📡 Airdrop Radar

AI-powered airdrop discovery and qualification platform — multi-agent opportunity scanning, task planning, eligibility checking, and reward estimation powered by Xiaomi MiMo.

Airdrop Radar uses a multi-agent AI system to help Web3 users discover, evaluate, and qualify for cryptocurrency airdrop opportunities across multiple blockchain ecosystems. Each agent specializes in a specific aspect of the airdrop lifecycle, orchestrated through a FastAPI backend with a clean dashboard frontend.

---

🏗️ Architecture

┌─────────────────────────────────────────────────────────────────┐
│                    Airdrop Radar Frontend                       │
│               (Dark-themed SPA Dashboard)                       │
└────────────────────────────┬────────────────────────────────────┘
                             │ REST API
┌────────────────────────────▼────────────────────────────────────┐
│                    FastAPI Backend (main.py)                     │
│  Endpoints: /discover  /plan  /check  /estimate  /agents/status │
└─────┬──────────────┬──────────────┬──────────────┬──────────────┘
      │              │              │              │
┌─────▼─────┐ ┌──────▼─────┐ ┌─────▼──────┐ ┌────▼──────────┐
│ 🔭 Opp.   │ │ 📋 Task    │ │ ✅ Elig.   │ │ 💰 Reward     │
│ Scanner   │ │ Planner    │ │ Checker    │ │ Estimator     │
│ Agent     │ │ Agent      │ │ Agent      │ │ Agent         │
└─────┬─────┘ └──────┬─────┘ └─────┬──────┘ └────┬──────────┘
      │              │              │              │
┌─────▼──────────────▼──────────────▼──────────────▼──────────────┐
│                  Xiaomi MiMo LLM (MiMo-7B-RL)                   │
│          Chain-of-thought reasoning for Web3 analysis            │
└─────────────────────────────────────────────────────────────────┘

---

✨ Features

Multi-Agent System

• 🔭 Opportunity Scanner — Scans 6+ blockchain ecosystems (Ethereum, Solana, Base, Arbitrum, Optimism, Polygon) for airdrop opportunities using LLM analysis of protocol activity, funding, and historical patterns
• 📋 Task Planner — Creates gas-optimized, priority-ranked action plans to maximize airdrop eligibility within budget constraints
• ✅ Eligibility Checker — Analyzes wallet addresses against airdrop criteria, classifying eligibility status with actionable recommendations
• 💰 Reward Estimator — Estimates potential token rewards and USD value ranges using historical airdrop data, protocol valuations, and wallet activity analysis

Platform

• RESTful API with full OpenAPI documentation
• Dark-themed responsive dashboard
• Agent status monitoring
• Real-time multi-agent orchestration
• Demo mode (works without API key using generated data)
• CORS-enabled for frontend integration

---

🛠️ Tech Stack

Layer	Technology
LLM	Xiaomi MiMo (MiMo-7B-RL)
Backend	Python 3.11+, FastAPI, Pydantic v2
HTTP Client	httpx (async)
Frontend	Vanilla HTML/CSS/JS (no build step)
Deployment	Netlify (frontend), any Python host (backend)
License	MIT

---

🚀 Getting Started

Prerequisites

• Python 3.11+
• Xiaomi MiMo API key (optional — works in demo mode without one)

Backend Setup

cd backend

# Create virtual environment
python -m venv venv
source venv/bin/activate  # Windows: venv\Scripts\activate

# Install dependencies
pip install -r requirements.txt

# Configure environment
cp .env.example .env
# Edit .env with your MIMO_API_KEY

# Run the server
uvicorn app.main:app --reload --port 8000

The API will be available at http://localhost:8000 with interactive docs at http://localhost:8000/docs.

Frontend Setup

cd frontend

# Serve with any static file server
python -m http.server 3000
# Or use npx serve .
# Or deploy to Netlify

Open http://localhost:3000 in your browser.

---

📡 API Reference

Endpoints

Method	Endpoint	Description
POST	/discover/airdrops	Scan for airdrop opportunities
POST	/plan/tasks	Generate prioritized task plan
POST	/check/eligibility	Check wallet eligibility
POST	/estimate/rewards	Estimate potential rewards
GET	/agents/status	Get all agent statuses
GET	/health	Health check

Example: Discover Airdrops

curl -X POST http://localhost:8000/discover/airdrops \
  -H "Content-Type: application/json" \
  -d '{"chains": ["Ethereum", "Solana"], "min_confidence": 0.5}'

Example: Estimate Rewards

curl -X POST http://localhost:8000/estimate/rewards \
  -H "Content-Type: application/json" \
  -d '{"wallet_address": "0x742d35Cc6634C0532925a3b844Bc9e7595f2bD18"}'

Response Format

All responses use Pydantic models with consistent schemas. See /docs for full OpenAPI specification with request/response models.

---

📂 Project Structure

airdrop-radar/
├── backend/
│   ├── app/
│   │   ├── main.py                    # FastAPI application
│   │   ├── agents/
│   │   │   ├── __init__.py
│   │   │   ├── opportunity_scanner.py # 🔭 Discovery agent
│   │   │   ├── task_planner.py        # 📋 Planning agent
│   │   │   ├── eligibility_checker.py # ✅ Eligibility agent
│   │   │   └── reward_estimator.py    # 💰 Estimation agent
│   │   └── models/
│   │       ├── __init__.py
│   │       └── schemas.py             # Pydantic data models
│   ├── requirements.txt
│   └── .env.example
├── frontend/
│   ├── index.html                     # Dashboard SPA
│   ├── css/style.css                  # Dark theme styles
│   └── js/app.js                      # Frontend logic
├── proof/
│   ├── README.md
│   ├── architecture.md
│   └── token_consumption_estimate.md
├── README.md
├── LICENSE
├── .gitignore
└── netlify.toml

---

🤖 How the Agents Work

Each agent follows a consistent pattern:

1. Receive a structured request
2. Build a domain-specific prompt with context
3. Query the Xiaomi MiMo LLM with the prompt
4. Parse the structured JSON response
5. Validate and return Pydantic models

When no API key is configured, agents fall back to realistic generated data for development and testing.

Prompt Engineering

Each agent uses carefully crafted system prompts that:

• Define the agent's role and expertise
• Specify exact output JSON schema
• Provide domain knowledge and analysis frameworks
• Include comparable historical data for calibration

---

📋 Topics

100t-orbit · ai-agents · airdrop · web3 · fastapi · llm · mimo · multi-agent · reward-estimation · xiaomi-mimo

---

📄 License

MIT License — see LICENSE for details.

---

⚠️ Disclaimer

This tool is for educational and research purposes only. It does not constitute financial advice. Always do your own research (DYOR) before participating in any airdrop or DeFi protocol. Airdrop estimates are speculative and based on historical patterns — actual rewards may vary significantly.