Developer Documentation

Alpha Drops API

Integrate the world's most comprehensive airdrop data directly into your applications, bots, and trading tools.

Secure Access

Standard Bearer Token authentication via SHA-256 hashed keys.

Real-time Data

Instant access to the latest airdrops as they are discovered by our team.

Multi-Chain

Data covering EVM, Solana, Starknet, Cosmos, and many more ecosystems.

Authentication

All API requests must include your API key in the Authorization HTTP header as a Bearer token.

HTTP Header

Authorization: Bearer YOUR_API_KEY

You can generate and manage your API keys in your Profile Settings. API access requires an active Developer API subscription.

Endpoints

GET/api/v1/airdrops

Retrieve a list of all active and potential airdrops.

Query Parameters

statusstring

Filter by status (active, ended, potential)

categorystring

Filter by category name

limitnumber

Limit the number of results (max 1000, default 100)

pagenumber

The page number for pagination (default 1)

Example Usage

curl -X GET "https://alphadrops.net/api/v1/airdrops?status=active&limit=10" \
  -H "Authorization: Bearer YOUR_API_KEY"

Response Format

All responses are returned in JSON format. Successful requests will include a success: true flag.

{
  "success": true,
  "meta": {
    "count": 1,
    "limit": 100,
    "filters": { "status": "active" }
  },
  "data": [
    {
      "id": "e1e1e1e1...",
      "name": "Project Name",
      "slug": "project-slug",
      "status": "active",
      "farming_level": "Aggressive",
      "categories": ["DeFi", "L2"],
      "blockchains": ["Ethereum", "Arbitrum"],
      "created_at": "2024-03-28T12:00:00Z"
    }
  ]
}

Error Handling

The Alpha Drops API uses standard HTTP response codes to indicate the success or failure of an API request.

401

Unauthorized

Missing or invalid API key.

403

Forbidden

No active subscription or subscription expired beyond grace period.

429

Too Many Requests

Daily or minute-based rate limit exceeded.

500

Internal Server Error

Something went wrong on our end.

Subscription Grace Period

We offer a 3-day grace period for all API subscriptions. If your subscription fails to renew, your API access will remain active for 72 hours to allow you time to resolve any billing issues.

Rate Limits

Rate limits vary based on your subscription plan. Exceeding your rate limit will return a 429 Too Many Requests response.

Starter

Monthly5,000/month

Rate10/min

Pro

Monthly25,000/month

Rate30/min

Enterprise

Monthly1,000,000/month

Rate100/min

Ready to Get Started?

Choose a plan that fits your needs and start integrating Alpha Drops data into your applications today.