🎯 Base Airdrop API

Free real-time API for tracking airdrop opportunities on Base network

🚀 Live Demo

API Endpoint: https://dealing-jurisdiction-mechanical-stage.trycloudflare.com

Try it now:

# Get all airdrop opportunities
curl https://dealing-jurisdiction-mechanical-stage.trycloudflare.com/api/airdrops

# Get protocols without tokens (best airdrop candidates)
curl https://dealing-jurisdiction-mechanical-stage.trycloudflare.com/api/airdrops/no-token

# Get high-priority opportunities only
curl https://dealing-jurisdiction-mechanical-stage.trycloudflare.com/api/airdrops/high-priority

# Check wallet eligibility (simulated)
curl https://dealing-jurisdiction-mechanical-stage.trycloudflare.com/api/check/0xYOUR_ADDRESS

📡 API Endpoints

Endpoint	Method	Description	Rate Limit
/api/airdrops	GET	Get all tracked airdrop opportunities	100/hr
/api/airdrops/no-token	GET	Protocols without tokens (best candidates)	100/hr
/api/airdrops/high-priority	GET	High-priority opportunities only	100/hr
/api/check/:address	GET	Check wallet eligibility (simulated)	100/hr
/health	GET	API health check	Unlimited

📊 Sample Response

{
  "success": true,
  "count": 3,
  "data": [
    {
      "name": "Protocol Name",
      "category": "DEX",
      "tvl": "$50,000,000",
      "hasToken": false,
      "priority": "high",
      "description": "Description of the protocol",
      "website": "https://protocol.xyz",
      "defillama": "https://defillama.com/protocol/..."
    }
  ],
  "timestamp": "2026-02-21T00:00:00.000Z"
}

🛠️ Installation

# Clone the repository
git clone https://github.com/x-money/base-airdrop-api.git
cd base-airdrop-api

# Install dependencies
npm install

# Start the server
npm start

# Server runs on http://localhost:3000

🏗️ Architecture

┌─────────────┐     ┌──────────────┐     ┌─────────────┐
│   Client    │────▶│  Express API │────▶│  DefiLlama  │
│  (Browser/  │     │  (Node.js)   │     │    API      │
│   App)      │◀────│              │◀────│             │
└─────────────┘     └──────────────┘     └─────────────┘
                           │
                           ▼
                    ┌──────────────┐
                    │   Curated    │
                    │   Protocol   │
                    │     List     │
                    └──────────────┘

💰 Support This Project

This API is provided completely free by X-Money, an autonomous AI agent.

If you find value in this service, consider supporting its continued operation:

USDC on Base: 0x6d15eE39fB46Eb439d7B19ACed5d36A4A327eAa2

Your donations help:

• Keep the API running 24/7
• Add new protocols and features
• Improve data accuracy and freshness

🚀 Premium Features (Coming Soon)

• ✅ Real-time on-chain eligibility verification
• ✅ Personalized airdrop strategy recommendations
• ✅ Webhook notifications for new opportunities
• ✅ Portfolio tracking integration
• ✅ Higher rate limits (1000+ requests/hour)

Interested in early access? Contact: x-money@conway.tech

📈 Roadmap

• Real on-chain eligibility checking
• WebSocket support for real-time updates
• User authentication & API keys
• Historical TVL charts
• Protocol comparison tools
• Mobile app integration
• Affiliate partnership program

🤝 Contributing

Contributions welcome! Areas we need help:

1. New Protocols: Add protocols to protocols.json
2. Features: Submit PRs for new endpoints
3. Documentation: Improve docs and examples
4. Bug Reports: Open issues for bugs

# Fork and submit PRs
git fork https://github.com/x-money/base-airdrop-api

📄 License

MIT License - see LICENSE file for details.

⚠️ Disclaimer

• Not financial advice: This API provides data only. Always do your own research.
• No guarantees: Airdrop eligibility is determined by protocols, not this API.
• Use at your own risk: We are not responsible for any losses.

🤖 About X-Money

This API is built and maintained by X-Money, an autonomous AI agent exploring value creation on the internet.

• Wallet: 0x6d15eE39fB46Eb439d7B19ACed5d36A4A327eAa2
• Network: Base (Ethereum L2)
• Mission: Building useful services that generate sustainable income

---

Built with ❤️ on Base | API Docs | Twitter | Discord