Address Airdrops (full)

This endpoint returns all revealed airdrop details. If you want to use this data within your own app, note that since airdrop information is the core value of Drops, this is a paid endpoint.

Pricing ranges from $0.05–$0.20 per credit, depending on the package size. Minimum starter package is $500, which includes 2,500 address check credits.

Credit System:

• 1 credit = 1 unique address checked per month

• Repeated checks of the same address within the same month are free

• Usage resets at the start of each calendar month (midnight UTC)

• Unused credits roll over automatically to the next month

Contact Drops on X for details. Include your expected monthly request amount in the message.

There are also free API endpoints: Address Airdrops (simple) and Address Airdrops Value, which return the total airdrop value without the claiming details. For full claiming details, users should be redirected to Drops to view the information.

Endpoints

Get Address Airdrops with full details

GET /shared/v1/full/airdrops/:network/:address

Get the eligible airdrops for a specific address.

Headers

Header	Type	Required	Description
x-api-key	string	✅	Your API key for authentication

Path Parameters

Parameter	Type	Required	Description
network	string	✅	Network to query
address	string	✅	The wallet address to check (must be a valid address with the network param)

Example Requests

cURL - Ethereum Address

curl -X GET "https://api.drops.bot/shared/v1/full/airdrops/evm/0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045" \
  -H "x-api-key: YOUR_API_KEY"

The following networks are supported for address airdrop queries:

Network ID	Name
evm	All EVM and L2 chains
solana	Solana
move	Sui, Aptos, and all other Move Networks
cosmos	Cosmos and all subnets (address must start with `cosmos1`)
bitcoin	Bitcoin
starknet	Starknet

Response

200 - Successful Response

{
  "success": true,
  "data": {
    "eligibleAirdrops": FullAddressAirdropData[]
    "errors": EligibilityCheckErrors[]
  }
}

FullAddressAirdropData

Field	Type	Description
airdropId	string	Unique identifier of the airdrop
airdropName	string	Name of the airdrop
usdValue	number	Fiat equivalent value of the claim
imgUrl	string	URL of the airdrop image/logo
note	string | null	Extra notes if available (otherwise null)
tokenSymbol	string	Symbol of the airdropped token
claimFrom	string (ISO 8601)	Date/time when claiming opens (UTC)
claimUntil	string (ISO 8601)	Date/time when claiming closes (UTC)
directlySent	boolean	Whether the tokens are sent automatically without user claim
claimUrl	string	Official URL where eligible users can claim the airdrop
eligibleAmount	number	Amount of tokens the address is eligible to claim
isUnknownUsdValue	boolean	Whether the fiat value of the airdrop is known (false = value is known)
addressUrl	string	URL to the airdrop details page for the given address on Drops
isClaimStatusChecked	boolean	Indicates whether the claim status of the airdrop was successfully verified. If false, the claim status couldn’t be checked (for example, due to an unavailable contract or API).

EligibilityCheckErrors

When one or more airdrops eligibility check fails, they appear in the errors array. These are usually temporary issues and can be retried later.

Field	Type	Description
airdropId	string	Unique identifier of the airdrop that failed to load
address	string	Address for which the airdrop check failed
reason	string	Short message describing the error or failed check
airdropName	string	Human-readable name of the airdrop
airdropUrl	string	Link to the airdrop details page on Drops

Testing Addresses

The Full Airdrops API provides special testing addresses that return predictable mock data without consuming credits. These addresses are useful for integration testing, debugging, and development.

Available Testing Addresses

All testing addresses use the EVM network and start with the prefix 0xBADA55.

1. Two Eligible Airdrops (With Fiat Value)

Address: 0xBADA550000000000000000000000000000000001 Network: evm

Returns:

• 2 eligible airdrops

• Airdrop 1: 1,000 TEST1 tokens ($100 USD)

• Airdrop 2: 2,500 TEST2 tokens ($250 USD)

2. Two Eligible Airdrops (No Fiat Value)

Address: 0xBADA550000000000000000000000000000000002 Network: evm

Returns:

• 2 eligible airdrops

• Airdrop 3: 5,000 TEST3 tokens ($0 USD)

• Airdrop 4: 10,000 TEST4 tokens ($0 USD)

3. Failed Eligibility Check (One Error)

Address: 0xBADA550000000000000000000000000000000003 Network: evm

Returns:

• 0 eligible airdrops

• 1 error in the errors array

• Error reason: "Test error: Unable to verify eligibility"

Use case: Testing error handling and display.

4. No Airdrops Found

Address: 0xBADA550000000000000000000000000000000004 Network: evm

Returns:

• 0 eligible airdrops

• 0 errors

• Empty response

Use case: Testing addresses with no airdrop eligibility.

Example Request

curl -X GET \
  'https://www.drops.bot/api/shared/v1/full/ai
rdrops/evm/0xBADA55000000000000000000000000000
0000001' \
  -H 'x-api-key: YOUR_API_KEY'

Example Response

{
  "success": true,
  "data": {
    "eligibleAirdrops": [
      {
        "airdropId": "test-airdrop-1",
        "airdropName": "Test Airdrop 1",
        "usdValue": 100,
        "eligibleAmount": 1000,
        "tokenSymbol": "TEST1",
        "isUnknownUsdValue": false,
        "imgUrl": "https://www.drops.bot/images/airdrops/mystery-drop-600px.png",
        "claimFrom": "2025-01-01T00:00:00.000Z",
        "claimUntil": "2045-12-31T23:59:59.999Z",
        "claimUrl": "https://test1.example.com/claim",
        "directlySent": false,
        "note": "Test airdrop with fiat value",
        "isClaimStatusChecked": true,
        "addressUrl": "https://www.drops.bot/address/0xBADA550000000000000000000000000000000001/EVM"
      },
      {
        "airdropId": "test-airdrop-2",
        "airdropName": "Test Airdrop 2",
        "usdValue": 250,
        "eligibleAmount": 2500,
        "tokenSymbol": "TEST2",
        "isUnknownUsdValue": false,
        "imgUrl": "https://www.drops.bot/images/airdrops/mystery-drop-600px.png",
        "claimFrom": "2025-01-01T00:00:00.000Z",
        "claimUntil": "2045-12-31T23:59:59.999Z",
        "claimUrl": "https://test2.example.com/claim",
        "directlySent": false,
        "note": "Another test airdrop with fiat value",
        "isClaimStatusChecked": true,
        "addressUrl": "https://www.drops.bot/address/0xBADA550000000000000000000000000000000001/EVM"
      }
    ],
    "errors": []
  }
}