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 complete published airdrop records in the same default order as Alpha Drops. Premium airdrops are redacted on the Starter plan.

Query Parameters

statusstring

Filter by status (upcoming, active, claimable, ended)

categorystring

Filter by category name

blockchainstring

Filter by supported blockchain

sortstring

Sort by website (default), added, updated, or name

orderstring

Sort direction for added, updated, or name: asc or desc

limitnumber

Limit the number of results (max 250, 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"

GET/api/v1/airdrops/{slug}

Retrieve one complete published airdrop record, including tasks, links, funding, project metadata, and claim details.

Query Parameters

slugstring

The Alpha Drops project slug, for example bulk or lighter

Example Usage

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

GET/api/v1/claimables

Airdrops with live token claims happening right now.

Query Parameters

limitnumber

Limit the number of results (max 250, 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"

GET/api/v1/past-airdrops

Historical (ended) airdrops — the dataset behind our eligibility checker. Requires the Pro or Enterprise plan.

Query Parameters

yearnumber

Filter by distribution year (e.g. 2025)

limitnumber

Limit the number of results (max 250, 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"

GET/api/v1/checker

Run a full multi-chain wallet airdrop scan (live + historical). Pro/Enterprise only; heavily rate-limited as each scan is expensive.

Query Parameters

walletstring

Wallet address to scan (EVM or Solana). Required.

networkstring

Force an address type: EVM, SOLANA, or SUI (default: auto-detect)

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": {
    "total": 84,
    "page": 1,
    "limit": 100,
    "filters": { "category": null, "blockchain": null, "status": "active" },
    "default_sort": ["pinned:desc", "display_order:asc"],
    "sorting": { "sort": "website", "order": ["pinned:desc", "display_order:asc"] }
  },
  "data": [
    {
      "id": "e1e1e1e1...",
      "name": "Project Name",
      "slug": "project-slug",
      "status": "active",
      "logo": "https://...",
      "og_image": "https://...",
      "short_description": "Short project description...",
      "description": "Full project description...",
      "funding_amount": "$8M",
      "website": "https://project.example",
      "social_links": {
        "twitter": "https://x.com/project",
        "discord": "https://discord.gg/project"
      },
      "is_claimable": false,
      "premium": false,
      "categories": ["DeFi", "L2"],
      "blockchains": ["Ethereum", "Arbitrum"],
      "tasks": [
        {
          "id": "task-id",
          "title": "Use the protocol",
          "description": "Complete an onchain interaction",
          "link": "https://app.project.example"
        }
      ],
      "suggested_tasks": [],
      "claim": {
        "is_claimable": false,
        "link": null,
        "start_date": null,
        "deadline": null,
        "estimated_value": null
      },
      "created_at": "2026-03-28T12:00:00Z",
      "updated_at": "2026-06-01T09:30:00Z"
    }
  ]
}

// Rate limit headers on every response:
// X-RateLimit-Limit-Minute, X-RateLimit-Limit-Month, X-RateLimit-Remaining-Month

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, expired beyond the 3-day grace period, or the endpoint requires a higher plan.

429

Too Many Requests

Monthly quota or per-minute rate limit exceeded. Check the X-RateLimit-* response headers.

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

Monthly20,000/month

Rate10/min

Pro

Monthly100,000/month

Rate30/min

Enterprise

Monthly400,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.